Skip to main content
POST
Bulk-assign accounts to a custody account group

Authorizations

Authorization
string
header
required

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

Path Parameters

groupId
string<uuid>
required

Identifier of the custody account group.

Example:

"9c0f1c0d-6c61-4f3d-9b8a-1a3a4b3c5d6e"

Body

application/json
accountIds
integer[]
required

Accounts to assign to this group. Each account must belong to the caller's entity. Accounts already assigned to another group are reassigned atomically; rebinding an account that already belongs to this group is a no-op.

Required array length: 1 - 100 elements
Example:

Response

Successfully assigned accounts to the group.

data
object

A customer-defined grouping of custody accounts owned by a single entity. Each account can belong to at most one group at a time. The approximateBalanceInUsd and accountsPreview fields are aggregate views populated by the list-groups endpoint. The single-group detail endpoint returns the metadata-only view and omits both fields.