Skip to main content
POST
Create backup action and event for multiple locations without performing actual backup

Authorizations

Authorization
string
header
required

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

Path Parameters

environmentId
string
required

ID of the environment

Required string length: 36
Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
Example:

"95b11417-f18f-457f-8804-68e361f9164f"

walletId
string
required

UUID of the wallet

Required string length: 36
Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
Example:

"95b11417-f18f-457f-8804-68e361f9164f"

Body

application/json

Backup locations request

locations
object[]
required

List of backup locations with their key share configuration

passwordUpdateBatchId
string
Required string length: 36
Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
Example:

"95b11417-f18f-457f-8804-68e361f9164f"

shareSetId
string

Identifier of the share set (WaasWallets row) being activated. SDKs that already receive shareSetId from the ceremony_complete event should echo it back here. Optional for backwards compatibility — when omitted, the active rootUser share set is resolved from walletId.

Required string length: 36
Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
Example:

"95b11417-f18f-457f-8804-68e361f9164f"

Response

Backup action and event created successfully

locationsWithKeyShares
object[]
required

List of backup locations paired with their key share identifiers

message
string
required

Human-readable status message for the backup operation

walletId
string
required
Required string length: 36
Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
Example:

"95b11417-f18f-457f-8804-68e361f9164f"

passwordUpdateStatus
enum<string>

Current status of the password update process

Available options:
activated,
pending
shareSetId
string

Identifier of the share set that was activated by this backup.

Required string length: 36
Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
Example:

"95b11417-f18f-457f-8804-68e361f9164f"

shareSetType
enum<string> | null

Role of the active share set for this wallet, or null if no active wallet exists.

Available options:
delegated,
rootUser,
server,
businessAccountUser
walletActive
boolean

Whether the wallet has an active root-user share set.

Last modified on January 28, 2026