Applications

Rotate an application's edge auth secret

Mints a new edge_auth_secret for the application and invalidates the previous one immediately. There is no overlap window, so the edge must be reconfigured with the returned value before it can authenticate again. Requires app:write (member and above); a widget token cannot call it. The secret is returned once and is not retrievable afterwards.

post/applications/{id}/edge-secret:rotate

Request

  • Base URL: https://api.customdomain.ai/v1
  • URL: https://api.customdomain.ai/v1/applications/{id}/edge-secret:rotate
  • Auth: HTTP bearer

Path parameters

idstring required

Application id.

Response

The new secret. Store it now; it is never shown again.

application_idstring required
edge_auth_secretstring required

The new shared secret. Shown exactly once.

Changes

No recorded changes to this operation across all 1 revision of this API.