Deny a parked emission

Terminalizes a PENDING_APPROVAL emission: a single distinct authorized actor denying flips it to FAILED with the reason recorded — one deny kills it (a denial is not subject to quorum). A FAILED emission is never claimed by the outbox dispatcher, so it never liquidates.

POST /v1/str/emission-approvals/{id}/deny

Deny a parked emission

cURL

curl --request POST \
  --url https://spb.sandbox.lerian.net/v1/str/emission-approvals/{id}/deny \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency: <x-idempotency>' \
  --data '
{
  "reason": "out of policy"
}
'

200

{
  "correlationId": "req-7a3f9c2e",
  "id": "6f2c...",
  "quorumReached": true,
  "status": "SUBMITTED"
}

Authorizations

Authorization · string · header · required

JWT bearer token issued by the identity provider.

Headers

X-Idempotency · string · required

Idempotency key. Required on every mutation.

X-TTL · string

Idempotency key TTL in seconds.

Path Parameters

id · string · required

Outbound message id of the parked emission to deny.

Body

application/json

reason · string

Optional denial rationale recorded on the failed emission. Defaults to "approval denied".

Example:

"out of policy"

Response

200

application/json

OK

correlationId · string · required

Request-scoped correlation identifier echoing X-Request-ID.

Example:

"req-7a3f9c2e"

id · string · required

Outbound message id the action was applied to.

Example:

"6f2c..."

quorumReached · boolean · required

True when this signature met the required quorum and flipped the emission to SUBMITTED (approve only).

Example:

true

status · string · required

Post-action message status (SUBMITTED on quorum, PENDING_APPROVAL while awaiting more signers, FAILED on deny).

Example:

"SUBMITTED"