GET
/
api
/
v1
/
agents
{
  "nodes": [
    {}
  ],
  "pageInfo": {}
}
Query and retrieve a paginated list of agents. Network policies are not included in the agent list response for performance reasons.
Requires Bearer token authentication

Parameters

filters
object
Filters for querying agents
labels
object
Labels for querying agents (e.g., label.environment=production)Label validation rules:
  • Label keys must match regex: ^[a-zA-Z0-9][-_a-zA-Z0-9]*[a-zA-Z0-9]$|^[a-zA-Z0-9]$
  • Label values must match regex: ^[a-zA-Z0-9][-_a-zA-Z0-9/. ]*$
first
integer
Number of items to return (forward pagination)
after
string
Cursor for forward pagination
last
integer
Number of items to return (backward pagination)
before
string
Cursor for backward pagination

Example

curl -H "Authorization: Bearer $GARNET_API_TOKEN" \
  "https://api.garnet.ai/v1/agents?label.environment=production&first=20"

Response

nodes
array
List of agent objects
pageInfo
object
Pagination information with cursors and navigation flags