Skip to main content
GET
/
agents
List agents
curl --request GET \
  --url https://api.onecli.sh/v1/agents \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "<string>",
    "name": "<string>",
    "identifier": "<string>",
    "accessToken": "<string>",
    "isDefault": true,
    "createdAt": "2023-11-07T05:31:56Z",
    "_count": {
      "agentSecrets": 123,
      "agentAppConnections": 123
    }
  }
]

Authorizations

​
Authorization
string
header
required

API key obtained from the dashboard or GET /user/api-key

Response

List of agents

​
id
string
​
name
string
​
identifier
string
​
accessToken
string

The agent's gateway access token (aoc_…). Returned by GET /agents and GET /agents/default; not included in the POST /agents response — read it from the list or regenerate it.

​
isDefault
boolean
​
secretMode
enum<string>
Available options:
all,
selective
​
createdAt
string<date-time>
​
_count
object