Skip to main content
POST
Prepare a MicroVault authorization
Validate and simulate an administrative or delegated action, then prepare its exact signing payload.
MicroVaults are in private preview for enabled sandbox organizations on Ethereum Sepolia.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key
string
required

Reuse only when retrying the identical mutation.

Required string length: 1 - 200

Path Parameters

customerRecordId
string<uuid>
required
Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$
Example:

"8f4c52d7-62ab-4db9-a964-92f481f6b851"

Body

application/json
action
enum<string>
required
Available options:
create_vault
parameters
object
required
deadline
integer

Unix timestamp no more than seven days in the future.

nonce
string

Unsigned base-10 integer string. Asset and share amounts use token base units.

Pattern: ^(0|[1-9][0-9]*)$
Example:

"1000000"

supersedesIntentId
string
Required string length: 1 - 64

Response

Existing authorization returned for an identical replay.

id
string<uuid>
required
Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$
Example:

"8f4c52d7-62ab-4db9-a964-92f481f6b851"

status
string
required
signingPayload
object
required
signingPayloadHash
string
required
Pattern: ^0x[0-9a-fA-F]{64}$
Example:

"0x1111111111111111111111111111111111111111111111111111111111111111"

summary
object
required
predictedEffects
object[]
required
simulation
object
required
turnkeyActivityId
string | null
turnkeyStatus
string | null
directTransaction
object
Example: