Production Review

Record a review decision

Appends needs_changes or approved; the latest decision is the state. Session authentication only in v1: API-key principals receive 403.

post/api/v1/production-review/submissions/{submissionRef}/decisions

Request

  • Base URL: https://numonic.ai
  • URL: https://numonic.ai/api/v1/production-review/submissions/{submissionRef}/decisions
  • Auth: API key in header x-api-key

Path parameters

submissionRefstring required

URL-encoded submission reference native:<40-hex> (EntityRef wire form)

Example:native%3Aa1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2

Headers

Idempotency-Keystring required

Client-generated key (e.g. a UUID). Replaying the same key returns the original result; reusing it with a different payload is 409.

Example:6f1c2d4e-8a1b-4c3d-9e2f-0a1b2c3d4e5f

Request body

outcome'needs_changes' | 'approved' required

Response

The submission after the decision

refstring required
projectRefstring required
workItemRefstring
titlestring required
state'pending' | 'needs_changes' | 'approved' required
submittedAtstring required
supersedesstring

Example response

{
  "ref": "native:a1b2…"
}

Changes

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