# Get Agents

List agents for the authenticated company.

A summary projection: prompt and configuration are returned empty, toolIds null.
systemPrompt and outputFormat are returned today but are expected to be omitted in a future
release. Retrieve an agent by id for its complete representation. The namesAndVersions lookup
returns prompt and configuration populated; toolIds is null in any list response.

Endpoint: GET /agents
Version: 2.68.0
Security: OAuth2

## Query parameters:

  - `namesAndVersions` (string,null)
    Comma separated list of names and versions, eg agent1:v1,agent2:v2. At most 50 entries.

  - `limit` (integer)
    Maximum number of agents to return. Capped at 50; ignored when namesAndVersions is set.

  - `offset` (integer)
    Number of agents to skip. Ignored when namesAndVersions is set.

  - `editor` (string,null)
    Return only agents whose editors contain this value. Cannot be combined with namesAndVersions.

## Response 200 fields (application/json):

  - `data` (array, required)
    The page of results.

  - `data.id` (string, required)
    Example: "dcbc075f-a99c-4199-86ed-fb4ed5684dd9"

  - `data.rootAgentId` (string,null)
    Example: "dcbc075f-a99c-4199-86ed-fb4ed5684dd9"

  - `data.companyId` (string, required)
    Example: "6081acde0377a83b93f05a10"

  - `data.name` (string, required)
    Example: "Agent name"

  - `data.version` (string, required)
    Example: "Agent version"

  - `data.description` (string, required)
    Example: "Some description"

  - `data.prompt` (string, required)
    Prompt used for agent
    Example: "Hello GPT, how are you?"

  - `data.model` (string,null)
    Model UID used for this agent. If not specified, the default model will be used.
    Example: "b099cb97-4a5c-458f-8dcf-91139e731214"

  - `data.systemPrompt` (string,null)
    System prompt for the agent
    Example: "You are a helpful assistant."

  - `data.outputFormat` (object,null)
    Output format specification for the agent

  - `data.createdAt` (string,null)
    Date when Agent was added
    Example: "2023-10-27T11:38:18.000Z"

  - `data.createdBy` (string,null)
    Agent creator
    Example: "2023-10-27T11:38:18.000Z"

  - `data.updatedBy` (string,null)
    Agent updater
    Example: "Updater"

  - `data.updatedAt` (string,null)
    Date when Agent was last modified
    Example: "2023-10-27T12:38:18.000Z"

  - `data.editors` (array)
    Editor ids that can edit agent

  - `data.versions` (array)
    Other versions of this agent

  - `data.versionsMetadata` (array)
    Lightweight version summaries, populated when withVersionsMetadata=true

  - `data.versionsMetadata.createdAt` (string,null)

  - `data.versionsMetadata.createdBy` (string,null)

  - `data.configuration` (object,null)
    Additional agent configuration

  - `data.toolIds` (array,null)
    Ids of the tools assigned to this agent. On create/update: null or omitted leaves the assignments unchanged (a new agent starts with none), [] removes them all, and a list replaces them with exactly this set (a change creates a new agent version). Populated on by-id reads; null in list responses.

  - `data.isOotb` (boolean)
    Whether the agent is an out-of-the-box agent

  - `data.sourceTemplateAgentId` (string,null)
    Source template agent identifier

  - `data.sourceTemplateAgentVersion` (string,null)
    Concrete source template agent version used for import

  - `data.type` (string, required)
    The type of agent (BASIC, BASIC_V2, AGENTIC, METADATA, PAGE_BY_PAGE, LLM_OCR, STATIC, CASE_CLASSIFICATION, FILE_SUMMARIZATION, SCRIPT). SCRIPT runs author-provided TypeScript (from the prompt field, rendered with full mustache context) in a sandbox and returns JSON instead of calling an LLM.
    Example: "BASIC"

  - `limit` (integer, required)
    The limit applied to this page. Equal to the limit query parameter unless it exceeded the maximum allowed value, in which case it is that maximum.
    Example: 20

  - `offset` (integer, required)
    The offset applied to this page (echoes the offset query parameter).

  - `totalCount` (integer, required)
    The total number of elements across all pages.
    Example: 137

## Response 401 fields (application/json):

  - `status` (integer, required)
    Example: 422

  - `title` (string, required)
    Example: "Request validation error"

  - `detail` (string,null)
    Example: "Validation error details"

## Response 403 fields (application/json):

  - `status` (integer, required)
    Example: 422

  - `title` (string, required)
    Example: "Request validation error"

  - `detail` (string,null)
    Example: "Validation error details"

## Response 422 fields (application/json):

  - `status` (integer, required)
    Example: 422

  - `title` (string, required)
    Example: "Request validation error"

  - `detail` (string,null)
    Example: "Validation error details"