Skip to main content
GET
/
agent-configs
curl -X GET "https://nunu.ai/api/v1/agent-configs?page=0&page_size=25" \
  -H "X-Api-Key: YOUR_API_TOKEN"

{
  "data": [
    {
      "id": "ac_default",
      "name": "default agent",
      "description": "Project default agent",
      "pinned": true
    }
  ],
  "pagination": {
    "page": 0,
    "page_size": 25,
    "total_count": 1,
    "total_pages": 1
  }
}

Documentation Index

Fetch the complete documentation index at: https://api-docs.nunu.ai/llms.txt

Use this file to discover all available pages before exploring further.

Permission Required: project:view-configs
Retrieve a paginated list of agent configurations for your project. Use this endpoint to discover valid agent_config_id values for Start a Run and Start Test Plan Run.

​
Query Parameters

​
page
integer
default:"0"
Page number (0-indexed)
​
page_size
integer
default:"25"
Results per page (1-100)

​
Response

​
data
AgentConfig[]
required
Array of agent config objects
​
pagination
object
required
Pagination metadata (page, page_size, total_count, total_pages)

​
AgentConfig Object

​
id
string
required
Agent config ID (use this as agent_config_id when starting runs)
​
name
string
required
Agent config name
​
description
string
Optional description
​
pinned
boolean
required
Whether the config is pinned (pinned items are returned first)
curl -X GET "https://nunu.ai/api/v1/agent-configs?page=0&page_size=25" \
  -H "X-Api-Key: YOUR_API_TOKEN"

{
  "data": [
    {
      "id": "ac_default",
      "name": "default agent",
      "description": "Project default agent",
      "pinned": true
    }
  ],
  "pagination": {
    "page": 0,
    "page_size": 25,
    "total_count": 1,
    "total_pages": 1
  }
}

Authorizations

​
X-Api-Key
string
header
required

API key for authentication

Query Parameters

​
page
integer
default:0

Page number (0-indexed)

​
page_size
integer
default:25

Results per page (1-100)

Required range: 1 <= x <= 100

Response

Successful response

​
data
object[]
​
pagination
object