Skip to main content
POST
Remove signers from a signer group, with signatures

Authorizations

x-api-key
string
header
required

Headers

x-idempotency-key
string<uuid>
required

Unique key (UUID) to ensure request idempotency on POST, PUT and PATCH requests.

A key is scoped to your client, the HTTP method and the path, and is remembered for 24 hours after a successful (below 400) response. Repeating the same request (same JSON body, whatever the key order or whitespace) with the same key within that window returns the original response with X-Idempotent-Replayed: true instead of executing the request again. Using the same key on the same endpoint with a different body returns 422 with problem type idempotency-key-reused; the request is not executed. Error responses (4xx and 5xx) are not remembered, so a request refused for a fixable reason can be corrected and retried under the same key. Request bodies that are not JSON (for example file uploads) are not compared.

Path Parameters

signer_group_id
string
required

Signer Group ID KSUID is a 27-character globally unique ID that combines a timestamp with a random component. Used for all entity identifiers in the Dakota platform.

Required string length: 27
Pattern: ^[0-9A-Za-z]{27}$
Example:

"1NFHrqBHb3cTfLVkFSGmHZqdDPi"

Body

application/json

A signed removal of members from a signer group. Policy-engine verifies the signatures against the group's governance (the members of its governing group, governance_signer_group_id, else the group itself; at least effective_governance_threshold distinct members, never counting payment-agent or card-settlement keys) and refuses a removal that would leave the group below a threshold it must keep.

members_to_remove
string[]
required

Public keys of the members to remove, as the group lists them.

Required array length: 1 - 100 elements
signer_group_version
integer<int64>
required

The group's version the signatures were made over.

Required range: x >= 0
Example:

3

signatures
string[]
required

Signatures over the canonical intent, each base64-encoded, in the format the endorsed policy routes use (ES256 ASN.1 DER, or a WebAuthn assertion whose challenge is the canonical intent). The canonical intent is {"group_id":"<id>","idempotency_key":"<X-Idempotency-Key>","members_to_remove":["<public_key>"],"signer_group_version":<version>,"type":"remove_signers_from_group"}, with members_to_remove in the order sent.

Required array length: 1 - 100 elements

Response

Signers removed

Group of signers that dictates who can sign transactions for a wallet

id
string
required

KSUID is a 27-character globally unique ID that combines a timestamp with a random component. Used for all entity identifiers in the Dakota platform.

Required string length: 27
Pattern: ^[0-9A-Za-z]{27}$
Example:

"1NFHrqBHb3cTfLVkFSGmHZqdDPi"

client_id
string
required

KSUID is a 27-character globally unique ID that combines a timestamp with a random component. Used for all entity identifiers in the Dakota platform.

Required string length: 27
Pattern: ^[0-9A-Za-z]{27}$
Example:

"1NFHrqBHb3cTfLVkFSGmHZqdDPi"

name
string
required

The wallet name

Example:

"My Wallet"

members
object[]
required

Members that make up the signer group

removed_members
object[]

Signers previously in this group that have since been removed. Populated only when the request sets include_removed=true; each entry carries its removed_at timestamp. Omitted otherwise.

version
integer<int64>

The group's version. It increases by 1 with every membership or governance change. Endorsements of a membership or governance change sign over it as signer_group_version, so a signature made before a change cannot be replayed after it.

Example:

3

governance_threshold
integer<int32> | null

The explicit number of distinct endorsers a governance change of the group needs, or null for the default.

Example:

2

effective_governance_threshold
integer<int32>

The number of distinct endorsers a governance change of the group needs now: governance_threshold when set, as set; else the default: 2 when the client has governance enforcement on and the governing group (the group itself when it governs itself) has 3 or more members, else 1, capped at the governing group's members that can endorse and never below 1. Keys of payment agents and card settlement signers are members for spending only: they never endorse governance changes.

Example:

2

governance_signer_group_id
string | null

The signer group whose members endorse governance changes of this group instead of its own members, or null when the group governs itself.

Example:

"1NFHrqBHb3cTfLVkFSGmHZqdDPi"