Skip to content

List AI Agents

GET
/api/v3/organizations/{organisation}/ai/agents

Lists all AI agents for an organization. Agents are pre-configured AI assistants with specific system prompts, model settings, and tool permissions. * * Features: * - Filter by group (e.g., ‘development’, ‘compliance’) * - Organization-scoped * - Returns agent configurations without execution history

Authorizations

Parameters

Path Parameters

organisation
required
string

The organisation ID

Query Parameters

group
string

Optional group filter (e.g., ‘development’, ‘compliance’)

Responses

200

List of agents retrieved successfully

object
agents
Array<object>
object
agentId
string format: uuid
name
string
description
string
group
string
modelId
string
temperature
number
maxTokens
integer
allowedTools
Array<string>
createdAt
string format: date-time
updatedAt
string format: date-time

403

Access denied

500

Failed to retrieve agents