Sign in
Service Keys

Regenerate service key

Changed on

Generate new JWT value for existing key. The old key stops working within a few seconds. Update your backend services with the new key before regenerating in production.

post/projects/{id}/service-keys/{keyId}/regenerate

Request

  • Base URL: https://api.volcano.dev
  • URL: https://api.volcano.dev/projects/{id}/service-keys/{keyId}/regenerate
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Path parameters

idstring uuid required

Project ID

keyIdstring uuid required

Response

Key regenerated - save the new key_value immediately!

idstring uuid required
project_idstring uuid
namestring required

Descriptive name for the key

key_valuestring

Full JWT token for Authorization header. Returned on create, get, and list (decrypted from storage). Store securely - NEVER expose in frontend code!

key_prefixstring required

First 12 characters of the key for display/identification

permissionsstring[] required

Operations this key may perform. ["*"] grants full admin access (default for keys created without an explicit scope). Scoped keys list specific permissions, e.g. ["functions.invoke", "locks.manage"].

created_atstring date-time
updated_atstring date-time

Example response

{
  "permissions": [
    "*"
  ]
}

Changes

  • 23e7875e7c4cRevision changes
    • ○

      the endpoint scheme security ProjectAccessToken was added to the API

  • 3a6f365f3f35Revision changes
    • ▲

      added the new path request parameter id

    • ▲

      the response's body type changed from no type to object for status

    • ○

      added the optional property to the response with the status

    • ○

      added the optional property to the response with the status

    • ○

      added the optional property to the response with the status

    • ○

      added the optional property to the response with the status

    • ○

      added the required property to the response with the status

    • ○

      added the required property to the response with the status

    • ○

      added the required property to the response with the status

    • ○

      added the required property to the response with the status