Skip to main content
GET
/
api
/
v2
/
agents
List agents
curl --request GET \
  --url https://agp.eu.hcompany.ai/api/v2/agents \
  --header 'Authorization: Bearer <token>'
Returns a paginated list of agents visible to you: both your custom agents and the built-in H preset catalog. Returns a paginated list of Agent objects.

Query parameters

page
integer
default:"1"
Page number (1-based).
size
integer
default:"10"
Items per page. Maximum: 1000.
sort
string
default:"-created_at"
Sort order. Options: created_at, -created_at, agent_name, -agent_name.

Examples

List all available agents

curl "https://agp.eu.hcompany.ai/api/v2/agents" \
  -H "Authorization: Bearer $H_API_KEY"
Each item is a full Agent object.
Response
{
  "items": [
    {
      "name": "h/web-surfer-holo3-1-35b",
      "description": "General-purpose web browsing agent.",
      "environments": ["h/browser"],
      "model": null,
      "instructions": null,
      "skills": ["web-browse", "screenshot"],
      "subagents": null
    },
    {
      "name": "price-checker",
      "description": "Compares product prices across e-commerce sites.",
      "environments": ["h/browser"],
      "model": null,
      "instructions": null,
      "skills": null,
      "subagents": null
    }
  ],
  "page": 1,
  "total": 8
}