Nurama Developers
Bots

Rotate the bot's API key

Revokes the bot's current active API key and issues a new one. The new raw key is returned once. The replacement carries the old key's scopes verbatim, so rotation is not a way to pick up scopes added to the registry since the key was minted — use `PATCH .../keys/{keyId}` for that.

POST
/workspaces/{workspaceId}/bots/{botId}/rotate-key

Revokes the bot's current active API key and issues a new one. The new raw key is returned once. The replacement carries the old key's scopes verbatim, so rotation is not a way to pick up scopes added to the registry since the key was minted — use PATCH .../keys/{keyId} for that.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

workspaceId*string
Formatuuid
botId*string
Formatuuid

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/workspaces/497f6eca-6276-4993-bfeb-53cbbbba6f08/bots/497f6eca-6276-4993-bfeb-53cbbbba6f08/rotate-key"
{  "apiKey": {    "id": "string",    "keyPrefix": "string",    "name": "string",    "scopes": [      "string"    ],    "createdAt": "2019-08-24T14:15:22Z"  },  "rawKey": "string"}