SEsenso
Gaps

List gaps

Returns a page of your organization's gap queue, the same queue the Senso app shows as the Gap Report. With no statuses filter only open, reopened and addressed gaps are returned, so an API search gap seen only once (weak) does not appear until you ask for it with statuses=weak.

Repeatable filters are sent as repeated query parameters (?statuses=weak&statuses=open). Values within one filter are ORed; different filters are ANDed.

get/org/gaps

Request

  • Base URL
    https://apiv2.senso.ai/api/v1
  • Auth
    API key in header X-API-Key

Query parameters

statusesGapStatus[]

Restrict to these statuses. Defaults to open, reopened and addressed when omitted.

problemsGapProblem[]

Restrict to these problems. An unrecognized value is rejected with 400.

surfacesGapSurface[]

Restrict to gaps seen on any of these surfaces.

origin_kindsGapOriginKind[]

Restrict to gaps with any of these origins. Use api_unanswered_question for searches through the org API, the MCP server or the CLI that found nothing.

kindsGapKind[]

Restrict to these kinds.

tag_idsstring[]

Restrict to gaps carrying any of these tags. Values that are not UUIDs are ignored.

searchstring

Case-insensitive substring match on the gap text (claim_text).

sort'severity' | 'recent' | 'demand'

severity (the default) puts conflicts above missing context, then wider spread, then recency. recent orders by last_seen_at, newest first. demand orders by asker_count, then occurrence_count, then recency.

limitinteger

Page size, 1–100 (default 50). A value outside that range is treated as 50.

offsetinteger

Number of gaps to skip.

Response

A page of the gap queue.

totalinteger required

Gaps matching the filters, across all pages.

limitinteger required
offsetinteger required

Changes

No recorded changes to this operation across all 1 revision of this API.