Skip to main content
GET
/
v2
/
agents
List agents
curl --request GET \
  --url https://api.orq.ai/v2/agents/ \
  --header 'Authorization: Bearer <token>'
{
  "object": "list",
  "data": [
    {
      "_id": "<string>",
      "key": "<string>",
      "display_name": "<string>",
      "role": "<string>",
      "description": "<string>",
      "instructions": "<string>",
      "status": "live",
      "model": {
        "id": "<string>",
        "integration_id": "<string>",
        "parameters": {
          "audio": {
            "voice": "alloy",
            "format": "wav"
          },
          "frequency_penalty": 123,
          "max_tokens": 123,
          "max_completion_tokens": 123,
          "logprobs": true,
          "top_logprobs": 10,
          "n": 2,
          "presence_penalty": 123,
          "response_format": {
            "type": "text"
          },
          "reasoning_effort": "none",
          "verbosity": "<string>",
          "seed": 123,
          "stop": "<string>",
          "stream_options": {
            "include_usage": true
          },
          "thinking": {
            "type": "disabled"
          },
          "temperature": 1,
          "top_p": 0.5,
          "top_k": 123,
          "tool_choice": "none",
          "parallel_tool_calls": true,
          "modalities": [
            "text"
          ],
          "guardrails": [
            {
              "id": "orq_pii_detection",
              "execute_on": "input"
            }
          ]
        },
        "retry": {
          "count": 3,
          "on_codes": [
            429,
            500,
            502,
            503,
            504
          ]
        },
        "fallback_models": [
          "<string>"
        ]
      },
      "path": "Default",
      "memory_stores": [
        "<string>"
      ],
      "team_of_agents": [
        {
          "key": "<string>",
          "role": "<string>"
        }
      ],
      "created_by_id": "<string>",
      "updated_by_id": "<string>",
      "created": "<string>",
      "updated": "<string>",
      "system_prompt": "<string>",
      "settings": {
        "max_execution_time": 600,
        "max_iterations": 100,
        "tool_approval_required": "respect_tool",
        "tools": []
      },
      "version_hash": "<string>",
      "metrics": {
        "total_cost": 0
      },
      "variables": {},
      "knowledge_bases": [
        {
          "knowledge_id": "customer-knowledge-base"
        }
      ]
    }
  ],
  "has_more": true
}

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
limit
number

A limit on the number of objects to be returned. Limit can range between 1 and 200. When not provided, returns all agents without pagination.

Required range: 1 <= x <= 200
​
starting_after
string

A cursor for use in pagination. starting_after is an object ID that defines your place in the list. For instance, if you make a list request and receive 20 objects, ending with 01JJ1HDHN79XAS7A01WB3HYSDB, your subsequent call can include after=01JJ1HDHN79XAS7A01WB3HYSDB in order to fetch the next page of the list.

​
ending_before
string

A cursor for use in pagination. ending_before is an object ID that defines your place in the list. For instance, if you make a list request and receive 20 objects, starting with 01JJ1HDHN79XAS7A01WB3HYSDB, your subsequent call can include before=01JJ1HDHN79XAS7A01WB3HYSDB in order to fetch the previous page of the list.

Response

200 - application/json

Successfully retrieved the list of agents. Returns a paginated response containing agent manifests with complete configurations, including primary and fallback models, tools, knowledge bases, and execution settings.

​
object
enum<string>
required
Available options:
list
​
data
object[]
required
​
has_more
boolean
required