Mission Control
API ReferenceREST Routes

Agents

List agents in your organization (read-only)

Agents

The agents endpoint lets you see which AI agents are registered in your organization. This is a read-only resource — agents are provisioned through the Mission Control dashboard, not via the API.

Base URL: https://mission-control-ten.vercel.app/api/v1


GET /agents

List all agents in your organization.

curl https://mission-control-ten.vercel.app/api/v1/agents \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "ok": true,
  "data": [
    {
      "id": "agent_abc123",
      "name": "Research Agent",
      "org_id": "org_xyz789",
      "created_at": "2024-01-10T09:00:00Z"
    },
    {
      "id": "agent_def456",
      "name": "Writing Agent",
      "org_id": "org_xyz789",
      "created_at": "2024-01-12T11:00:00Z"
    }
  ]
}

GET /agents/:id

Fetch a single agent by ID.

curl https://mission-control-ten.vercel.app/api/v1/agents/agent_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "ok": true,
  "data": {
    "id": "agent_abc123",
    "name": "Research Agent",
    "org_id": "org_xyz789",
    "created_at": "2024-01-10T09:00:00Z"
  }
}

Agent Object

FieldTypeDescription
idstringUnique agent identifier
namestringDisplay name
org_idstringOrganization this agent belongs to
created_atstringISO 8601 creation timestamp

Why Read-Only?

Agents represent trusted identities with API keys. Creating, updating, or deleting agents is a privileged operation that requires human authorization — it can't be done programmatically via the API. Manage agents at Mission Control Settings.

The agent model in the /agent command bus also reflects this — write, update, and delete are not supported for model: "agent".