POST /api/mission-control/agents Bearer

Create Mission Control Agent

Register a new AI agent in PocketPaw's Mission Control with a name, role, specialties, backend configuration, and autonomy level. Agents can be assigned to tasks for autonomous execution.

Overview

Creates a new agent profile in Mission Control. Agents can be assigned to tasks and execute them autonomously.

Request Body

name string

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

role string

Job title (e.g., Backend Engineer).

description string

What this agent is responsible for.

specialties array

List of skill domains (e.g., ["backend", "database"]).

backend string

Agent backend to use.

level string

Autonomy level: intern, specialist, or lead.

curl -X POST http://localhost:8000/api/mission-control/agents \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "backend-dev",
    "role": "Backend Engineer",
    "description": "Handles API and database work",
    "specialties": ["backend", "database", "api"]
  }'

const res = await fetch('http://localhost:8000/api/mission-control/agents', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    name: 'backend-dev',
    role: 'Backend Engineer',
    specialties: ['backend', 'database', 'api'],
  }),
});

import httpx

res = httpx.post(
    "http://localhost:8000/api/mission-control/agents",
    headers={"Authorization": "Bearer YOUR_TOKEN"},
    json={
        "name": "backend-dev",
        "role": "Backend Engineer",
        "specialties": ["backend", "database", "api"],
    },
)

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

Was this page helpful?

Request

curl -X POST "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: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer <token>"
},
});

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

import requests

response = requests.post(
    "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("POST", "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