Agents (deprecated)

Agents have been renamed to Flows. These endpoints permanently redirect to their `/flows` equivalents and are removed on 31 December 2026 — see Flows for the current API.

Deprecated. Redirects to /flows; removed 31 December 2026.

Deprecated

List agents — use GET /flows/

get

Deprecated — send this request to GET /flows/ instead. This endpoint permanently redirects (308) to /flows/, keeping your query string, and is removed on 31 December 2026. Call /flows/ directly so your integration stops relying on a redirect. Authenticate as usual: a request without valid credentials answers 401 instead of redirecting.

Authorizations

X-Api-KeystringRequired

API key for authentication

Header parameters

X-Organization-Idstring · nullableOptional

Active organization ID for multi-org support

Responses

308

Permanent redirect to the /flows equivalent, query string preserved.

422

Validation error (validation_error)

application/json

get/agents/

GET /api/public/v1/agents/ HTTP/1.1
Host: api.pletor.ai
X-Api-Key: YOUR_API_KEY
Accept: */*

No content

Deprecated

Get an agent — use GET /flows/{flow_id}

get

Deprecated — send this request to GET /flows/{flow_id} instead. This endpoint permanently redirects (308) to /flows/{flow_id}, keeping your query string, and is removed on 31 December 2026. Call /flows/{flow_id} directly so your integration stops relying on a redirect. Authenticate as usual: a request without valid credentials answers 401 instead of redirecting.

Authorizations

X-Api-KeystringRequired

API key for authentication

Path parameters

agent_idstring · uuidRequired

Header parameters

X-Organization-Idstring · nullableOptional

Active organization ID for multi-org support

Responses

308

Permanent redirect to the /flows equivalent, query string preserved.

422

Validation error (validation_error)

application/json

get/agents/{agent_id}

GET /api/public/v1/agents/{agent_id} HTTP/1.1
Host: api.pletor.ai
X-Api-Key: YOUR_API_KEY
Accept: */*

No content