List public agents | Astropods

{
  "agents": [
    {
      "account": "string",
      "archived_at": "2024-01-15T09:30:00Z",
      "avatar_url": "string",
      "heart_count": 1,
      "hearted": true,
      "metrics": {
        "deploy_count": 1,
        "lifetime_messages": 1
      },
      "name": "string",
      "name_reserved": true,
      "publishers": [
        {
          "account": "string",
          "name": "string"
        }
      ],
      "registry": "string",
      "uid": "string",
      "versions": [
        {
          "agent_card": {
            "authors": [
              {
                "account": "string",
                "name": "string"
              }
            ],
            "body": "string",
            "capabilities": [
              "string"
            ],
            "description": "string",
            "integrations": [
              {
                "id": "string",
                "known": true,
                "name": "string"
              }
            ],
            "repository": {
              "directory": "string",
              "type": "string",
              "url": "string"
            },
            "tags": [
              "string"
            ]
          },
          "build_id": "string",
          "commit_message": "string",
          "commit_sha": "string",
          "published_at": "string",
          "readme": "string",
          "repo_full_name": "string",
          "spec": {},
          "validation_warnings": [
            {}
          ]
        }
      ],
      "visibility": "string"
    }
  ],
  "count": 1,
  "has_more": true,
  "limit": 1,
  "offset": 1
}

Returns the public catalog: agents with at least one published version. No authentication required.

Query parameters

qstringOptional

Search by name, description, tag, author, or publisher

repostringOptional

Filter by an exact GitHub repository as owner/name; a malformed repo or path returns 400 invalid_repo

pathstringOptional

Repository subdirectory; requires repo

tagstringOptional

Filter by tag on the latest version; comma list, any match

ownerstringOptional

Filter by owning account name; comma list

authorstringOptional

Filter by author handle: a publisher’s personal account or an agent card author account; comma list

created_afterstringOptional

Created at or after (RFC 3339)

created_beforestringOptional

Created before (RFC 3339)

updated_afterstringOptional

Latest version published at or after (RFC 3339)

updated_beforestringOptional

Latest version published before (RFC 3339)

sortstringOptional

Sort: name (default), updated, created, deploys or hearts; newest is an alias for updated

limitstringOptional

Page size (default 50, max 100)

offsetstringOptional

Page offset (max 10000)

Response

agentslist of objectsOptional

countintegerOptional

has_morebooleanOptional

limitintegerOptional

offsetintegerOptional

Errors

400

Bad Request Error