Alert incidents

GET

/alerts

const url = 'https://api.flotera.com/api/v1/alerts?limit=50&state=open&severity=info';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api.flotera.com/api/v1/alerts?limit=50&state=open&severity=info' \
  --header 'Authorization: Bearer <token>'

Returns open and acknowledged incidents by default. total_open and total_critical count the complete filtered set, not just the current page.

Authorizations

integrationToken

Parameters

Query Parameters

cursor

string

>= 1 characters <= 512 characters

Pass next_cursor from the previous response unchanged. An invalid cursor returns 422.

limit

integer

default: 50 >= 1 <= 200

Page size.

state

string

Allowed values: open acknowledged

Filter by open or acknowledged; without a filter, both are returned. Closed incidents are unavailable. resolved returns 422.

severity

string

Allowed values: info warning critical

server_id

UUID (v7 for new entities; v4 is accepted).

string format: uuid

Incidents of one machine.

Responses

200

One page of incidents.

application/json

object

items

required

Array<object>

<= 200 items

object

required

UUID (v7 for new entities; v4 is accepted).

string format: uuid

server_id

One of:

string
null

UUID (v7 for new entities; v4 is accepted).

string format: uuid

server_name

string | null

<= 255 characters

gpu_index

GPU index, when the incident concerns a specific card.

integer | null

state

required

string

Allowed values: open acknowledged resolved

severity

required

string

Allowed values: info warning critical

metric

string | null

<= 64 characters

title

required

string

<= 256 characters

detail

string | null

<= 2048 characters

current_value

number | null

opened_at

required

RFC 3339 UTC with microsecond precision.

string format: date-time

last_seen_at

required

RFC 3339 UTC with microsecond precision.

string format: date-time

resolved_at

RFC 3339 UTC with microsecond precision, or null.

string | null format: date-time

next_cursor

required

Cursor of the next page; null — there are no more pages.

string | null

>= 1 characters <= 512 characters

total_open

required

Over the whole filtered set, not the page: the state asked for in state, or both open and acknowledged without it.

integer

total_critical

required

The same set, restricted to severity = critical.

integer

Example

{
  "items": [
    {
      "state": "open",
      "severity": "info",
      "opened_at": "2026-09-10T10:15:30.123456Z",
      "last_seen_at": "2026-09-10T10:15:30.123456Z"
    }
  ]
}

401

The token is missing, expired, revoked or issued for another purpose.

application/problem+json

RFC 9457 error response with a stable machine-readable code.

object

type

required

https://flotera.com/problems/<code>.

string format: uri

title

required

string

<= 256 characters

status

required

integer

>= 100 <= 599

code

required

Use this code to identify the error and decide whether to retry or correct the request.

string

Allowed values: unauthorized forbidden not_found method_not_allowed validation_failed rate_limited feature_not_entitled account_frozen tenant_suspended temporarily_unavailable internal_error

detail

string | null

<= 2048 characters

instance

string | null

<= 512 characters

request_id

One of:

string
null

UUID (v7 for new entities; v4 is accepted).

string format: uuid

Example

{
  "code": "unauthorized"
}

403

The token is genuine, but this operation is not available to it.

application/problem+json

RFC 9457 error response with a stable machine-readable code.

object

type

required

https://flotera.com/problems/<code>.

string format: uri

title

required

string

<= 256 characters

status

required

integer

>= 100 <= 599

code

required

Use this code to identify the error and decide whether to retry or correct the request.

string

Allowed values: unauthorized forbidden not_found method_not_allowed validation_failed rate_limited feature_not_entitled account_frozen tenant_suspended temporarily_unavailable internal_error

detail

string | null

<= 2048 characters

instance

string | null

<= 512 characters

request_id

One of:

string
null

UUID (v7 for new entities; v4 is accepted).

string format: uuid

Example

{
  "code": "unauthorized"
}

404

No such object — or it belongs to another account.

application/problem+json

RFC 9457 error response with a stable machine-readable code.

object

type

required

https://flotera.com/problems/<code>.

string format: uri

title

required

string

<= 256 characters

status

required

integer

>= 100 <= 599

code

required

Use this code to identify the error and decide whether to retry or correct the request.

string

Allowed values: unauthorized forbidden not_found method_not_allowed validation_failed rate_limited feature_not_entitled account_frozen tenant_suspended temporarily_unavailable internal_error

detail

string | null

<= 2048 characters

instance

string | null

<= 512 characters

request_id

One of:

string
null

UUID (v7 for new entities; v4 is accepted).

string format: uuid

Example

{
  "code": "unauthorized"
}

405

This path does not support the requested HTTP method. Check the Allow header for supported methods.

application/problem+json

RFC 9457 error response with a stable machine-readable code.

object

type

required

https://flotera.com/problems/<code>.

string format: uri

title

required

string

<= 256 characters

status

required

integer

>= 100 <= 599

code

required

Use this code to identify the error and decide whether to retry or correct the request.

string

Allowed values: unauthorized forbidden not_found method_not_allowed validation_failed rate_limited feature_not_entitled account_frozen tenant_suspended temporarily_unavailable internal_error

detail

string | null

<= 2048 characters

instance

string | null

<= 512 characters

request_id

One of:

string
null

UUID (v7 for new entities; v4 is accepted).

string format: uuid

Example

{
  "code": "unauthorized"
}

Headers

Allow

string

Methods this path accepts.

422

Request parameters failed validation.

application/problem+json

RFC 9457 error response with a stable machine-readable code.

object

type

required

https://flotera.com/problems/<code>.

string format: uri

title

required

string

<= 256 characters

status

required

integer

>= 100 <= 599

code

required

Use this code to identify the error and decide whether to retry or correct the request.

string

Allowed values: unauthorized forbidden not_found method_not_allowed validation_failed rate_limited feature_not_entitled account_frozen tenant_suspended temporarily_unavailable internal_error

detail

string | null

<= 2048 characters

instance

string | null

<= 512 characters

request_id

One of:

string
null

UUID (v7 for new entities; v4 is accepted).

string format: uuid

Example

{
  "code": "unauthorized"
}

429

Too many requests or failed authentication attempts. Check the token and wait for Retry-After seconds before retrying.

application/problem+json

RFC 9457 error response with a stable machine-readable code.

object

type

required

https://flotera.com/problems/<code>.

string format: uri

title

required

string

<= 256 characters

status

required

integer

>= 100 <= 599

code

required

Use this code to identify the error and decide whether to retry or correct the request.

string

Allowed values: unauthorized forbidden not_found method_not_allowed validation_failed rate_limited feature_not_entitled account_frozen tenant_suspended temporarily_unavailable internal_error

detail

string | null

<= 2048 characters

instance

string | null

<= 512 characters

request_id

One of:

string
null

UUID (v7 for new entities; v4 is accepted).

string format: uuid

Example

{
  "code": "unauthorized"
}

Headers

Retry-After

integer

Seconds to wait before retrying.

503

The data source is temporarily unavailable.

application/problem+json

RFC 9457 error response with a stable machine-readable code.

object

type

required

https://flotera.com/problems/<code>.

string format: uri

title

required

string

<= 256 characters

status

required

integer

>= 100 <= 599

code

required

Use this code to identify the error and decide whether to retry or correct the request.

string

Allowed values: unauthorized forbidden not_found method_not_allowed validation_failed rate_limited feature_not_entitled account_frozen tenant_suspended temporarily_unavailable internal_error

detail

string | null

<= 2048 characters

instance

string | null

<= 512 characters

request_id

One of:

string
null

UUID (v7 for new entities; v4 is accepted).

string format: uuid

Example

{
  "code": "unauthorized"
}

Headers

Retry-After

integer

Seconds to wait before retrying.