Agents

List agents

Returns all agents in the project.

get/v1/projects/{project_id}/agents

Request

  • Base URL: https://api.naturali.ai
  • URL: https://api.naturali.ai/v1/projects/{project_id}/agents
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.naturali.ai/authorize, token URL https://api.naturali.ai/token, scopes: mcp:access)

Query parameters

limitinteger

Results per page, 1 to 100 (default 50). Above 100 it is clamped; below 1 or not an integer it is 400.

offsetinteger

Results to skip. Negative or not an integer it is 400.

Response

List of agents

totalinteger required
limitinteger required
offsetinteger required

Example response

{
  "data": [
    {
      "id": "agent_V1StGXR8Z5jdHi6B",
      "tool_bindings": [
        {
          "tool_id": "tool_V1StGXR8Z5jdHi6B"
        }
      ],
      "knowledge_config": {
        "tags": {
          "team": "finance",
          "env": "prod"
        }
      },
      "max_output_tokens": 1024,
      "reasoning": {
        "effort": "low"
      },
      "version": 3,
      "active_release": {
        "stable_version": 3,
        "canary_version": 4,
        "canary_percent": 20,
        "promotion_gate": "eval_V1StGXR8Z5jdHi6B"
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.