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"}