Skip to main content
POST
Issues a new App Secret for one sandbox or production app and returns it. The previous App Secret stops working immediately, so requests that still use it return 401. Update your backend with the new secret right after this call. The new App Secret is returned only in this response. No other endpoint returns it, so store it when you receive it. If you lose an App Secret, or it leaks, rotate it.

Headers

string
required
Bearer sk_workspace_..., a Workspace API key of the organization that owns the app. See Workspace API.
string
A unique key for this request, up to 255 characters. If you retry with the same key within 24 hours, you get the stored response with Idempotency-Replayed: true, and the App Secret is not rotated a second time. See Request behavior.

Path Parameters

string
required
The app ID returned by Create App or List Apps.

Response

201 Created with the new App Secret.
string
required
The app’s new App Secret. Use it with the app ID for Basic auth on the verification API and as the OIDC client_secret. See Authentication.

Errors

Besides the authentication and subscription errors that every route can return (see Workspace API), this endpoint returns: