API Overview

Integrate third-party services with AgentsMesh using organization-level API Keys. Automate pod management, ticket tracking, and more through the REST API.

Overview

AgentsMesh provides organization-level API Keys for third-party integrations, CI/CD pipelines, and automation workflows. With API Keys you can:

  • Manage AgentPods programmatically (create, list, terminate)
  • Automate ticket creation and status updates
  • Query channels and send messages
  • Monitor runners and repository status

Getting an API Key

API Keys are created by organization Owners or Admins from the web interface.

  1. Navigate to Settings → Organization → API Keys
  2. Click Create API Key
  3. Enter a name, optional expiration date, and select the scopes you need
  4. Copy the generated key (starts with amk_)

Important: The API Key is only displayed once at creation time. Store it securely — you cannot retrieve it later.

Base URL & Path

All external API endpoints follow this pattern:

{BASE_URL}/api/v1/ext/orgs/{slug}/...

Replace {slug} with your organization's slug (found in Settings → Organization).