Skip to main content
GET
/
agents
List Agents
curl --request GET \
  --url https://api.kakiyo.com/v1/agents \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "agent_abcdef123456",
    "name": "John Doe",
    "status": "running",
    "login": "john.doe@example.com",
    "country": "US",
    "avatar": "https://example.com/avatar.jpg",
    "nextTask": "2023-06-16T10:30:00Z",
    "alerts": [
      {
        "type": "auth",
        "subType": "2fa_required",
        "message": "Please enter the verification code sent by LinkedIn to your email/phone",
        "severity": "warning"
      }
    ]
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.kakiyo.com/llms.txt

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

Authorizations

​
Authorization
string
header
required

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

Response

List of agents

​
id
string
Example:

"agent_abcdef123456"

​
name
string
Example:

"John Doe"

​
status
enum<string>
Available options:
setup_needed,
auth_needed,
auth_in_progress,
running,
paused,
disabled
Example:

"running"

​
login
string
Example:

"john.doe@example.com"

​
country
string
Example:

"US"

​
avatar
string
Example:

"https://example.com/avatar.jpg"

​
nextTask
string<date-time>
Example:

"2023-06-16T10:30:00Z"

​
alerts
object[]
Last modified on January 28, 2026