Skip to main content
GET
/
agents
List Agents
curl --request GET \
  --url https://api.example.com/agents

Documentation Index

Fetch the complete documentation index at: https://docs.mosaic.so/llms.txt

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

Returns all agents scoped to your API key’s organization.

​
Request

curl -X GET "https://api.mosaic.so/agents?limit=25" \
  -H "Authorization: Bearer mk_your_api_key"

​
Query Parameters

FieldTypeRequiredDescription
limitnumberNoPage size (1-100, default 25).
cursorstringNoPagination cursor from next_cursor.

​
Response

{
  "agents": [
    {
      "id": "123e4567-e89b-12d3-a456-789012345678",
      "name": "My Agent",
      "description": "Weekly YouTube clip automation",
      "created_at": "2026-03-01T12:00:00Z",
      "updated_at": "2026-03-02T08:00:00Z"
    }
  ],
  "next_cursor": null
}