API referenceEndpoints

List agents

Requires an authenticated tenant principal. Generated from the production route registered in `internal/features/agents/inbound/http.go`.

GET/v1/agents

Requires an authenticated tenant principal. Generated from the production route registered in internal/features/agents/inbound/http.go.

Authorization

bearerAuth
AuthorizationBearer <token>

Engine-issued API key or tenant-signed JWT.

In: header

Query Parameters

include_hidden?boolean

Also list the agents the engine made for scheduled tasks (hidden: true). Off by default. Grants no visibility the caller does not already have; GET /v1/agents/{id} never needs it.

Defaultfalse

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/agents"
{}

List usage

Requires platform-administrator authority. Generated from the production route registered in `internal/features/chat/inbound/http.go`.

Create agent

Requires an authenticated tenant principal. Generated from the production route registered in `internal/features/agents/inbound/http.go`.