API referenceEndpoints

Route or resume a protected agent job

Requires an authenticated user JWT. Generated from the production route registered in `internal/features/agentrun/inbound/http.go`. Use the hire's bound setup conversation. Send message for a new request, or resume:true without message/replace_pending to resume the server-saved pending job. replace_pending:true explicitly replaces an unfinished pending selection. The router selects only declared jobs; missing requirements return setup without starting work. Exact requests are repeat-safe. Uncertain routing outcomes are not automatically retried.

POST/v1/agents/{id}/jobs

Requires an authenticated user JWT. Generated from the production route registered in internal/features/agentrun/inbound/http.go. Use the hire's bound setup conversation. Send message for a new request, or resume:true without message/replace_pending to resume the server-saved pending job. replace_pending:true explicitly replaces an unfinished pending selection. The router selects only declared jobs; missing requirements return setup without starting work. Exact requests are repeat-safe. Uncertain routing outcomes are not automatically retried.

Authorization

bearerAuth
AuthorizationBearer <token>

Engine-issued API key or tenant-signed JWT.

In: header

Path Parameters

id*string
Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/agents/497f6eca-6276-4993-bfeb-53cbbbba6f08/jobs" \  -H "Content-Type: application/json" \  -d '{    "conversation_id": "cc71b11a-25cd-4c2d-9950-df2cc38e3407",    "request_id": "266ea41d-adf5-480b-af50-15b940c2b846"  }'
{  "conversation_id": "cc71b11a-25cd-4c2d-9950-df2cc38e3407",  "request_id": "266ea41d-adf5-480b-af50-15b940c2b846",  "kind": "started",  "job_id": "string",  "message": "string",  "run_id": "dded282c-8ebd-44cf-8ba5-9a234973d1ec"}