Create an agent

Creates an agent and waits until it is visible to immediate follow-up operations. If the agent is durably created but visibility confirmation is canceled or times out, the retryable 503/504 response includes a Retry-After header.

post/v0/city/{cityName}/agents

Request

  • The document declares no server URL.
  • Auth: none declared. Required headers: X-GC-Request

Path parameters

cityNamestring required

City name.

Headers

X-GC-Requeststring required

Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.

Idempotency-Keystring

Idempotency key for safe retries.

Request body

dirstring

Working directory (rig name).

namestring required

Agent name.

providerstring required

Provider name.

scopestring

Agent scope.

Example request

{
  "name": "deacon-1",
  "provider": "claude"
}

Response

Created

agentstring required

Created agent name.

statusstring required

Operation result.

Example response

{
  "status": "created"
}

Changes

No recorded changes to this operation across all 50 revisions of this API.