API referenceAgents and workflowsAgent sessions

Submit the CLI OAuth code shown after opening the session's auth link

Requires the agent_sessions:invoke 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

id*string

application/json

TypeScript Definitions

Use the request body type in TypeScript.

code*string

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

Empty

Destroy an agent session (tears down the sandbox and deletes the conversation) DELETE

End a background shell the agent started (a Bash run in the background), by its command; the turn keeps running POST