Skip to main content
POST
https://api.unitedmarket.ai
/
me
/
api-keys
/
{id}
/
rotate
Rotate an API key
curl --request POST \
  --url https://api.unitedmarket.ai/me/api-keys/{id}/rotate \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "name": "trading-bot",
  "prefix": "umk_live_AbC123",
  "lastUsedAt": "2023-11-07T05:31:56Z",
  "revokedAt": "2023-11-07T05:31:56Z",
  "createdAt": "2023-11-07T05:31:56Z",
  "key": "umk_live_xxxxxxxxxxxxxxxxxxxxxxxx"
}

Authorizations

​
Authorization
string
header
required

SIWE access token returned by POST /auth/verify.

Path Parameters

​
id
string
required

API key id.

Response

New API key issued. The key field appears only in this response.

​
id
string
​
name
string
Example:

"trading-bot"

​
prefix
string

Non-secret display fragment of the key.

Example:

"umk_live_AbC123"

​
tier
enum<string>

Rate-limit tier.

Available options:
DEFAULT,
PRO,
INTERNAL
​
lastUsedAt
string<date-time> | null
​
revokedAt
string<date-time> | null
​
createdAt
string<date-time>
​
key
string

The full plaintext secret. Returned only once, at creation or rotation.

Example:

"umk_live_xxxxxxxxxxxxxxxxxxxxxxxx"