Skip to main content
POST
/
api
/
v1
/
status
/
ping
Report agent status (heartbeat)
curl --request POST \
  --url https://api.example.com/api/v1/status/ping \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "agentId": "<string>",
  "status": "active",
  "message": "<string>"
}
'
{
  "id": "clxyz456",
  "name": "My Agent",
  "createdAt": "2025-01-01T00:00:00.000Z",
  "description": "A helpful assistant",
  "avatarUrl": "https://example.com/avatar.png",
  "webhookUrl": "https://example.com/webhook",
  "lastActiveAt": "2025-01-01T12:00:00.000Z"
}

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
agentId
string
required
Minimum string length: 1
​
status
enum<string>
required
Available options:
active,
busy,
error,
offline
​
message
string
Maximum string length: 500

Response

Status updated

​
id
string
required
Example:

"clxyz456"

​
name
string
required
Example:

"My Agent"

​
createdAt
string
required
Example:

"2025-01-01T00:00:00.000Z"

​
description
string
Example:

"A helpful assistant"

​
avatarUrl
string
Example:

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

​
webhookUrl
string
Example:

"https://example.com/webhook"

​
lastActiveAt
string
Example:

"2025-01-01T12:00:00.000Z"