Account5

Action36

Action Item12

Action Item Category5

Action Item Comment2

Agent3

Announcements6

API keys5

Application4

Approval6

Artifact7

Asset4

Authentication1

Build4

Catalog instance (multiple keys)3

Catalog instance (single key)4

Catalog specification5

Category2

Channel5

Checklist6

Custom domain5

Deployment4

Deployment group4

Deployment strategy5

Dimension5

Dimension value1

Dimension Value4

Entity hook8

Event3

Inbox rules12

Link12

Log config4

Log specification5

Log template4

Namespace5

NRN5

Organization2

Package10

Parameter11

Personal access tokens5

Policy5

Provider6

Provider Specification5

Query1

Release4

Report versions8

Reports6

Role and grant5

Runtime Configuration5

Scope10

Scope type5

Service15

Suggestion8

Technology template5

User4

Workflow aliases7

Workflow definitions7

Workflow engine1

Workflow executions10

Workflow plugins2

Workflow revisions2

Workflow secrets and variables5

Workflow signals3

Workflow triggers1

Checklist

Publish a new specification version

Changed on Oct 15, 2026

Publishes a new version rather than editing in place. The response is a new specification ID under the same name and NRN, with the version number bumped. Approval actions keep pointing at the version they already reference until you move them.

patch/approval/checklist/specification/{id}

Request

Base URL
https://api.nullplatform.com
URL
https://api.nullplatform.com/approval/checklist/specification/{id}
Auth
HTTP bearer

Path parameters

idstring required

The ID of the version to base the new one on.

Request body

namestring

New name for the specification family.

descriptionstring

New description.

definitionobject

The full definition for the new version.

Example request

{
  "name": "staging-deploy-gate",
  "description": "Coverage raised to 85% after the Q3 review."
}

Response

The new version was published.

idstring

Identifier of this specification version.

nrnstring

Where the specification applies. Child resources inherit it.

namestring

Shared by every version of this specification.

descriptionstring

What this checklist enforces.

status'active' | 'deleted'

Whether the specification is live or was soft-deleted.

versioninteger

Version number within the name and NRN.

derived_expressionstring

The boolean expression nullplatform computes the outcome with.

created_bystring

ID of the user who published this version.

created_atstring date-time

When this version was published.

updated_atstring date-time

When this version was last modified.

warningsstring[]

Non-blocking notes the validator raised when the version was saved.

versionsChecklistSpecification[] circular

associated_actionsobject[]

Approval actions currently pointing at this version. Only on a read of a single specification, and absent rather than empty when it was not resolved.

Example response

{
  "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"
    }
  ]
}

Changes

Oct 15, 2026728d4df70ca1 Revision 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
Oct 2, 2026ac7c8dabaaa7 Revision 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

Operation history (3 revisions)