Get agent content
GET /api/v1/agents/{coordinator}
Get agent content by canonical key. Public reads use the current published revision; authenticated execution reads use the revision captured when execution started.
Path Format
/api/v1/agents/:coordinator— coordinator agent
Access
Project Agent reads require an exact Agent and Environment coordinate in the authenticated organization. System Agent reads resolve the active publication by slug and require no Environment selector.
Parameters
path
| Name | Type | Required | Description |
|---|---|---|---|
coordinator | string | required | Identifies the coordinator agent by its canonical name. Applies to Get agent content. |
query
| Name | Type | Required | Description |
|---|---|---|---|
agentId | string | optional | Selects the Project Agent by its stable identifier. Applies to Get agent content. |
environmentId | string | optional | Selects the active Project environment coordinate. Applies to Get agent content. |
organizationId | string | optional | Selects the authorization organization for a legacy System Agent. Required for sessions without Project Agent coordinates. Omit when addressing a Project Agent. |
Responses
| Status | Description | Body |
|---|---|---|
200 | Response for status 200 | application/json — object — data: object (required) |
400 | The request is malformed or cannot be processed. | application/json — PublicApiError — error: object (required) |
401 | Authentication failed. The Authorization header is missing, or the credential is invalid or expired. | application/json — PublicApiError — error: object (required) |
403 | Access denied. The authenticated user does not have permission to perform this action. | application/json — PublicApiError — error: object (required) |
404 | Resource not found. | application/json — PublicApiError — error: object (required) |
409 | Request conflicts with current state of the resource, including safe deployment conflict classifications. | application/json — PublicApiError — error: object (required) |
422 | Request validation failed. Check the request body, query parameters, or path parameters. | application/json — PublicApiError — error: object (required) |
429 | Too many requests. | application/json — PublicApiError — error: object (required) |
500 | The server could not complete the request. | application/json — PublicApiError — error: object (required) |
503 | Service temporarily unavailable (e.g. execution capacity exhausted). The response carries a Retry-After header; retry with backoff. | application/json — PublicApiError — error: object (required) |