Rotate an endpoint's signing secret
POST
/api/v1/webhooks/{id}/rotate-secret
const url = 'https://trongas.ai/api/v1/webhooks/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/rotate-secret';const options = {method: 'POST', headers: {'X-Api-Key': '<X-Api-Key>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://trongas.ai/api/v1/webhooks/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/rotate-secret \ --header 'X-Api-Key: <X-Api-Key>'Required API-key scope: full
Issue a new signing secret and invalidate the old one. Returns the new secret — shown once.
Deliveries signed with the old secret stop verifying immediately, so update your receiver promptly.
Authorizations
Section titled “Authorizations”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters”id
required
string format: uuid
Responses
Section titled “ Responses ”OK
object
secret
required
string
object
secret
required
string
Examplegenerated
{ "secret": "example"}object
secret
required
string
Examplegenerated
{ "secret": "example"}