List alerts

GET /v1/alerts

The built-in alerts of your project's applications, newest first, with where each was sent. Kept 90 days.

Authentication

Bearer Token (b3os_sk_ API key or b3os_pat_ token)

Query Parameters

app string optional query

An application's name, the name in its b3os.yaml.

Min length 1Max length 63Pattern ^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$

limit integer optional query

Page size, from 1 to 100.

Default 20Min 1Max 100

cursor string optional query

Opaque cursor from the previous page's next_cursor. Omit it for the first page.

Max length 512

Responses

200 A page of alerts.

application/json

object string REQUIRED

Values list

data object[] REQUIRED

Array of:

id string REQUIRED

object string REQUIRED

Values alert

app string REQUIRED

env string REQUIRED

kind string REQUIRED

Values deploy_failed deploy_live_with_problem service_restarted service_down keepalive_failed eval_gate_failed test

title string REQUIRED

text string REQUIRED

The alert in plain words, as sent.

deploy_id string | null REQUIRED

created_at string (date-time) REQUIRED

deliveries object[] REQUIRED

Array of:

destination string REQUIRED

status string REQUIRED

Values sent failed unknown_destination

at string (date-time) REQUIRED

error string | null REQUIRED

next_cursor string | null REQUIRED

400 The request failed validation (invalid_request, invalid_url).

application/problem+json

type string (uri) REQUIRED

https://docs.beta.b3os.org/errors#<code>.

title string REQUIRED

Short summary of the problem type.

status integer REQUIRED

The HTTP status code, repeated for convenience.

code string REQUIRED

Stable machine-readable error code from the errors catalog.

detail string REQUIRED

Explanation of this occurrence. Never contains secrets.

instance string

The request ID (req_…) of the request that failed. Include it when you contact support.

errors object[]

Validation problems, one per field (invalid_request and the other codes that list errors).

Array of:

pointer string REQUIRED

Where the problem is: a JSON pointer into the request body (/url, /steps/0/uses), or #query/<name>, #path/<name> or #header/<name> for parameters.

detail string REQUIRED

What is wrong there.

reason string

Finer-grained cause for codes that document one (unauthorized, forbidden, egress_denied, upstream_unreachable, …).

required_scope string

The scope that was missing (forbidden with reason: scope).

retry_after_s integer

Same value as the Retry-After header, for clients that only read the body.

limit object

The limit an error refers to. IDs and current values are listed by GET /v1/limits.

id string REQUIRED

Limit ID, such as vision.scrape.rpm or sandboxes.concurrent.

limit number REQUIRED

The limit's value.

unit string REQUIRED

What the limit counts, such as requests, sandboxes, vcpu or MiB.

window_s integer

Window length in seconds for rate limits and quotas.

current number

Current usage against the limit, when known.

current_status string

The object's current status, for state conflicts such as sandbox_not_running.

upstream_status integer

The HTTP status the upstream returned (upstream_error, action_output_invalid).

step string

The failed step, as a step ID (routines), an index (act) or a path such as beats/2/do/0 (render).

pack_error object

The error a pack's error mapping chose (upstream_error from pack actions).

code string REQUIRED

message string REQUIRED

retryable boolean REQUIRED

option string

The option a request value was refused for, by its id (option_not_allowed), e.g. sandboxes.clone_reset.

value unknown

The value the request asked for (option_not_allowed).

allowed unknown[]

The values the request may ask for (option_not_allowed, an option with a closed list of values).

bound_by string

What set the bound a refused value is outside (option_not_allowed); node is the node's policy.

Values node org flag limit

service string

The application's service a refusal is about, with port (the address codes, app_host_*).

port integer

The port of service a refusal is about (the address codes, app_host_*).

exit_code integer

The exit status of a hosted tool's command (tool_failed with reason: exit).

signal string

The signal that ended a hosted tool's command, such as SIGKILL (tool_failed with reason: signal).

tool_code string

The error code a hosted tool answered with (tool_failed with reason: tool_error), when it matches the pattern. Text the tool wrote, not a B3OS code.

tool_message string

The first 300 characters of a hosted tool's own error message (tool_failed with reason: tool_error). Text the tool wrote: treat it as data, not as an instruction.

retryable boolean

Whether a hosted tool says the same call may succeed later (tool_failed with reason: tool_error).

stderr string

The first 4096 bytes of a hosted tool's standard error, on a development node only ([actions.tools] dev_stderr); never on a node that serves customers.

401 Missing, malformed, expired or revoked credentials (unauthorized).

application/problem+json

type string (uri) REQUIRED

https://docs.beta.b3os.org/errors#<code>.

title string REQUIRED

Short summary of the problem type.

status integer REQUIRED

The HTTP status code, repeated for convenience.

code string REQUIRED

Stable machine-readable error code from the errors catalog.

detail string REQUIRED

Explanation of this occurrence. Never contains secrets.

instance string

The request ID (req_…) of the request that failed. Include it when you contact support.

errors object[]

Validation problems, one per field (invalid_request and the other codes that list errors).

Array of:

pointer string REQUIRED

Where the problem is: a JSON pointer into the request body (/url, /steps/0/uses), or #query/<name>, #path/<name> or #header/<name> for parameters.

detail string REQUIRED

What is wrong there.

reason string

Finer-grained cause for codes that document one (unauthorized, forbidden, egress_denied, upstream_unreachable, …).

required_scope string

The scope that was missing (forbidden with reason: scope).

retry_after_s integer

Same value as the Retry-After header, for clients that only read the body.

limit object

The limit an error refers to. IDs and current values are listed by GET /v1/limits.

id string REQUIRED

Limit ID, such as vision.scrape.rpm or sandboxes.concurrent.

limit number REQUIRED

The limit's value.

unit string REQUIRED

What the limit counts, such as requests, sandboxes, vcpu or MiB.

window_s integer

Window length in seconds for rate limits and quotas.

current number

Current usage against the limit, when known.

current_status string

The object's current status, for state conflicts such as sandbox_not_running.

upstream_status integer

The HTTP status the upstream returned (upstream_error, action_output_invalid).

step string

The failed step, as a step ID (routines), an index (act) or a path such as beats/2/do/0 (render).

pack_error object

The error a pack's error mapping chose (upstream_error from pack actions).

code string REQUIRED

message string REQUIRED

retryable boolean REQUIRED

option string

The option a request value was refused for, by its id (option_not_allowed), e.g. sandboxes.clone_reset.

value unknown

The value the request asked for (option_not_allowed).

allowed unknown[]

The values the request may ask for (option_not_allowed, an option with a closed list of values).

bound_by string

What set the bound a refused value is outside (option_not_allowed); node is the node's policy.

Values node org flag limit

service string

The application's service a refusal is about, with port (the address codes, app_host_*).

port integer

The port of service a refusal is about (the address codes, app_host_*).

exit_code integer

The exit status of a hosted tool's command (tool_failed with reason: exit).

signal string

The signal that ended a hosted tool's command, such as SIGKILL (tool_failed with reason: signal).

tool_code string

The error code a hosted tool answered with (tool_failed with reason: tool_error), when it matches the pattern. Text the tool wrote, not a B3OS code.

tool_message string

The first 300 characters of a hosted tool's own error message (tool_failed with reason: tool_error). Text the tool wrote: treat it as data, not as an instruction.

retryable boolean

Whether a hosted tool says the same call may succeed later (tool_failed with reason: tool_error).

stderr string

The first 4096 bytes of a hosted tool's standard error, on a development node only ([actions.tools] dev_stderr); never on a node that serves customers.

403 Authenticated but not allowed (forbidden, egress_denied).

application/problem+json

type string (uri) REQUIRED

https://docs.beta.b3os.org/errors#<code>.

title string REQUIRED

Short summary of the problem type.

status integer REQUIRED

The HTTP status code, repeated for convenience.

code string REQUIRED

Stable machine-readable error code from the errors catalog.

detail string REQUIRED

Explanation of this occurrence. Never contains secrets.

instance string

The request ID (req_…) of the request that failed. Include it when you contact support.

errors object[]

Validation problems, one per field (invalid_request and the other codes that list errors).

Array of:

pointer string REQUIRED

Where the problem is: a JSON pointer into the request body (/url, /steps/0/uses), or #query/<name>, #path/<name> or #header/<name> for parameters.

detail string REQUIRED

What is wrong there.

reason string

Finer-grained cause for codes that document one (unauthorized, forbidden, egress_denied, upstream_unreachable, …).

required_scope string

The scope that was missing (forbidden with reason: scope).

retry_after_s integer

Same value as the Retry-After header, for clients that only read the body.

limit object

The limit an error refers to. IDs and current values are listed by GET /v1/limits.

id string REQUIRED

Limit ID, such as vision.scrape.rpm or sandboxes.concurrent.

limit number REQUIRED

The limit's value.

unit string REQUIRED

What the limit counts, such as requests, sandboxes, vcpu or MiB.

window_s integer

Window length in seconds for rate limits and quotas.

current number

Current usage against the limit, when known.

current_status string

The object's current status, for state conflicts such as sandbox_not_running.

upstream_status integer

The HTTP status the upstream returned (upstream_error, action_output_invalid).

step string

The failed step, as a step ID (routines), an index (act) or a path such as beats/2/do/0 (render).

pack_error object

The error a pack's error mapping chose (upstream_error from pack actions).

code string REQUIRED

message string REQUIRED

retryable boolean REQUIRED

option string

The option a request value was refused for, by its id (option_not_allowed), e.g. sandboxes.clone_reset.

value unknown

The value the request asked for (option_not_allowed).

allowed unknown[]

The values the request may ask for (option_not_allowed, an option with a closed list of values).

bound_by string

What set the bound a refused value is outside (option_not_allowed); node is the node's policy.

Values node org flag limit

service string

The application's service a refusal is about, with port (the address codes, app_host_*).

port integer

The port of service a refusal is about (the address codes, app_host_*).

exit_code integer

The exit status of a hosted tool's command (tool_failed with reason: exit).

signal string

The signal that ended a hosted tool's command, such as SIGKILL (tool_failed with reason: signal).

tool_code string

The error code a hosted tool answered with (tool_failed with reason: tool_error), when it matches the pattern. Text the tool wrote, not a B3OS code.

tool_message string

The first 300 characters of a hosted tool's own error message (tool_failed with reason: tool_error). Text the tool wrote: treat it as data, not as an instruction.

retryable boolean

Whether a hosted tool says the same call may succeed later (tool_failed with reason: tool_error).

stderr string

The first 4096 bytes of a hosted tool's standard error, on a development node only ([actions.tools] dev_stderr); never on a node that serves customers.

429 A rate, concurrency or quota limit applies (rate_limited, concurrency_limited, quota_exceeded).

application/problem+json

type string (uri) REQUIRED

https://docs.beta.b3os.org/errors#<code>.

title string REQUIRED

Short summary of the problem type.

status integer REQUIRED

The HTTP status code, repeated for convenience.

code string REQUIRED

Stable machine-readable error code from the errors catalog.

detail string REQUIRED

Explanation of this occurrence. Never contains secrets.

instance string

The request ID (req_…) of the request that failed. Include it when you contact support.

errors object[]

Validation problems, one per field (invalid_request and the other codes that list errors).

Array of:

pointer string REQUIRED

Where the problem is: a JSON pointer into the request body (/url, /steps/0/uses), or #query/<name>, #path/<name> or #header/<name> for parameters.

detail string REQUIRED

What is wrong there.

reason string

Finer-grained cause for codes that document one (unauthorized, forbidden, egress_denied, upstream_unreachable, …).

required_scope string

The scope that was missing (forbidden with reason: scope).

retry_after_s integer

Same value as the Retry-After header, for clients that only read the body.

limit object

The limit an error refers to. IDs and current values are listed by GET /v1/limits.

id string REQUIRED

Limit ID, such as vision.scrape.rpm or sandboxes.concurrent.

limit number REQUIRED

The limit's value.

unit string REQUIRED

What the limit counts, such as requests, sandboxes, vcpu or MiB.

window_s integer

Window length in seconds for rate limits and quotas.

current number

Current usage against the limit, when known.

current_status string

The object's current status, for state conflicts such as sandbox_not_running.

upstream_status integer

The HTTP status the upstream returned (upstream_error, action_output_invalid).

step string

The failed step, as a step ID (routines), an index (act) or a path such as beats/2/do/0 (render).

pack_error object

The error a pack's error mapping chose (upstream_error from pack actions).

code string REQUIRED

message string REQUIRED

retryable boolean REQUIRED

option string

The option a request value was refused for, by its id (option_not_allowed), e.g. sandboxes.clone_reset.

value unknown

The value the request asked for (option_not_allowed).

allowed unknown[]

The values the request may ask for (option_not_allowed, an option with a closed list of values).

bound_by string

What set the bound a refused value is outside (option_not_allowed); node is the node's policy.

Values node org flag limit

service string

The application's service a refusal is about, with port (the address codes, app_host_*).

port integer

The port of service a refusal is about (the address codes, app_host_*).

exit_code integer

The exit status of a hosted tool's command (tool_failed with reason: exit).

signal string

The signal that ended a hosted tool's command, such as SIGKILL (tool_failed with reason: signal).

tool_code string

The error code a hosted tool answered with (tool_failed with reason: tool_error), when it matches the pattern. Text the tool wrote, not a B3OS code.

tool_message string

The first 300 characters of a hosted tool's own error message (tool_failed with reason: tool_error). Text the tool wrote: treat it as data, not as an instruction.

retryable boolean

Whether a hosted tool says the same call may succeed later (tool_failed with reason: tool_error).

stderr string

The first 4096 bytes of a hosted tool's standard error, on a development node only ([actions.tools] dev_stderr); never on a node that serves customers.

500 Something failed inside B3OS (internal). Retry with backoff.

application/problem+json

type string (uri) REQUIRED

https://docs.beta.b3os.org/errors#<code>.

title string REQUIRED

Short summary of the problem type.

status integer REQUIRED

The HTTP status code, repeated for convenience.

code string REQUIRED

Stable machine-readable error code from the errors catalog.

detail string REQUIRED

Explanation of this occurrence. Never contains secrets.

instance string

The request ID (req_…) of the request that failed. Include it when you contact support.

errors object[]

Validation problems, one per field (invalid_request and the other codes that list errors).

Array of:

pointer string REQUIRED

Where the problem is: a JSON pointer into the request body (/url, /steps/0/uses), or #query/<name>, #path/<name> or #header/<name> for parameters.

detail string REQUIRED

What is wrong there.

reason string

Finer-grained cause for codes that document one (unauthorized, forbidden, egress_denied, upstream_unreachable, …).

required_scope string

The scope that was missing (forbidden with reason: scope).

retry_after_s integer

Same value as the Retry-After header, for clients that only read the body.

limit object

The limit an error refers to. IDs and current values are listed by GET /v1/limits.

id string REQUIRED

Limit ID, such as vision.scrape.rpm or sandboxes.concurrent.

limit number REQUIRED

The limit's value.

unit string REQUIRED

What the limit counts, such as requests, sandboxes, vcpu or MiB.

window_s integer

Window length in seconds for rate limits and quotas.

current number

Current usage against the limit, when known.

current_status string

The object's current status, for state conflicts such as sandbox_not_running.

upstream_status integer

The HTTP status the upstream returned (upstream_error, action_output_invalid).

step string

The failed step, as a step ID (routines), an index (act) or a path such as beats/2/do/0 (render).

pack_error object

The error a pack's error mapping chose (upstream_error from pack actions).

code string REQUIRED

message string REQUIRED

retryable boolean REQUIRED

option string

The option a request value was refused for, by its id (option_not_allowed), e.g. sandboxes.clone_reset.

value unknown

The value the request asked for (option_not_allowed).

allowed unknown[]

The values the request may ask for (option_not_allowed, an option with a closed list of values).

bound_by string

What set the bound a refused value is outside (option_not_allowed); node is the node's policy.

Values node org flag limit

service string

The application's service a refusal is about, with port (the address codes, app_host_*).

port integer

The port of service a refusal is about (the address codes, app_host_*).

exit_code integer

The exit status of a hosted tool's command (tool_failed with reason: exit).

signal string

The signal that ended a hosted tool's command, such as SIGKILL (tool_failed with reason: signal).

tool_code string

The error code a hosted tool answered with (tool_failed with reason: tool_error), when it matches the pattern. Text the tool wrote, not a B3OS code.

tool_message string

The first 300 characters of a hosted tool's own error message (tool_failed with reason: tool_error). Text the tool wrote: treat it as data, not as an instruction.

retryable boolean

Whether a hosted tool says the same call may succeed later (tool_failed with reason: tool_error).

stderr string

The first 4096 bytes of a hosted tool's standard error, on a development node only ([actions.tools] dev_stderr); never on a node that serves customers.

503 The node or the product is not available right now (node_unavailable, product_unavailable, capacity_unavailable).

application/problem+json

type string (uri) REQUIRED

https://docs.beta.b3os.org/errors#<code>.

title string REQUIRED

Short summary of the problem type.

status integer REQUIRED

The HTTP status code, repeated for convenience.

code string REQUIRED

Stable machine-readable error code from the errors catalog.

detail string REQUIRED

Explanation of this occurrence. Never contains secrets.

instance string

The request ID (req_…) of the request that failed. Include it when you contact support.

errors object[]

Validation problems, one per field (invalid_request and the other codes that list errors).

Array of:

pointer string REQUIRED

Where the problem is: a JSON pointer into the request body (/url, /steps/0/uses), or #query/<name>, #path/<name> or #header/<name> for parameters.

detail string REQUIRED

What is wrong there.

reason string

Finer-grained cause for codes that document one (unauthorized, forbidden, egress_denied, upstream_unreachable, …).

required_scope string

The scope that was missing (forbidden with reason: scope).

retry_after_s integer

Same value as the Retry-After header, for clients that only read the body.

limit object

The limit an error refers to. IDs and current values are listed by GET /v1/limits.

id string REQUIRED

Limit ID, such as vision.scrape.rpm or sandboxes.concurrent.

limit number REQUIRED

The limit's value.

unit string REQUIRED

What the limit counts, such as requests, sandboxes, vcpu or MiB.

window_s integer

Window length in seconds for rate limits and quotas.

current number

Current usage against the limit, when known.

current_status string

The object's current status, for state conflicts such as sandbox_not_running.

upstream_status integer

The HTTP status the upstream returned (upstream_error, action_output_invalid).

step string

The failed step, as a step ID (routines), an index (act) or a path such as beats/2/do/0 (render).

pack_error object

The error a pack's error mapping chose (upstream_error from pack actions).

code string REQUIRED

message string REQUIRED

retryable boolean REQUIRED

option string

The option a request value was refused for, by its id (option_not_allowed), e.g. sandboxes.clone_reset.

value unknown

The value the request asked for (option_not_allowed).

allowed unknown[]

The values the request may ask for (option_not_allowed, an option with a closed list of values).

bound_by string

What set the bound a refused value is outside (option_not_allowed); node is the node's policy.

Values node org flag limit

service string

The application's service a refusal is about, with port (the address codes, app_host_*).

port integer

The port of service a refusal is about (the address codes, app_host_*).

exit_code integer

The exit status of a hosted tool's command (tool_failed with reason: exit).

signal string

The signal that ended a hosted tool's command, such as SIGKILL (tool_failed with reason: signal).

tool_code string

The error code a hosted tool answered with (tool_failed with reason: tool_error), when it matches the pattern. Text the tool wrote, not a B3OS code.

tool_message string

The first 300 characters of a hosted tool's own error message (tool_failed with reason: tool_error). Text the tool wrote: treat it as data, not as an instruction.

retryable boolean

Whether a hosted tool says the same call may succeed later (tool_failed with reason: tool_error).

stderr string

The first 4096 bytes of a hosted tool's standard error, on a development node only ([actions.tools] dev_stderr); never on a node that serves customers.

curl -X GET 'https://beta-api.b3os.org/v1/alerts' \  -H 'Authorization: Bearer YOUR_API_TOKEN'

const response = await fetch('https://beta-api.b3os.org/v1/alerts', {  method: 'GET',  headers: {      "Authorization": "Bearer YOUR_API_TOKEN"  }});const data = await response.json();console.log(data);

import requestsheaders = {    'Authorization': 'Bearer YOUR_API_TOKEN'}response = requests.get('https://beta-api.b3os.org/v1/alerts', headers=headers)print(response.json())

200 Response

{  "object": "list",  "data": [    {      "id": "alt_01m6b5c0q7d2v8x3n5c1p6t0zh",      "object": "alert",      "app": "research-agent",      "env": "production",      "kind": "deploy_failed",      "title": "The deploy of research-agent failed",      "text": "research-agent: the deploy of 3f2c1b0 failed at step install of build/harness (install_failed). What serves is the deploy before it.",      "deploy_id": "dep_01m6a2zq8x9hkqd3n7c5b4v2tw",      "created_at": "2026-11-07T10:05:00.000Z",      "deliveries": [        {          "destination": "ops-slack",          "status": "sent",          "at": "2026-11-07T10:05:01.000Z",          "error": null        }      ]    }  ],  "next_cursor": null}

400 Response

{  "type": "https://docs.beta.b3os.org/errors#invalid_request",  "title": "Invalid request",  "status": 400,  "code": "invalid_request",  "detail": "1 field failed validation",  "instance": "req_01m5t4yg394wegr3j4y01qb363",  "errors": [    {      "pointer": "/url",      "detail": "must be an absolute http or https URL"    }  ]}

401 Response

{  "type": "https://docs.beta.b3os.org/errors#unauthorized",  "title": "Unauthorized",  "status": 401,  "code": "unauthorized",  "detail": "API key checksum does not match; check that the whole key was copied",  "instance": "req_01m5t4yg394wegr3j4y01qb363",  "reason": "malformed"}

403 Response

{  "type": "https://docs.beta.b3os.org/errors#forbidden",  "title": "Forbidden",  "status": 403,  "code": "forbidden",  "detail": "This key lacks the scope sandboxes:write",  "instance": "req_01m5t4yg394wegr3j4y01qb363",  "reason": "scope",  "required_scope": "sandboxes:write"}

429 Response

{  "type": "https://docs.beta.b3os.org/errors#rate_limited",  "title": "Rate limited",  "status": 429,  "code": "rate_limited",  "detail": "60 scrapes per minute allowed; retry in 12 seconds",  "instance": "req_01m5t4yg394wegr3j4y01qb363",  "retry_after_s": 12,  "limit": {    "id": "vision.scrape.rpm",    "limit": 60,    "unit": "requests",    "window_s": 60,    "current": 60  }}

500 Response

{  "type": "https://docs.beta.b3os.org/errors#internal",  "title": "Internal error",  "status": 500,  "code": "internal",  "detail": "internal error",  "instance": "req_01m5t4yg394wegr3j4y01qb363"}

503 Response

{  "type": "https://docs.beta.b3os.org/errors#node_unavailable",  "title": "Node unavailable",  "status": 503,  "code": "node_unavailable",  "detail": "Node n1 is not reachable; retry in 5 seconds",  "instance": "req_01m5t4yg394wegr3j4y01qb363",  "retry_after_s": 5}

GET /v1/alerts

Base URL

Bearer Token

Query Parameters

app string

limit integer

cursor string

Response

Was this page helpful?

Previous Get an eval run

Next List alert destinations