What this token is and what it may call

GET

/me

const url = 'https://api.flotera.com/api/v1/me';
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/me \
  --header 'Authorization: Bearer <token>'

Call this operation first to check the token’s expiry and available operations. The response includes metadata and a masked prefix, not the secret token.

Authorizations

integrationToken

Responses

200

Metadata of the presented token.

application/json

Metadata of the presented token.

object

name

required

The name given when the token was issued in the panel.

string

<= 80 characters

token_prefix

required

Mask of the secret — the same one shown in the panel. The token cannot be reconstructed from it; it exists to match a working integration with a row in the token list.

string

<= 32 characters

created_at

RFC 3339 UTC with microsecond precision.

string format: date-time

expires_at

required

After this moment the token stops working. An issued token cannot be extended — a new one is issued instead.

string format: date-time

last_used_at

Updated at most once every five minutes: the mark exists to find forgotten integrations, not to count requests.

string | null format: date-time

coverage

required

All servers in the account, including those added after token creation.

string

Allowed values: account_fleet

operations

required

The operations currently available to this token. Availability depends on the user’s permissions and account state. During an account freeze, listAlerts is unavailable.

Array<string>

<= 32 items

rate_limit

required

The request ceiling in force for this token.

object

requests_per_minute

The effective request ceiling for this account; null means no ceiling applies.

integer | null

scope

required

Requests are counted PER ACCOUNT, not per token: two integration tokens of one account share the same budget and hit 429 together.

string

Allowed values: account

Example

{
  "created_at": "2026-09-10T10:15:30.123456Z",
  "expires_at": "2026-09-10T10:15:30.123456Z",
  "coverage": "account_fleet",
  "rate_limit": {
    "scope": "account"
  }
}

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"
}

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.

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.