Rensei docs
API ReferenceFailure Signatures

Get a failure signature by id (org + system tier visibility).

Get a failure signature by id (org + system tier visibility). - Rensei REST API operation reference.

GET
/api/failure-signatures/{id}

Authorization

headerAuthorizationBearer <WorkOS user access token>

WorkOS user access token created by the Rensei CLI. The authenticated organization is resolved from membership and may be narrowed with X-Rensei-Org.

Path Parameters

id*string

The failure_signatures row id.

Length1 <= length

Response Body

The failure signature.

application/json
  1. response
signature*
Example Request
curl -X GET 'https://app.rensei.ai/api/failure-signatures/string'
Example Response
{  "signature": {    "id": "string",    "organizationId": "string",    "signatureKey": "string",    "entryKind": "remedy",    "matcher": {      "ciConclusion": "success",      "mergeable": "MERGEABLE",      "runCount": {        "op": "eq",        "value": 0      },      "logTailPattern": "string",      "launchOutcomeReason": "launch_rejected",      "harness": "string",      "defectClass": "string",      "stage": "seat",      "terminalReasonPattern": "string"    },    "remedyVerb": "rebase_main",    "blastRadiusClass": "read_only",    "tier": "observed",    "attemptsCap": -9007199254740991,    "provenance": {      "sourceIssue": "string",      "decisionRef": "string",      "confirmedSessions": []    },    "createdAt": "string",    "updatedAt": "string"  }}

Create an org-scoped failure signature (always tier='observed'). Requires the org admin role.

Creates a signature owned by the caller's org. Requires org admin (a plain `member` or the read-only `auditor` role is refused 403). The route forces tier='observed' - any other tier in the body is refused 422 tier_not_allowed. A never-auto blast_radius_class under tier='auto' is refused 422 never_auto_class (defense in depth; unreachable via this route since tier is forced). A duplicate (organization_id, signature_key) is refused 409 duplicate_key.

List incidents for the authenticated org.

Returns incidents scoped to the authenticated org, filterable by status (comma-separated), severity, or source, with limit/offset pagination. Bearer-reachable for human principals (user token or browser session); rsk_* API keys and BYOA OAuth-agent tokens are rejected 403.