Get a published Managed Agent

GET 
/agent-studio/managed-agents/:managedAgentId

Returns public metadata for a published production Managed Agent. Unknown, unpublished, and cross-location identifiers return 404.

Request

Version stringrequired

API version.

Available optionsv3

managedAgentId stringrequired

Managed Agent ID.

locationId stringrequired

Authorized sub-account ID.

Possible values: <= 256 characters

application/json

Published Managed Agent retrieved.

application/json

Schema

Schema

idstringrequired

Managed Agent ID.

namestringrequired

Display name of the Managed Agent.

descriptionstringrequired

Public description of the Managed Agent.

locationIdstringrequired

Location (sub-account) that owns the agent.

publishedVersionIdstringrequired

Published production version ID.

publishedAtstring<date-time>

Time the production version was published.

modelstring

Model configured for the published version.

toolsstring[]

Tool identifiers enabled on the published version.

pluginsobject[]

Plugins enabled on the published version.

knowledgeBaseIdsstring[]

Knowledge base IDs configured on the published version.

Example (auto)

{
  "id": "027ee957-ae94-40ad-89a3-b25c985f729b",
  "name": "Lead Qualifier",
  "description": "Qualifies inbound leads and books appointments.",
  "locationId": "ve9EPM428h8vShlRW1KT",
  "publishedVersionId": "Ver1K8sSF2nC7al5InWz",
  "publishedAt": "2026-09-01T12:00:00.000Z",
  "model": "anthropic/claude-sonnet-4-6",
  "tools": [
    "web_search",
    "kb_search"
  ],
  "plugins": [
    {
      "slug": "social-planner",
      "name": "Social Planner"
    }
  ],
  "knowledgeBaseIds": [
    "kb_abc123"
  ]
}