API referenceEndpoints

Turn an external hire off

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.

POST/v1/agents/{id}/disable

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.

Authorization

bearerAuth
AuthorizationBearer <token>

Engine-issued API key or tenant-signed JWT.

In: header

Path Parameters

id*string
Formatuuid

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/disable"
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "status": "active",  "executor_mode": "external"}