Invoke tool connection
Requires an authenticated tenant principal. Generated from the production route registered in `internal/features/agents/inbound/http.go`.
/v1/agents/{id}/invokeRequires an authenticated tenant principal. Generated from the production route registered in internal/features/agents/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/invoke" \ -H "Content-Type: application/json" \ -d '{}'{}Turn an external hire on
Requires an authenticated user JWT. Generated from the production route registered in `internal/features/agents/inbound/http.go`. Only the personal owner can change an external hire's availability; another owner, another organization or a missing hire is 404. Internal agents and external installs still awaiting setup are refused with 409. Disable pauses the managed schedule and cancels unfinished work with its authority in one audited transaction. Enable resumes future mornings under current membership without another activation run. Repeated calls converge; no model credits are needed.
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.