PUT
cURL
Roles: app, investor. An investor reaches only its own holder’s records.

Authorizations

Authorization
string
header
required

A JWT from the deployment's identity provider, whose roles claim names the caller's roles and whose holder claim names an investor's holder.

Headers

Idempotency-Key
string

Names this write, so a retry answers the same operation; absent, the write is keyed on its body.

X-Signature-Key
string

A signed request's key id, as venue.api.signing.clients configures it for the bearer's subject.

X-Signature-Timestamp
string

Seconds since the epoch, within venue.api.signing.window of the engine's clock, 5 minutes by default.

Pattern: ^[0-9]+$
X-Signature-Nonce
string

At least 16 random bytes in base64url, never reused within twice the window.

Required string length: 22 - 128
Pattern: ^[A-Za-z0-9_-]+={0,2}$
X-Signature
string

The base64 HMAC-SHA256, under the key's secret, of the method, the path and query, the timestamp, the nonce and the body's SHA-256.

X-Request-Id
string

Your id for this request, 1 to 128 printable characters, repeated in the answer; absent, the engine makes one.

Maximum string length: 128
Pattern: ^[\x21-\x7E]+$
traceparent
string

A W3C trace context, which the engine joins and passes on.

Pattern: ^[0-9a-f]{2}-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$

Path Parameters

holderId
string
required

The holder's id.

tenantId
string
required

The tenant's id: a distributor the deployment configures.

Body

application/json

The version of the terms accepted.

version
string
required

The version of the tenant's terms the holder was shown and accepts.

Response

The same write again, with the same key and body; the operation it already is.

What every write answers: an operation, or an action awaiting approval, told apart by state.

state
required

Where the write stands: an operation's state, or awaiting for an action awaiting its approvers.

Available options:
queued,
running,
succeeded,
failed
operationId
string

The operation's id.

kind
enum<string>

What the operation does.

Available options:
instrument.record,
policy.set,
admission-consent.propose,
instrument.pause,
holder.register,
holder.onboard,
holder.close,
holder.register-successor,
holder.set-attributes,
admission.offer,
admission.withdraw,
accepted-terms.accept,
subscription.claim,
subscription.withdraw,
subscription.deliver,
subscription.settle,
subscription.release,
primary-market.propose,
redemption.claim,
redemption.withdraw,
redemption.release,
redemption.settle,
dealing-cycle.open,
dealing-cycle.settle,
dealing-cycle.release,
standing-settlement.open,
standing-settlement.settle,
standing-settlement.pause,
standing-settlement.resume,
standing-settlement.close,
reserve.propose,
reserve.close,
lock-agreement.propose,
lock-agreement.release,
mint.start,
mint.cancel,
reserve-redemption.start,
reserve-redemption.cancel,
reserve-report.create,
amendment.propose,
amendment.withdraw,
provision-settlement.propose,
distribution.execute,
distribution.roll,
standing-approval.grant,
standing-approval.revoke,
holder.restrict,
holder.restrict-batch,
restriction.lift,
issuer-powers-agreement.propose,
issuer-powers-consent.offer,
holder.force-transfer,
holder.recover,
instrument.force-transfer,
instrument.recover,
hold.release,
external-account.map,
webhook.register,
webhook.remove,
webhook.test
resource
object

The record it acts on, and, once it succeeds, the record it created or changed.

request
any | null

The body the operation was opened with, beside the ids its path named.

result
any | null

What the operation came to, once succeeded; null otherwise.

problem
any | null

The problem the operation failed with; null otherwise.

actor
string

Who asked, by sub.

actorName
string | null

The name claim of the bearer that asked; null where it carried none, and for an operation the engine opened itself.

actorEmail
string | null

The email claim of the bearer that asked; null where it carried none, and for an operation the engine opened itself.

role
enum<string> | null

The role the operation ran under; null for an operation the engine opened itself, whose actor names it.

Available options:
operator,
approver,
risk,
compliance,
auditor,
investor,
app,
monitor,
feed,
registrar
createdAt
string

When the operation was opened.

startedAt
string | null

When the operation started running; null while queued.

finishedAt
string | null

When the operation finished; null until it does.

updateId
string | null

The ledger update the operation committed; null until it commits.

offset
integer<int64> | null

The offset the operation's transaction committed at; null until it commits.

actionKey
string

The four-eyes action's key.

maker
string

Who made the action, by sub.

makerRole
enum<string>

The role the maker acted in.

Available options:
operator,
approver,
risk,
compliance,
auditor,
investor,
app,
monitor,
feed,
registrar
madeAt
string

When the maker made the action.

required
integer<int32>

How many distinct approvers the action needs.

signedBy
string[]

The approvers who have signed it so far.

recovery
string

What completes the action awaiting approval.