LogoLogo
Support PortalCalyptia CoreContact Us
Calyptia Core API
Calyptia Core API
  • Specification
  • About
  • API reference
    • Verification email
    • Projects
      • Tokens
      • Members
      • Invite
      • Agents
      • Aggregators
      • Core instances
      • Aggregator pipelines
      • Pipelines
      • Environments
      • Metrics
      • Config sections
      • Fleets
        • Status
      • Aws contracts
      • Processing rule templates
      • Saml mappings
    • Project tokens
    • Members
    • Join project
    • Agents
      • Config history
      • Metrics
      • Metrics by plugin
      • Metrics over time
      • Metrics over time by plugin
      • Errors
    • Aggregators
      • Ping
      • Resource profiles
      • Pipelines
      • Pipelines metrics
    • Core instance files
    • Core instance secrets
    • Resource profiles
    • Aggregator pipelines
      • Config history
      • Status history
      • Files
      • Secrets
      • Ports
    • Pipeline files
    • Pipeline logs
    • Pipeline checks
    • Core instance checks
    • Ingest checks
    • Pipeline secrets
    • Pipeline ports
    • Config validate
    • Config validate v2
    • Environments
    • Pipeline metrics
    • Aggregator metrics
    • Cluster objects
    • Trace sessions
      • Records
    • Config sections
    • Processing rules
    • Preview processing rule
    • Fleets
      • Status
      • Config
      • Files
      • Agent errors
    • Fleet files
    • Search
    • Aws customer redirect
    • Cluster object regexes
    • Processing rule templates
    • Validate fluentbit config
    • Saml mappings
    • Core instances
      • Files
      • Secrets
      • Pipelines
      • Ingest checks
      • Checks
      • Cluster objects
      • Metrics
      • Metrics by plugin
      • Metrics over time
      • Metrics over time by plugin
    • Pipelines
      • Logs
      • Checks
      • Cluster objects
      • Metadata
      • Trace sessions
      • Trace session
        • Records
      • Config section set
      • Processing rules
      • Metrics
      • Metrics by plugin
      • Metrics over time
      • Metrics over time by plugin
      • Cluster object regexes
    • Agent errors
      • Dismiss
  • Specification
Powered by GitBook
On this page
  1. API reference
  2. Agents

Errors

PreviousMetrics over time by pluginNextAggregators
  • GETAgent errors
  • POSTCreate agent error

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
OK
application/json
get
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-05-14T22:19:29.826Z",
    "dismissReason": "text",
    "createdAt": "2025-05-14T22:19:29.826Z"
  }
]

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-05-14T22:19:29.826Z"
}