Suspend Exchange Context (invalidates all dependent grants)

Transitions the Exchange Context to SUSPENDED and publishes an invalidation message on the capability-grant-updates Redis Pub/Sub channel so every Core API replica drops its L1 cache entry for every grant bound to this context.

A body is now REQUIRED and carries a mandatory reason (PRD 231, operation 2). It is recorded verbatim at canonical position 21 of the signed AdminAuditEvent, so an audit row can no longer say that an Exchange Context was suspended without saying why. It is bounded at AuditFieldBounds.MAX_REASON_LENGTH (1,000 UTF-8 BYTES, not characters -- the unit the signed preimage and every carrier downstream of it are measured in) -- the same bound applied before signing, so no accepted value is silently truncated on its way into the preimage -- and it is NEVER written to a log line.

IDEMPOTENT NO-OP: an already-SUSPENDED context answers 200 OK and the submitted reason is recorded NOWHERE -- no status write, no audit event, no admin_audit_log row -- because the act did not happen. That is deliberate, not a lost value: recording it would put a justification for a suspension into the trail on a call that suspended nothing.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required
uuid
required
Body Params

Suspend an ACTIVE Exchange Context. The reason is mandatory and is signed into the audit record at canonical position 21. On an already-SUSPENDED context the call is an idempotent no-op and the reason is recorded nowhere.

string
required
length between 1 and 1000

Operator-supplied justification (free text). Recorded verbatim at canonical position 21 of the signed admin audit event, and never written to a log line.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/problem+json