curl --request POST \
--url https://api.platform.dakota.xyz/signer-groups/{signer_group_id}/signer-removals \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--header 'x-idempotency-key: <x-idempotency-key>' \
--data '
{
"members_to_remove": [
"MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE..."
],
"signer_group_version": 3,
"signatures": [
"MEUCIQDx...base64"
]
}
'const options = {
method: 'POST',
headers: {
'x-idempotency-key': '<x-idempotency-key>',
'x-api-key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
members_to_remove: ['MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE...'],
signer_group_version: 3,
signatures: ['MEUCIQDx...base64']
})
};
fetch('https://api.platform.dakota.xyz/signer-groups/{signer_group_id}/signer-removals', 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}/signer-removals"
payload = {
"members_to_remove": ["MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE..."],
"signer_group_version": 3,
"signatures": ["MEUCIQDx...base64"]
}
headers = {
"x-idempotency-key": "<x-idempotency-key>",
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(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}/signer-removals"
payload := strings.NewReader("{\n \"members_to_remove\": [\n \"MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE...\"\n ],\n \"signer_group_version\": 3,\n \"signatures\": [\n \"MEUCIQDx...base64\"\n ]\n}")
req, _ := http.NewRequest("POST", 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,
"effective_governance_threshold": 1
}{
"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/signer-removals",
"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/signer-removals",
"request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6",
"reason": "stale_signer_group_version",
"code": "stale_signer_group_version"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#below-threshold",
"title": "Below Threshold",
"status": 422,
"detail": "The removal would leave the group below a threshold it must keep.",
"instance": "https://api.platform.dakota.xyz/signer-groups/example-id/signer-removals",
"request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6",
"reason": "below_threshold",
"code": "below_threshold"
}{
"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"
}Remove signers from a signer group, with signatures
Removes members from the signer group with signatures from the group’s
governance, which policy-engine verifies before anything changes. The
group’s version increases by 1.
This is the signed counterpart of
DELETE /signer-groups/{signer_group_id}/signers/{signer_id}. A client
under governance enforcement, or a group with governance settings, can
remove members only this way. An operate API key of a client under
governance enforcement may call it, since the signatures carry the
authority.
curl --request POST \
--url https://api.platform.dakota.xyz/signer-groups/{signer_group_id}/signer-removals \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--header 'x-idempotency-key: <x-idempotency-key>' \
--data '
{
"members_to_remove": [
"MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE..."
],
"signer_group_version": 3,
"signatures": [
"MEUCIQDx...base64"
]
}
'const options = {
method: 'POST',
headers: {
'x-idempotency-key': '<x-idempotency-key>',
'x-api-key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
members_to_remove: ['MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE...'],
signer_group_version: 3,
signatures: ['MEUCIQDx...base64']
})
};
fetch('https://api.platform.dakota.xyz/signer-groups/{signer_group_id}/signer-removals', 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}/signer-removals"
payload = {
"members_to_remove": ["MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE..."],
"signer_group_version": 3,
"signatures": ["MEUCIQDx...base64"]
}
headers = {
"x-idempotency-key": "<x-idempotency-key>",
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(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}/signer-removals"
payload := strings.NewReader("{\n \"members_to_remove\": [\n \"MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE...\"\n ],\n \"signer_group_version\": 3,\n \"signatures\": [\n \"MEUCIQDx...base64\"\n ]\n}")
req, _ := http.NewRequest("POST", 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,
"effective_governance_threshold": 1
}{
"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/signer-removals",
"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/signer-removals",
"request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6",
"reason": "stale_signer_group_version",
"code": "stale_signer_group_version"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#below-threshold",
"title": "Below Threshold",
"status": 422,
"detail": "The removal would leave the group below a threshold it must keep.",
"instance": "https://api.platform.dakota.xyz/signer-groups/example-id/signer-removals",
"request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6",
"reason": "below_threshold",
"code": "below_threshold"
}{
"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
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.
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.
1 - 100 elementsResponse
Signers removed
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?

