> For the complete documentation index, see [llms.txt](https://docs.pletor.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pletor.ai/documentation/api-reference/flows/agents-deprecated.md).

# 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.

## List agents — use GET /flows/

> \*\*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.

```json
{"openapi":"3.1.0","info":{"title":"Pletor - Public API","version":"2.0.0"},"tags":[{"name":"agents","description":"Deprecated. Redirects to /flows; removed 31 December 2026."}],"servers":[{"url":"/api/public"}],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-Api-Key","description":"API key for authentication"},"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Cognito JWT Bearer token"}},"schemas":{"ApiErrorResponse":{"description":"Standard error response envelope. All API errors follow this format.","properties":{"error":{"$ref":"#/components/schemas/ApiErrorDetail","description":"Error details"}},"required":["error"],"title":"ApiErrorResponse","type":"object"},"ApiErrorDetail":{"description":"Structured details for an API error.","properties":{"code":{"$ref":"#/components/schemas/ApiErrorCode","description":"Machine-readable error code; branch on this, not on `message`"},"message":{"description":"Human-readable error description","title":"Message","type":"string"},"status":{"description":"HTTP status code of this response","title":"Status","type":"integer"},"details":{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"items":{"type":"string"},"type":"array"},{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}]},"description":"Additional context. Always holds `request_id` (the response's `X-Request-Id`); `validation_error` from request validation adds `errors`, a list of `location: message` strings, and `rate_limit_exceeded` adds `retry_after`, the seconds to wait.","title":"Details","type":"object"}},"required":["code","message","status","details"],"title":"ApiErrorDetail","type":"object"},"ApiErrorCode":{"description":"Machine-readable error code, with its usual HTTP status: `invalid_input`\n400, `authentication_required` 401, `forbidden` 403, `not_found` 404,\n`conflict` 409, `validation_error` 422, `rate_limit_exceeded` 429,\n`internal_error` 500, `run_failed` 502, `service_unavailable` 503, `timeout`\n504. A 4xx status without a code of its own is sent as `invalid_input`.\n\n`plan_required`, `credit_usage_exceeded`, `user_quota_exceeded`,\n`spend_limit_exceeded`, `brain_flow_impact`, `stale_definition`,\n`flow_not_shared` and `asset_not_ready` have no status of their own and are\nsent only in the `X-Pletor-Error-Code` response header, never as `code`.","enum":["invalid_input","authentication_required","forbidden","not_found","conflict","validation_error","rate_limit_exceeded","internal_error","run_failed","service_unavailable","timeout","plan_required","credit_usage_exceeded","user_quota_exceeded","spend_limit_exceeded","brain_flow_impact","stale_definition","flow_not_shared","asset_not_ready"],"title":"ApiErrorCode","type":"string"}}},"paths":{"/v1/agents/":{"get":{"tags":["agents"],"summary":"List agents — use GET /flows/","description":"**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.","operationId":"v1_list_agents_agents__get","deprecated":true,"parameters":[{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Active organization ID for multi-org support","title":"X-Organization-Id"},"description":"Active organization ID for multi-org support"}],"responses":{"308":{"description":"Permanent redirect to the `/flows` equivalent, query string preserved.","headers":{"Location":{"description":"The `/flows` URL to send this request to.","schema":{"type":"string"}},"Deprecation":{"description":"Always `true` on this endpoint.","schema":{"type":"string"}},"Sunset":{"description":"The date this endpoint is removed.","schema":{"type":"string"}},"Link":{"description":"The successor resource, as `rel=\"successor-version\"`.","schema":{"type":"string"}}}},"422":{"description":"Validation error (`validation_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}}}}}}
```

## Get an agent — use GET /flows/{flow\_id}

> \*\*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.

```json
{"openapi":"3.1.0","info":{"title":"Pletor - Public API","version":"2.0.0"},"tags":[{"name":"agents","description":"Deprecated. Redirects to /flows; removed 31 December 2026."}],"servers":[{"url":"/api/public"}],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-Api-Key","description":"API key for authentication"},"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Cognito JWT Bearer token"}},"schemas":{"ApiErrorResponse":{"description":"Standard error response envelope. All API errors follow this format.","properties":{"error":{"$ref":"#/components/schemas/ApiErrorDetail","description":"Error details"}},"required":["error"],"title":"ApiErrorResponse","type":"object"},"ApiErrorDetail":{"description":"Structured details for an API error.","properties":{"code":{"$ref":"#/components/schemas/ApiErrorCode","description":"Machine-readable error code; branch on this, not on `message`"},"message":{"description":"Human-readable error description","title":"Message","type":"string"},"status":{"description":"HTTP status code of this response","title":"Status","type":"integer"},"details":{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"items":{"type":"string"},"type":"array"},{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}]},"description":"Additional context. Always holds `request_id` (the response's `X-Request-Id`); `validation_error` from request validation adds `errors`, a list of `location: message` strings, and `rate_limit_exceeded` adds `retry_after`, the seconds to wait.","title":"Details","type":"object"}},"required":["code","message","status","details"],"title":"ApiErrorDetail","type":"object"},"ApiErrorCode":{"description":"Machine-readable error code, with its usual HTTP status: `invalid_input`\n400, `authentication_required` 401, `forbidden` 403, `not_found` 404,\n`conflict` 409, `validation_error` 422, `rate_limit_exceeded` 429,\n`internal_error` 500, `run_failed` 502, `service_unavailable` 503, `timeout`\n504. A 4xx status without a code of its own is sent as `invalid_input`.\n\n`plan_required`, `credit_usage_exceeded`, `user_quota_exceeded`,\n`spend_limit_exceeded`, `brain_flow_impact`, `stale_definition`,\n`flow_not_shared` and `asset_not_ready` have no status of their own and are\nsent only in the `X-Pletor-Error-Code` response header, never as `code`.","enum":["invalid_input","authentication_required","forbidden","not_found","conflict","validation_error","rate_limit_exceeded","internal_error","run_failed","service_unavailable","timeout","plan_required","credit_usage_exceeded","user_quota_exceeded","spend_limit_exceeded","brain_flow_impact","stale_definition","flow_not_shared","asset_not_ready"],"title":"ApiErrorCode","type":"string"}}},"paths":{"/v1/agents/{agent_id}":{"get":{"tags":["agents"],"summary":"Get an agent — use GET /flows/{flow_id}","description":"**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.","operationId":"v1_get_agent_agents__agent_id__get","deprecated":true,"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Agent Id"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Active organization ID for multi-org support","title":"X-Organization-Id"},"description":"Active organization ID for multi-org support"}],"responses":{"308":{"description":"Permanent redirect to the `/flows` equivalent, query string preserved.","headers":{"Location":{"description":"The `/flows` URL to send this request to.","schema":{"type":"string"}},"Deprecation":{"description":"Always `true` on this endpoint.","schema":{"type":"string"}},"Sunset":{"description":"The date this endpoint is removed.","schema":{"type":"string"}},"Link":{"description":"The successor resource, as `rel=\"successor-version\"`.","schema":{"type":"string"}}}},"422":{"description":"Validation error (`validation_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}}}}}}
```
