ANando
Webhooks

Rotate webhook endpoint secret

Changed on

Rotates a webhook endpoint signing secret and returns the new secret exactly once.

post/webhook-endpoints/{endpointId}/rotate-secret

Request

  • Base URL
    https://api.ando.so/v1
  • URL
    https://api.ando.so/v1/webhook-endpoints/{endpointId}/rotate-secret
  • Auth
    • API key in header x-api-key
    • or HTTP bearer

Path parameters

endpointIdstring required

Webhook endpoint identifier.

Request body

previous_secret_ttl_secondsinteger

Seconds to keep the previous secret active. Maximum is 86400.

Response

Rotated webhook endpoint secret.

Example response

{
  "data": {
    "created_at": "2026-05-14T08:00:00.000Z",
    "delivery_scope": {
      "actor_workspace_membership_id": "01jzn7e61x3a7v9h2r7t2m3q4p"
    },
    "id": "01jzn7e61x3a7v9h2r7t2m3q4p",
    "updated_at": "2026-05-14T08:00:00.000Z",
    "workspace_id": "01jzn7e61x3a7v9h2r7t2m3q4p"
  }
}

Changes

  • aaceae49c08dRevision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • a1b7544d3bf4Revision changes
    • warning

      added the new miniapp.action.invoked enum value to the // response property for the response status