Skip to main content
PATCH
Update a signer group's governance

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

The group's complete governance settings, endorsed by its current governance. A field left out clears that setting: no governance_threshold means the default quorum, and no governance_signer_group_id means the group governs itself.

signer_group_version
integer<int64>
required

The group's version the signatures were made over.

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). Policy-engine verifies them against the signer group's governance: the members of its governing group (governance_signer_group_id, else the group itself), at least effective_governance_threshold distinct members. Payment-agent and card-settlement keys never count: a signature by one of them is refused. The canonical intent is {"governance_signer_group_id":"<id>","governance_threshold":<n>,"idempotency_key":"<X-Idempotency-Key>","signer_group_id":"<id>","signer_group_version":<version>,"type":"update_signer_group_governance"}, with each optional field absent when it is not sent.

Required array length: 1 - 100 elements
governance_threshold
integer<int32>

The number of distinct endorsers a governance change of the group needs.

Required range: x >= 1
Example:

2

governance_signer_group_id
string

Another signer group of the same client whose members endorse governance changes of this group.

Example:

"1NFHrqBHb3cTfLVkFSGmHZqdDPi"

Response

Governance updated

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"