API ReferenceEndpointsProjects
Issue a new project secret (admin only)
The old secret stops working immediately; the new one is shown once.
Authorization
bearerAuth AuthorizationBearer <token>
Session token issued by the accounts service (or the legacy /v1/auth routes).
In: header
Path Parameters
project_uuid*string
Format
uuidResponse Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/projects/497f6eca-6276-4993-bfeb-53cbbbba6f08/secret/rotate"{ "notice": "store the secret now; it is not shown again", "project": { "created_at": "2026-09-13T12:30:45Z", "data_residency": "US", "key": "3142566d8c88721d6d34bd9443d556bf", "name": "Mobile app", "organization_uuid": "0b7e2b1a-0a1b-4c2d-8e3f-4a5b6c7d8e9f", "secret": "ps_1a2b…", "selected": true, "status_uuid": "9d3f1e2c-5a6b-4c7d-8e9f-0a1b2c3d4e5f", "updated_at": "2026-09-13T12:30:45Z", "uuid": "5f1c2e7a-1c2d-4b3e-9f10-1a2b3c4d5e6f" }}