Errors

Agent errors

get

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

Authorizations

userproject

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

application/json

object[]Optional

An Agent Error represent an error that occurred on an agent. It can be an invalid configuration, or a malfunctioning plugin. These come directly from agents. Any agent that has errors since the last time it was updated will be marked as "errored". Errors can be dismissed by the user.

get

HTTPcURLJavaScriptPython

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

200

OK

[
  {
    "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-04-24T07:15:57.492Z",
    "dismissReason": "text",
    "createdAt": "2025-04-24T07:15:57.492Z"
  }
]

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

application/json

objectOptional

Response body after creating a new Agent Error.

post

HTTPcURLJavaScriptPython

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-04-24T07:15:57.492Z"
}