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.
/v1/agents/{id}/jobsRequires 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 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
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"}Invoke tool connection
Requires an authenticated tenant principal. Generated from the production route registered in `internal/features/agents/inbound/http.go`.
Create run
Requires an authenticated tenant principal. Generated from the production route registered in `internal/features/agentrun/inbound/http.go`.