COcomposal
organizations

Bulk-ack signals (docs §6b)

Two mutually exclusive shapes. Explicit ids acks exactly those and ignores every other key. Otherwise the request must be explicitly scoped — before_id, at least one filter, recovered_only, or an opt-in all: true — so a request the server did not understand can never silently ack the whole organization.

post/api/v1/organizations/{organization_id}/signals/ack

Request

  • Base URL
    https://composal.com (the document declares no server; this is the origin it was published from)
  • URL
    https://composal.com/api/v1/organizations/{organization_id}/signals/ack
  • Auth
    HTTP bearer

Path parameters

organization_idstring required

Request body

idsstring[]

Explicit sig_… ids. When present every other key is ignored.

before_idstring

Inclusive upper bound (sig_…) — ack matching signals at or before it.

kindstring

Single kind or comma-separated list.

severitystring

Single severity or comma-separated list.

min_severity'info' | 'warning' | 'error' | 'critical'

Severity levels (docs §2, reusing AlertRule::SEVERITIES).

hosted_app_idstring
sourcestring

Single source provider or comma-separated list (docs §6e). Alone it satisfies the "explicitly scoped" guard.

integration_idstring

One signal integration — raw id, or sint_… once that model ships.

sincestring
allboolean

Opt in to an otherwise-unconstrained ack of every unacked signal.

recovered_onlyboolean

Narrow to signals whose resolution.resolved is true. Composes with every other filter and alone satisfies the "explicitly scoped" guard.

Response

The number of signals newly acked.

acked_countinteger required

Changes

No recorded changes to this operation across all 3 revisions of this API.