Merkl Developer Portal logo
post

/v4/developer/keys/

Create a new API key. The raw key is returned only once. The first call of a new wallet creates its workspace before it answers. It returns 409 only if that creation fails: retry after a few seconds. A key whose workspace has no API policy gets the default tier 999 (Free, 10 req/s), the lowest tier.

Request body

descriptionstring
required

Responses

200
Response for status 200
Schema
object
idstring
required
prefixstring
required
descriptionstring
required
revokedAtstring | null
required
createdAtstring
required
ISO 8601 creation timestamp
tiernumber
required
Key tier level
rawKeystring
required
The raw API key — only returned once at creation
Example
{
  "id": "string",
  "prefix": "string",
  "description": "string",
  "revokedAt": "string",
  "createdAt": "string",
  "tier": 0,
  "rawKey": "string"
}