API referenceEndpoints

Update agent

Requires an authenticated tenant principal. Generated from the production route registered in `internal/features/agents/inbound/http.go`. To finish setup for an external Blinq with status=setup_required, send its name and at least one valid tool_connections selection together. Success saves the choices, activates the install and creates its first run and managed schedule atomically. Failed setup leaves the install pending. Once configured, the owner may replace selections or use an empty object to remove all tool access. Ordinary external edits ignore status. Use the dedicated enable/disable operations after setup. Internal-agent status editing is unchanged.

PATCH/v1/agents/{id}

Requires an authenticated tenant principal. Generated from the production route registered in internal/features/agents/inbound/http.go. To finish setup for an external Blinq with status=setup_required, send its name and at least one valid tool_connections selection together. Success saves the choices, activates the install and creates its first run and managed schedule atomically. Failed setup leaves the install pending. Once configured, the owner may replace selections or use an empty object to remove all tool access. Ordinary external edits ignore status. Use the dedicated enable/disable operations after setup. Internal-agent status editing is unchanged.

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

curl -X PATCH "https://example.com/v1/agents/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{}'
{  "executor_mode": "internal",  "status": "active"}