Skip to main content
POST
/
signers
Create a new signer
curl --request POST \
  --url https://api.platform.dakota.xyz/signers \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --header 'x-idempotency-key: <x-idempotency-key>' \
  --data '
{
  "name": "Marc",
  "public_key": "<string>",
  "key_type": "ES256"
}
'
{
  "id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
  "name": "Marc",
  "public_key": "<string>",
  "key_type": "ES256",
  "client_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi"
}

Authorizations

​
x-api-key
string
header
required

Headers

​
x-idempotency-key
string<uuid>
required

Unique key to ensure request idempotency. If the same key is used within a certain time window, the original response will be returned instead of executing the request again.

Body

application/json

Request to create a new signer

​
name
string
required

The signer name

Example:

"Marc"

​
public_key
string
required

The signer public key

​
key_type
enum<string>
required

Type of the key

Available options:
ES256,
WEBAUTHN

Response

Signer created successfully

A signer is a public key that can sign intents and it is part of a signer group

​
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
Example:

"1NFHrqBHb3cTfLVkFSGmHZqdDPi"

​
name
string
required

The signer name

Example:

"Marc"

​
public_key
string
required

The signer public key

​
key_type
enum<string>
required

Type of the key

Available options:
ES256,
WEBAUTHN
​
client_id
string

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
Example:

"1NFHrqBHb3cTfLVkFSGmHZqdDPi"