Remove a signer from a signer group

curl --request DELETE \
  --url https://api.platform.dakota.xyz/signer-groups/{signer_group_id}/signers/{signer_id} \
  --header 'x-api-key: <api-key>' \
  --header 'x-idempotency-key: <x-idempotency-key>'

const options = {
  method: 'DELETE',
  headers: {'x-idempotency-key': '<x-idempotency-key>', 'x-api-key': '<api-key>'}
};

fetch('https://api.platform.dakota.xyz/signer-groups/{signer_group_id}/signers/{signer_id}', 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}/signers/{signer_id}"

headers = {
    "x-idempotency-key": "<x-idempotency-key>",
    "x-api-key": "<api-key>"
}

response = requests.delete(url, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.platform.dakota.xyz/signer-groups/{signer_group_id}/signers/{signer_id}"

	req, _ := http.NewRequest("DELETE", url, nil)

	req.Header.Add("x-idempotency-key", "<x-idempotency-key>")
	req.Header.Add("x-api-key", "<api-key>")

	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"
    }
  ]
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#invalid-request",
  "title": "Bad request - invalid input data",
  "status": 400,
  "detail": "Bad request - invalid input data",
  "instance": "https://api.platform.dakota.xyz/signer-groups/example-id/signers/example-id",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#authentication-error",
  "title": "Unauthorized",
  "status": 401,
  "detail": "Unauthorized",
  "instance": "https://api.platform.dakota.xyz/signer-groups/example-id/signers/example-id",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#forbidden",
  "title": "Forbidden",
  "status": 403,
  "detail": "Forbidden",
  "instance": "https://api.platform.dakota.xyz/signer-groups/example-id/signers/example-id",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#not-found",
  "title": "Signer Group not found",
  "status": 404,
  "detail": "Signer Group not found",
  "instance": "https://api.platform.dakota.xyz/signer-groups/example-id/signers/example-id",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#conflict",
  "title": "Conflict - duplicate request detected",
  "status": 409,
  "detail": "Conflict - duplicate request detected",
  "instance": "https://api.platform.dakota.xyz/signer-groups/example-id/signers/example-id",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#internal-error",
  "title": "Internal server error",
  "status": 500,
  "detail": "Internal server error",
  "instance": "https://api.platform.dakota.xyz/signer-groups/example-id/signers/example-id",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#service-unavailable",
  "title": "Service unavailable",
  "status": 503,
  "detail": "Service unavailable",
  "instance": "https://api.platform.dakota.xyz/signer-groups/example-id/signers/example-id",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

DELETE

signer-groups

{signer_group_id}

signers

{signer_id}

Remove a signer from a signer group

curl --request DELETE \
  --url https://api.platform.dakota.xyz/signer-groups/{signer_group_id}/signers/{signer_id} \
  --header 'x-api-key: <api-key>' \
  --header 'x-idempotency-key: <x-idempotency-key>'

const options = {
  method: 'DELETE',
  headers: {'x-idempotency-key': '<x-idempotency-key>', 'x-api-key': '<api-key>'}
};

fetch('https://api.platform.dakota.xyz/signer-groups/{signer_group_id}/signers/{signer_id}', 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}/signers/{signer_id}"

headers = {
    "x-idempotency-key": "<x-idempotency-key>",
    "x-api-key": "<api-key>"
}

response = requests.delete(url, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.platform.dakota.xyz/signer-groups/{signer_group_id}/signers/{signer_id}"

	req, _ := http.NewRequest("DELETE", url, nil)

	req.Header.Add("x-idempotency-key", "<x-idempotency-key>")
	req.Header.Add("x-api-key", "<api-key>")

	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"
    }
  ]
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#invalid-request",
  "title": "Bad request - invalid input data",
  "status": 400,
  "detail": "Bad request - invalid input data",
  "instance": "https://api.platform.dakota.xyz/signer-groups/example-id/signers/example-id",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#authentication-error",
  "title": "Unauthorized",
  "status": 401,
  "detail": "Unauthorized",
  "instance": "https://api.platform.dakota.xyz/signer-groups/example-id/signers/example-id",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#forbidden",
  "title": "Forbidden",
  "status": 403,
  "detail": "Forbidden",
  "instance": "https://api.platform.dakota.xyz/signer-groups/example-id/signers/example-id",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#not-found",
  "title": "Signer Group not found",
  "status": 404,
  "detail": "Signer Group not found",
  "instance": "https://api.platform.dakota.xyz/signer-groups/example-id/signers/example-id",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#conflict",
  "title": "Conflict - duplicate request detected",
  "status": 409,
  "detail": "Conflict - duplicate request detected",
  "instance": "https://api.platform.dakota.xyz/signer-groups/example-id/signers/example-id",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#internal-error",
  "title": "Internal server error",
  "status": 500,
  "detail": "Internal server error",
  "instance": "https://api.platform.dakota.xyz/signer-groups/example-id/signers/example-id",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#service-unavailable",
  "title": "Service unavailable",
  "status": 503,
  "detail": "Service unavailable",
  "instance": "https://api.platform.dakota.xyz/signer-groups/example-id/signers/example-id",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

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"

signer_id

string

required

KSUID signer_id of the signer to remove. Note this is the KSUID, not the public key (the standalone DELETE /signers/{public_key} endpoint takes the public key instead). 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"

Response

Signer removed successfully

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

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

Show child attributes

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.

Show child attributes

API documentation

Customers

Wallets

Transactions

Recipients

Accounts

Auto Transactions

Onboarding

Policies

Signer Groups

Authentication

Users

Webhooks

Events

Info

Sandbox

Self Serve

Cards

RD Marketing Fee

Agentic Payments

Mandates

Legal

Insights

Account Verifications

Payouts

Remove a signer from a signer group

Authorizations

Headers

Path Parameters

Response