Skip to main content
Managed AgentsVersion: v3New

List published Managed Agents

GET/agent-studio/managed-agents

Returns only Managed Agents with a published production version in the authorized sub-account.

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

Query Parameters

locationIdstringrequired

Authorized sub-account ID.

Possible values: <= 256 characters

Example:ve9EPM428h8vShlRW1KT
skipinteger

Number of matching agents to skip.

Possible values: >= 0

Default:0
Example:0
limitinteger

Maximum number of agents to return.

Possible values: >= 1 and <= 100

Default:25
Example:25
querystring

Case-insensitive name or description search.

Possible values: <= 256 characters

Example:lead qualifier

Response

Published Managed Agents retrieved.

agentsobject[]required

Published Managed Agents on this page.

totalintegerrequired

Total number of matching published agents.

Possible values: >= 0

Example:3
skipintegerrequired

Number of matching agents skipped.

Possible values: >= 0

Example:0
limitintegerrequired

Maximum number of agents returned per page.

Possible values: >= 1 and <= 100

Example:25
hasMorebooleanrequired

Whether another page of results is available.

Example:false