SEsentdm
Voice

Rotate a voice agent's signing secret

Changed on

Generates a new signing_secret for the agent and returns it. The previous secret stops signing immediately, so update your agent before the next call reaches it.

With sandbox: true a secret is generated and returned with 202, and nothing is written.

post/v3/voice/agents/{id}/rotate-secret

Request

  • Base URL
    https://api.sent.dm
  • URL
    https://api.sent.dm/v3/voice/agents/{id}/rotate-secret
  • Auth
    • API key in header x-api-key
    • or HTTP bearer

Path parameters

idstring required

The agent id, such as agent_9f2ab000-0000-4000-8000-000000000001

Headers

Idempotency-Keystring

Unique key to ensure idempotent request processing. Must be 1-255 alphanumeric characters, hyphens, or underscores. Responses are cached for 24 hours per key per customer.

x-profile-idstring uuid

Profile UUID to scope the request to a child profile. Only organization API keys can use this header. The profile must belong to the calling organization.

Request body

sandboxboolean

Sandbox flag - when true, the operation is simulated without side effects Useful for testing integrations without actual execution

Response

The new secret. The old one no longer signs anything

successboolean

Indicates whether the request was successful

Changes