Create run
Requires an authenticated tenant principal. Generated from the production route registered in `internal/features/agentrun/inbound/http.go`.
/v1/agents/{id}/runsRequires an authenticated tenant principal. Generated from the production route registered in internal/features/agentrun/inbound/http.go.
Authorization
bearerAuth Engine-issued API key or tenant-signed JWT.
In: header
Path Parameters
uuidRequest 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
curl -X POST "https://example.com/v1/agents/497f6eca-6276-4993-bfeb-53cbbbba6f08/runs" \ -H "Content-Type: application/json" \ -d '{}'{}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.
Read agent setup and live job readiness
Requires an authenticated user JWT. Generated from the production route registered in `internal/features/agents/inbound/setup.go`. Owner-only. Each job checks shared and job-specific answers, current tool grants/policy/availability and knowledge access. Failed checks remain unavailable. The role document is returned for trusted application adapters; clients can expose only the visible questions, choices and job summaries.