COcomposal
organizations

Page the organization's ops signals (docs/ops-signals.md §6)

Cursor-paged signal feed, delegating to Signals::Query — the same read service the MCP tools use, so REST and agents never diverge. The cursor is the signal's monotonic id carried as its public id (sig_…): asc (default) pages forward with after_id (exclusive), desc pages newest-first with before_id (after_id is accepted as an alias for the desc boundary so a caller can flip order alone). In both directions next_cursor is the last returned signal's public id, fed straight back as the same-named boundary param. {organization_id} is the organization's public id (org_…) or its slug.

get/api/v1/organizations/{organization_id}/signals

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
  • Auth
    HTTP bearer

Path parameters

organization_idstring required

Query parameters

after_idstring

Exclusive cursor (sig_…). Ascending: return signals newer than it. Descending: alias for before_id.

before_idstring

Exclusive cursor (sig_…) for order=desc — return signals older than it.

order'asc' | 'desc'

Scan direction over the id cursor. Defaults to asc (oldest-first).

limitinteger

Signals per page (default 50, capped at 100).

kindstring

Exact kind filter from the frozen taxonomy (§1); a single kind or a comma-separated list.

severitystring

Exact severity filter; a single level or a comma-separated list.

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

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

Severity floor — this level and everything more severe (§2).

hosted_app_idstring

Hosted app filter; accepts an app_… public id, a raw id, or the app slug.

sincestring

ISO8601 lower bound on occurred_at.

unackedboolean

When true, return only signals with no acked_at.

sourcestring

Signal source provider filter (docs §6e) — a single provider or a comma-separated list. An unrecognized provider is a 422 rather than an empty page.

integration_idstring

Narrow to one signal integration. Accepts the integration's raw id, and its sint_… public id once the integration model ships.

subscription_idstring

Resume a subscription (sub_…): its stored filters supply the defaults for any filter left blank, and its last_acked_signal_id becomes the default ascending after_id.

Response

A page of signals, ordered by the id cursor.

next_cursorstring nullable required

The last returned signal's public id when more pages exist, else null. Feed it back as the same boundary param the request used.

has_moreboolean required

Changes

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