curl --request PATCH \
--url https://api.platform.dakota.xyz/signer-groups/{signer_group_id}/governance \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--header 'x-idempotency-key: <x-idempotency-key>' \
--data '
{
"governance_threshold": 2,
"signer_group_version": 3,
"signatures": [
"MEUCIQDx...base64",
"MEQCIF1y...base64"
]
}
'const options = {
method: 'PATCH',
headers: {
'x-idempotency-key': '<x-idempotency-key>',
'x-api-key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
governance_threshold: 2,
signer_group_version: 3,
signatures: ['MEUCIQDx...base64', 'MEQCIF1y...base64']
})
};
fetch('https://api.platform.dakota.xyz/signer-groups/{signer_group_id}/governance', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.platform.dakota.xyz/signer-groups/{signer_group_id}/governance"
payload = {
"governance_threshold": 2,
"signer_group_version": 3,
"signatures": ["MEUCIQDx...base64", "MEQCIF1y...base64"]
}
headers = {
"x-idempotency-key": "<x-idempotency-key>",
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.platform.dakota.xyz/signer-groups/{signer_group_id}/governance"
payload := strings.NewReader("{\n \"governance_threshold\": 2,\n \"signer_group_version\": 3,\n \"signatures\": [\n \"MEUCIQDx...base64\",\n \"MEQCIF1y...base64\"\n ]\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("x-idempotency-key", "<x-idempotency-key>")
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
"client_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
"name": "My Wallet",
"members": [
{
"id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
"client_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
"name": "Marc",
"public_key": "string",
"key_type": "ES256"
}
],
"version": 4,
"governance_threshold": 2,
"effective_governance_threshold": 2
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#insufficient-endorsements",
"title": "Insufficient Endorsements",
"status": 403,
"detail": "insufficient endorsements for signer group 2N4YkLb7wQ9xT3mVd8sRk2PzHcA: have 1, need 2",
"instance": "https://api.platform.dakota.xyz/signer-groups/example-id/governance",
"request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6",
"reason": "insufficient_endorsements",
"code": "insufficient_endorsements",
"params": {
"signer_group_id": "2N4YkLb7wQ9xT3mVd8sRk2PzHcA",
"have": "1",
"need": "2"
}
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#stale-signer-group-version",
"title": "Stale Signer Group Version",
"status": 409,
"detail": "The signer group changed since the signatures were made. Read the group's version and sign again.",
"instance": "https://api.platform.dakota.xyz/signer-groups/example-id/governance",
"request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6",
"reason": "stale_signer_group_version",
"code": "stale_signer_group_version"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}Update a signer group's governance
Sets who governs the signer group and how many of them must agree:
governance_threshold and governance_signer_group_id. Always
endorsed by the group’s current governance, which policy-engine
verifies. The group’s version increases by 1.
The body replaces the group’s whole governance state: a field left
out is cleared (no governance_threshold means the default quorum,
no governance_signer_group_id means the group governs itself).
Clearing is endorsed like any other change, because the signed
intent omits exactly the fields the body omits.
curl --request PATCH \
--url https://api.platform.dakota.xyz/signer-groups/{signer_group_id}/governance \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--header 'x-idempotency-key: <x-idempotency-key>' \
--data '
{
"governance_threshold": 2,
"signer_group_version": 3,
"signatures": [
"MEUCIQDx...base64",
"MEQCIF1y...base64"
]
}
'const options = {
method: 'PATCH',
headers: {
'x-idempotency-key': '<x-idempotency-key>',
'x-api-key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
governance_threshold: 2,
signer_group_version: 3,
signatures: ['MEUCIQDx...base64', 'MEQCIF1y...base64']
})
};
fetch('https://api.platform.dakota.xyz/signer-groups/{signer_group_id}/governance', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.platform.dakota.xyz/signer-groups/{signer_group_id}/governance"
payload = {
"governance_threshold": 2,
"signer_group_version": 3,
"signatures": ["MEUCIQDx...base64", "MEQCIF1y...base64"]
}
headers = {
"x-idempotency-key": "<x-idempotency-key>",
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.platform.dakota.xyz/signer-groups/{signer_group_id}/governance"
payload := strings.NewReader("{\n \"governance_threshold\": 2,\n \"signer_group_version\": 3,\n \"signatures\": [\n \"MEUCIQDx...base64\",\n \"MEQCIF1y...base64\"\n ]\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("x-idempotency-key", "<x-idempotency-key>")
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
"client_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
"name": "My Wallet",
"members": [
{
"id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
"client_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
"name": "Marc",
"public_key": "string",
"key_type": "ES256"
}
],
"version": 4,
"governance_threshold": 2,
"effective_governance_threshold": 2
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#insufficient-endorsements",
"title": "Insufficient Endorsements",
"status": 403,
"detail": "insufficient endorsements for signer group 2N4YkLb7wQ9xT3mVd8sRk2PzHcA: have 1, need 2",
"instance": "https://api.platform.dakota.xyz/signer-groups/example-id/governance",
"request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6",
"reason": "insufficient_endorsements",
"code": "insufficient_endorsements",
"params": {
"signer_group_id": "2N4YkLb7wQ9xT3mVd8sRk2PzHcA",
"have": "1",
"need": "2"
}
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#stale-signer-group-version",
"title": "Stale Signer Group Version",
"status": 409,
"detail": "The signer group changed since the signatures were made. Read the group's version and sign again.",
"instance": "https://api.platform.dakota.xyz/signer-groups/example-id/governance",
"request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6",
"reason": "stale_signer_group_version",
"code": "stale_signer_group_version"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}Headers
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
Body
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.
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.
1 - 100 elementsResponse
Governance updated
Group of signers that dictates who can sign transactions for a wallet
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.
2
Was this page helpful?

