NUnullplatform
Checklist

List checklist specifications

Changed on

Lists the checklist specifications visible at an NRN.

get/approval/checklist/specification

Request

  • Base URL
    https://api.nullplatform.com
  • URL
    https://api.nullplatform.com/approval/checklist/specification
  • Auth
    HTTP bearer

Query parameters

nrnstring required

The NRN to list specifications for.

status'active' | 'deleted'

Filter by status.

latest_onlyboolean

Return only the newest version of each specification instead of the whole family.

show_descendantsboolean

Include specifications defined below the given NRN.

name:containsstring

Filter by a substring of the name.

offsetinteger

Number of results to skip.

limitinteger

Maximum number of results to return.

sortstring

Field to sort by.

Response

The operation was successful.

totalinteger

Total number of specifications matching the query.

offsetinteger

Number of results skipped.

limitinteger

Maximum number of results returned.

Example response

{
  "results": [
    {
      "id": "spec_abc123def456ghij",
      "nrn": "organization=1:account=2:namespace=3",
      "name": "staging-deploy-gate",
      "description": "Coverage, Snyk, and security sign-off, with a CAB override.",
      "status": "active",
      "version": 1,
      "definition": {
        "execution_trigger": "automatic_approval"
      },
      "derived_expression": "( coverage_gate.passed AND security_signoff.passed ) OR cab_override.passed",
      "created_by": "4321",
      "created_at": "2026-08-28T14:12:03.000Z",
      "updated_at": "2026-08-28T14:12:03.000Z",
      "warnings": [],
      "associated_actions": [
        {
          "id": 1842,
          "nrn": "organization=1:account=2:namespace=3",
          "entity": "deployment",
          "action": "deployment:create"
        }
      ]
    }
  ],
  "total": 3,
  "limit": 20
}

Changes

  • 728d4df70ca1Revision changes
    • breaking

      the response property became optional for the status

    • breaking

      the response property became optional for the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • info

      media type application/json was changed to a more specific media type application/problem+json for the response status

    • info

      media type application/json was changed to a more specific media type application/problem+json for the response status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      response property message deprecated

    • info

      response property message deprecated

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

  • ac7c8dabaaa7Revision changes
    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the required property /// to the response with the status