Skip to main content
POST
/
apps
/
{appId}
/
keys
/
rotate
Rotate API Key
curl --request POST \
  --url https://api.vela.dev/v1/apps/{appId}/keys/rotate \
  --header 'Authorization: Bearer <token>'
{
  "app": {
    "id": "3f2a1b4c-5d6e-7f8a-9b0c-1d2e3f4a5b6c",
    "accountId": "acc-uuid",
    "name": "Order Service",
    "slug": "order-service",
    "apiKeyPrefix": "vela_live_xyz",
    "createdAt": "2024-06-01T12:00:00.000Z",
    "updatedAt": "2024-06-01T14:00:00.000Z"
  },
  "apiKey": "vela_live_newkeyxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

Authorizations

Authorization
string
header
required

Client secret for management API access. Format: vela_cs_...

Path Parameters

appId
string
required

App UUID or slug

Response

New API key

app
object
apiKey
string

Full API key (only returned on creation or rotation)