GET /api/mission-control/agents Bearer

List Mission Control Agents

List all AI agents registered in PocketPaw's Mission Control system. Filter by status (idle, active, blocked, offline) and view each agent's name, role, specialties, and last heartbeat.

Overview

Returns all agents registered in Mission Control. Optionally filter by status.

Query Parameters

status string

Filter by agent status: idle, active, blocked, or offline.

limit integer

Maximum number of agents to return.

Response

agents array

List of agent profiles.

id string

Agent UUID.

name string

Agent name (e.g., backend-dev).

role string

Agent role (e.g., Backend Engineer).

status string

Current status.

specialties array

List of skill domains.

last_heartbeat string

ISO 8601 timestamp of last heartbeat.

curl http://localhost:8000/api/mission-control/agents \
  -H "Authorization: Bearer YOUR_TOKEN"

const res = await fetch('http://localhost:8000/api/mission-control/agents', {
  headers: { 'Authorization': 'Bearer YOUR_TOKEN' },
});
const data = await res.json();

import httpx

res = httpx.get(
    "http://localhost:8000/api/mission-control/agents",
    headers={"Authorization": "Bearer YOUR_TOKEN"},
)
data = res.json()

{
  "agents": [
    {
      "id": "agent-uuid-1",
      "name": "backend-dev",
      "role": "Backend Engineer",
      "status": "idle",
      "specialties": ["backend", "database", "api"],
      "backend": "claude_agent_sdk",
      "level": "specialist",
      "last_heartbeat": "2024-01-15T14:30:00Z"
    }
  ]
}

Was this page helpful?

Request

curl -X GET "http://localhost:8000/api/mission-control/agents" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <token>"

const response = await fetch("http://localhost:8000/api/mission-control/agents", {
  method: "GET",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer <token>"
},
});

const data = await response.json();
console.log(data);

import requests

response = requests.get(
    "http://localhost:8000/api/mission-control/agents",
    headers={'Content-Type':'application/json','Authorization':'Bearer <token>'},
)

print(response.json())

package main

import (
    "fmt"
    "net/http"
    "io"
)

func main() {
    req, _ := http.NewRequest("GET", "http://localhost:8000/api/mission-control/agents", nil)
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("Authorization", "Bearer <token>")

    client := &http.Client{}
    resp, _ := client.Do(req)
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

Response
Send a request to see the response