Errors

Agent errors

get

List all agent errors in descending order with backward pagination. You can optionally filter dismissed or not dismissed errors.

Authorizations

Path parameters

agentIDstring · uuidRequired

Query parameters

dismissedbooleanOptional

Filter agent errors that either were dismissed or were not.

lastintegerOptional

Last agent errors.

beforestringOptional

Agents errors before the given cursor.

Responses

200

application/json

get

GET /v1/agents/{agentID}/errors HTTP/1.1
Host: cloud-api.calyptia.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "agentID": "123e4567-e89b-12d3-a456-426614174000",
    "error": "[config] section 'foo' tried to instance a plugin name that don't exists",
    "dismissedAt": "2025-06-27T23:53:14.382Z",
    "dismissReason": "text",
    "createdAt": "2025-06-27T23:53:14.382Z"
  }
]

Create agent error

post

Create a new agent error. This endpoint should be called directly by agents themselves. Notice that if there is an error that matches exactly and has not been dismissed yet since the last time the config was updated, then the error will be simply ignored and not persisted.

Authorizations

Path parameters

agentIDstring · uuidRequired

Body

Request body required to create a new Agent Error.

errorstring · min: 1 · max: 1024RequiredExample: [config] section 'foo' tried to instance a plugin name that don't exists

Responses

201

Created

application/json

post

POST /v1/agents/{agentID}/errors HTTP/1.1
Host: cloud-api.calyptia.com
X-Project-Token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 84

{
  "error": "[config] section 'foo' tried to instance a plugin name that don't exists"
}

201

Created

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "createdAt": "2025-06-27T23:53:14.382Z"
}

PreviousMetrics over time by plugin NextAggregators