Agents
List an agent's specialist-transfer links
Returns a BARE JSON ARRAY (not a data envelope), ordered by
position — the try order a live transfer decision walks.
Authorization
bearerAuth AuthorizationBearer <token>
Long-lived ES256 JWT minted from the dashboard (https://app.sautikit.com/developers/api-keys). Signed by the
platform keyring. Carries workspace_id and scopes claims;
revoked via the platform deny-list.
In: header
Path Parameters
id*string
Format
uuidResponse Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/agents/497f6eca-6276-4993-bfeb-53cbbbba6f08/links"[ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "target_agent_id": "b0b31ccc-0df2-496f-b84c-b8d90f867dcc", "description": "string", "position": 0, "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z" }]{ "error": { "code": "validation.bad_request", "message": "string", "request_id": "string", "details": [ "string" ], "resolution": "string", "reason": "invalid_characters", "suggested_e164": "+254727524723" }}{ "error": { "code": "validation.bad_request", "message": "string", "request_id": "string", "details": [ "string" ], "resolution": "string", "reason": "invalid_characters", "suggested_e164": "+254727524723" }}Delete a draft tool DELETE
Requires a writer role.
Replace an agent's specialist-transfer links (full replacement) PUT
Full-replacement — see `AgentLinksInput`. Requires a writer role. Returns the saved set (server-assigned `id`/`position`/timestamps), re-read after the write rather than an echo of the request.