Skip to main content
GET
/
agents
List available agents
curl --request GET \
  --url https://api.artosai.com/agents \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "<string>",
    "name": "<string>",
    "type": "<string>",
    "category": "<string>",
    "description": "<string>",
    "capabilities": [
      "<string>"
    ],
    "output_formats": [
      "<string>"
    ],
    "version": "<string>",
    "created_by": "<string>",
    "created_at": "2023-11-07T05:31:56Z"
  }
]

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

type
enum<string>

Filter by agent type.

Available options:
builtin,
custom
category
string

Filter by agent category (search, analysis, formatting, etc.).

created_by
string

Filter by the user who created the agent.

Response

200 - application/json

List of agents

id
string
name
string
type
string
category
string
description
string
capabilities
string[]
output_formats
string[]
version
string
created_by
string
created_at
string<date-time>