Skip to main content
POST
/
internal
/
checkbook
/
client-credentials
Create Checkbook client credentials
curl --request POST \
  --url https://api.platform.dakota.xyz/internal/checkbook/client-credentials \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "client_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
  "publishable_key": "d9cXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "secret_key": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "base_url": "https://api.checkbook.io"
}
'
{
  "id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
  "client_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
  "publishable_key": "d9cXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "base_url": "https://api.checkbook.io",
  "is_active": true,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Authorizations

ā€‹
x-api-key
string
header
required

Body

application/json

Request to create Checkbook client credentials

ā€‹
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
Example:

"1NFHrqBHb3cTfLVkFSGmHZqdDPi"

ā€‹
publishable_key
string
required

Checkbook publishable API key

Example:

"d9cXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

ā€‹
secret_key
string
required

Checkbook secret API key (will be encrypted before storage)

Example:

"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

ā€‹
base_url
string
required

Checkbook API base URL

Example:

"https://api.checkbook.io"

Response

Checkbook client credentials created successfully

Checkbook client credentials for multi-root-user support

ā€‹
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"

ā€‹
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
Example:

"1NFHrqBHb3cTfLVkFSGmHZqdDPi"

ā€‹
publishable_key
string
required

Checkbook publishable API key

Example:

"d9cXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

ā€‹
base_url
string
required

Checkbook API base URL

Example:

"https://api.checkbook.io"

ā€‹
is_active
boolean
required

Whether these credentials are active

Example:

true

ā€‹
created_at
string<date-time>
required

When the credentials were created

ā€‹
updated_at
string<date-time>
required

When the credentials were last updated