Skip to main content
Flow AgentsVersion: v3

List Agents (Deprecated)

GET/agent-studio/public-api/agents
deprecated

This endpoint has been deprecated and may be replaced or removed in future versions of the API.

Deprecated endpoint - use GET /agent instead.

Lists all active agents that have a published production version for the specified location. locationId is required parameter. Supports pagination using limit and offset.

Authorizations

Authorizationstringheaderrequired

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

Scope:agent-studio.readonly
Auth methods:OAuthPrivate Integration
Token type:Sub-Account Token

Request​

Headers

Versionstringrequired

API Version

Available optionsv3
Example:v3

Query Parameters

locationIdstringrequired

Location ID

Example:C2QujeCh8ZnC7al2InWR
limitstringrequired

Page size (default 20, max 100)

Example:20
offsetstringrequired

Number of agents to skip before collecting results (pagination offset)

Example:0
sourcestring

Origin channel attributed to this read for auditing (e.g. public_api, internal)

Example:api

Response

Agents retrieved successfully

successbooleanrequired

Success status

Example:true
messagestringrequired

Response message

Example:Agents retrieved successfully
agentsobject[]required

List of agents with metadata

paginationobjectrequired

Pagination metadata