Approvals

List recurring approval groups

Read-only rollup answering "what keeps coming back?" — groups items by dedup_key and returns those recurring at least min_count times, most-recurrent first. Each group carries the ordered item chain (via previous_item_id) and the resolution reasons in order, so a human can read recurring rejections side by side and graduate the pattern into a guardrail deny. Exact-key grouping only; no cluster state is stored.

get/v1/projects/{project_id}/approvals/recurrences

Request

  • Base URL: https://api.naturali.ai
  • URL: https://api.naturali.ai/v1/projects/{project_id}/approvals/recurrences
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.naturali.ai/authorize, token URL https://api.naturali.ai/token, scopes: mcp:access)

Query parameters

statusstring[]

Lifecycle statuses the groups are built from (default rejected). Repeat the parameter to OR values. A value outside the enum, empty string included, is a 400.

min_countinteger

Minimum items in a group for it to be returned

limitinteger

Results per page, 1 to 100 (default 50). Above 100 it is clamped; below 1 or not an integer it is 400.

offsetinteger

Results to skip. Negative or not an integer it is 400.

Response

List of recurrence groups

totalinteger required
limitinteger required
offsetinteger required

Example response

{
  "data": [
    {
      "chain": [
        {
          "id": "apr_V1StGXR8Z5jdHi6B"
        }
      ]
    }
  ]
}

Changes

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