Skip to main content
Managed AgentsVersion: v3New

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.

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your access token.

Scope:managed-agents.readonly
Auth methods:OAuthPrivate Integration
Token type:Sub-Account Token

Request​

Headers

Versionstringrequired

API version.

Available optionsv3
Example:v3

Path Parameters

managedAgentIdstringrequired

Managed Agent ID.

Example:027ee957-ae94-40ad-89a3-b25c985f729b

Query Parameters

locationIdstringrequired

Authorized sub-account ID.

Possible values: <= 256 characters

Example:ve9EPM428h8vShlRW1KT

Response

Published Managed Agent retrieved.

idstringrequired

Managed Agent ID.

Example:027ee957-ae94-40ad-89a3-b25c985f729b
namestringrequired

Display name of the Managed Agent.

Example:Lead Qualifier
descriptionstringrequired

Public description of the Managed Agent.

Example:Qualifies inbound leads and books appointments.
locationIdstringrequired

Location (sub-account) that owns the agent.

Example:ve9EPM428h8vShlRW1KT
publishedVersionIdstringrequired

Published production version ID.

Example:Ver1K8sSF2nC7al5InWz
publishedAtstring<date-time>

Time the production version was published.

Example:2026-09-01T12:00:00.000Z
modelstring

Model configured for the published version.

Example:anthropic/claude-sonnet-4-6
toolsstring[]

Tool identifiers enabled on the published version.

Example:["web_search","kb_search"]
pluginsobject[]

Plugins enabled on the published version.

knowledgeBaseIdsstring[]

Knowledge base IDs configured on the published version.

Example:["kb_abc123"]