Agent SwarmAgent Swarm

Agents

CRUD operations for agent profiles — create, configure, update, and manage swarm agents

GET
/api/agents

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Query Parameters

include?string
Value in"tasks"
fields?string
Value in"full" | "slim"

Response Body

curl -X GET "http://localhost:3013/api/agents"
Empty
POST
/api/agents

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

curl -X POST "http://localhost:3013/api/agents" \  -H "Content-Type: application/json" \  -d '{    "name": "string"  }'
Empty
Empty
Empty
GET
/api/agents/{id}

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

id*string

Query Parameters

include?string
Value in"tasks"

Response Body

curl -X GET "http://localhost:3013/api/agents/string"
Empty
Empty
PUT
/api/agents/{id}/activity

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

id*string

Response Body

curl -X PUT "http://localhost:3013/api/agents/string/activity"
Empty
GET
/api/agents/{id}/credential-status

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

id*string

Response Body

curl -X GET "http://localhost:3013/api/agents/string/credential-status"
Empty
Empty
PUT
/api/agents/{id}/credential-status

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

curl -X PUT "http://localhost:3013/api/agents/string/credential-status" \  -H "Content-Type: application/json" \  -d '{}'
Empty
Empty
PATCH
/api/agents/{id}/harness-provider

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

curl -X PATCH "http://localhost:3013/api/agents/string/harness-provider" \  -H "Content-Type: application/json" \  -d '{    "harness_provider": "claude"  }'
Empty
Empty
Empty
PUT
/api/agents/{id}/name

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

curl -X PUT "http://localhost:3013/api/agents/string/name" \  -H "Content-Type: application/json" \  -d '{    "name": "string"  }'
Empty
Empty
Empty
PUT
/api/agents/{id}/profile

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

curl -X PUT "http://localhost:3013/api/agents/string/profile" \  -H "Content-Type: application/json" \  -d '{}'
Empty
Empty
Empty
PATCH
/api/agents/{id}/runtime

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

curl -X PATCH "http://localhost:3013/api/agents/string/runtime" \  -H "Content-Type: application/json" \  -d '{    "harness_provider": "claude",    "model": "string"  }'
Empty
Empty
Empty
GET
/api/agents/{id}/setup-script

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

id*string

Response Body

curl -X GET "http://localhost:3013/api/agents/string/setup-script"
Empty
Empty
GET
/api/agents/credential-status

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Query Parameters

status?string
Value in"idle" | "busy" | "offline" | "waiting_for_credentials"

Response Body

curl -X GET "http://localhost:3013/api/agents/credential-status"
Empty