Spawn an agent team (role-assigned agents that collaborate on a task)

Requires the agent_teams:create permission.

Authorization

AuthorizationBearer <token>

An access token from this zone's POST /oauth/token, or a session token from POST /api/v1/auth/login. Send it as Authorization: Bearer <token>.

In: header

application/json

TypeScript Definitions

Use the request body type in TypeScript.

attachments?array<>

connector_id?string

Formatuuid

environment_id?string

Formatuuid

harness?string

idle_timeout_seconds?integer

Formatint32

instance_size?string

max_messages?integer

Formatint32

members?array<>

model?string

name?string

prompt*string

reasoning_effort?string

tags?

curl -X POST "https://example.com/api/v1/teams" \  -H "Content-Type: application/json" \  -d '{    "prompt": "string"  }'

{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "state": "string"}