Skip to content

Check a saved operation handle without resending its body or performing a write.

GET
/api/workspace/entity-mutation-outcomes
curl --request GET \
--url 'https://example.com/api/workspace/entity-mutation-outcomes?Operation=0&OperationKey=2489E9AD-2EE2-8E00-8EC9-32D5F69181C0' \
--header 'Authorization: Bearer <token>'

NoConfirmedReceipt is not NotApplied, Failed or Pending and never authorizes a retry. ConfirmedCommitted confirms the operation in its scope, not equality to an arbitrary payload. A null Result hides all identities after current access loss, deletion or unreadable stored data. Returned versions belong to the original operation: read the record separately before editing. The seven-day retention is unchanged. Check failures do not establish the original mutation’s outcome.

Operation
required

The operation whose own receipt is being read. Unknown values are invalid selectors.

integer format: int32
Allowed values: 0 1 2 3 4 5

Required operation kind (0–5); never inferred from other parameters.

OperationKey
required
string format: uuid

Required nonempty operation UUID, normalized exactly as on the mutation surface.

EntityDefinitionId
string
0 <= 128 characters

Stable definition ID; required for single operations and forbidden for Composite.

EntityInstanceId
string
0 <= 128 characters

Record ID; required for Update/Archive/Restore/Delete and forbidden for Create/Composite.

access_token
string

Optional access token for clients that cannot set Authorization headers. Prefer Authorization: Bearer <token> when possible.

OK

Media typeapplication/json
object
Data
Any of:

Read confirmation, never an idempotent replay. NoConfirmedReceipt has null Receipt and Result. ConfirmedCommitted has Receipt and a nullable, all-or-nothing current-authorized Result. Unknown SchemaVersion or State must not be treated as confirmation or authorize any write.

object
SchemaVersion
required
integer
Allowed values: 1
State
required

Confirmation at the read snapshot, never permission to retry a write. Unknown values do not settle the outcome. A failure of the check is a request error, not NoConfirmedReceipt.

integer format: int32
Allowed values: 0 1
Receipt
required
Any of:

Server-journalled UTC timestamps, not an exact physical COMMIT timestamp or a retry deadline.

object
CommittedAt
required

Original server receipt timestamp in UTC.

string format: date-time
ExpiresAt
required

Original seven-day receipt expiry in UTC.

string format: date-time
Result
required
Any of:
One of: discriminator: Kind

One visible record with the original mutation’s version, which may no longer be current.

object
EntityDefinitionId
required

Stable definition ID.

string
EntityInstanceId
required

Record ID.

string
RowVersion
required

Original mutation’s version, where one exists.

string format: uuid
nullable
Kind
required
string
Allowed values: Single
Errors
Array<object>
nullable
object
Code
required
string
nullable
Message
required
string
nullable
Target
string
nullable
Field
string
nullable
Metadata
object
key
additional properties
string
nullable
Type
integer format: int32
Allowed values: 0 1 2
Severity
integer format: int32
Allowed values: 0 1 2
Warnings
Array<object>
nullable
object
Code
required
string
nullable
Message
required
string
nullable
Target
string
nullable
Field
string
nullable
Metadata
object
key
additional properties
string
nullable
Type
integer format: int32
Allowed values: 0 1 2
Severity
integer format: int32
Allowed values: 0 1 2
Success
boolean
Example
{
"Data": null,
"Errors": [
{
"Type": 0,
"Severity": 0
}
],
"Warnings": [
{
"Type": 0,
"Severity": 0
}
]
}

Bad Request

Media typeapplication/json
object
Data
Any of:

Read confirmation, never an idempotent replay. NoConfirmedReceipt has null Receipt and Result. ConfirmedCommitted has Receipt and a nullable, all-or-nothing current-authorized Result. Unknown SchemaVersion or State must not be treated as confirmation or authorize any write.

object
SchemaVersion
required
integer
Allowed values: 1
State
required

Confirmation at the read snapshot, never permission to retry a write. Unknown values do not settle the outcome. A failure of the check is a request error, not NoConfirmedReceipt.

integer format: int32
Allowed values: 0 1
Receipt
required
Any of:

Server-journalled UTC timestamps, not an exact physical COMMIT timestamp or a retry deadline.

object
CommittedAt
required

Original server receipt timestamp in UTC.

string format: date-time
ExpiresAt
required

Original seven-day receipt expiry in UTC.

string format: date-time
Result
required
Any of:
One of: discriminator: Kind

One visible record with the original mutation’s version, which may no longer be current.

object
EntityDefinitionId
required

Stable definition ID.

string
EntityInstanceId
required

Record ID.

string
RowVersion
required

Original mutation’s version, where one exists.

string format: uuid
nullable
Kind
required
string
Allowed values: Single
Errors
Array<object>
nullable
object
Code
required
string
nullable
Message
required
string
nullable
Target
string
nullable
Field
string
nullable
Metadata
object
key
additional properties
string
nullable
Type
integer format: int32
Allowed values: 0 1 2
Severity
integer format: int32
Allowed values: 0 1 2
Warnings
Array<object>
nullable
object
Code
required
string
nullable
Message
required
string
nullable
Target
string
nullable
Field
string
nullable
Metadata
object
key
additional properties
string
nullable
Type
integer format: int32
Allowed values: 0 1 2
Severity
integer format: int32
Allowed values: 0 1 2
Success
boolean
Example
{
"Data": null,
"Errors": [
{
"Type": 0,
"Severity": 0
}
],
"Warnings": [
{
"Type": 0,
"Severity": 0
}
]
}

Unauthorized

Media typeapplication/json
object
type
string
nullable
title
string
nullable
status
integer format: int32
nullable
detail
string
nullable
instance
string
nullable
key
additional properties
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example"
}

Forbidden

Media typeapplication/json
object
type
string
nullable
title
string
nullable
status
integer format: int32
nullable
detail
string
nullable
instance
string
nullable
key
additional properties
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example"
}