Skip to main content
POST
Request the regulatory cancellation of an operation

Authorizations

Authorization
string
header
required

JWT bearer token issued by the identity provider.

Headers

X-Idempotency
string

Idempotency key for safe retries; a replay returns the stored response.

X-Request-Id
string

Optional client request id echoed back in meta.requestId.

Path Parameters

operationId
string
required

Id (UUID) of the operation to cancel.

Example:

"018f8a3e-4b2c-7c1a-9e5d-2f6a1b3c4d5e"

Body

application/json
reasonCategory
enum<string>
required

Numeric MotvCanc cancellation reason (OP107 §11.3.16): '1'..'4'.

Available options:
1,
2,
3,
4
Example:

"4"

externalId
string

Optional client-side reference for the new CANCELLATION operation. When present it must not be used by any other operation (409 DUPLICATE_EXTERNAL_ID).

Maximum string length: 255
Example:

"canc-2026-06-0001"

Response

Accepted

externalId
string
required

Echoed client-side external identifier.

Example:

"acq-ext-2026-06-0001"

id
string
required

Created operation id (UUID).

Example:

"018f8a3e-4b2c-7c1a-9e5d-2f6a1b3c4d5e"

meta
object
required

Response envelope metadata (requestId + timestamp).

state
string
required

Initial lifecycle state of the created operation.

Example:

"CREATED"