Skip to main content
GET
List Agent Environments

Overview

Returns the agent’s dev, staging, and production environments, each with the name and semver of the version it is pinned to. dev is never pinned: it always runs the newest saved version. Move the staging pointer with Publish Agent to Staging and the production pointer with Promote Agent to Production or Roll Back Agent. A promote with version_id moves staging too. This endpoint does not accept restricted API keys; they receive 403 INSUFFICIENT_SCOPE. Get Agent returns the same pointers without version names or semvers and accepts the agents:read scope.

Headers

string
required
Your API key for authentication.

Path Parameters

string
required
The agent’s unique identifier.

Response

array
The agent’s three environments.
null | array
null on success, or a list of error objects if the request failed.

Docs for agents: llms.txt