Ordexs API v1 Get an API key

Webhooks

Rotate the signing secret

POSThttps://api.ordexs.com/v1/webhook_endpoints/{webhook_endpoint_id}/rotate_secret

Issues a new secret (returned once). For expire_previous_in_hours (default 24, up to 72) every delivery is signed with BOTH secrets, so you can switch without missing an event. 0 retires the old one at once.

Path parameters

  • webhook_endpoint_idstringRequired

    starts with we_

Body

  • expire_previous_in_hoursinteger

    0–72

Returns

200 OK · The endpoint with its new secret. WebhookEndpoint

  • idstring

    starts with we_

  • objectstring

    always "webhook_endpoint"

  • urlstring

    uri

  • descriptionstring or null
  • eventsarray of strings
  • statusstring

    auto_disabled: every delivery failed for 3 days, so Ordexs stopped sending. Set status: enabled to resume.

    One of enabled, disabled, auto_disabled

  • disabled_reasonstring or null
  • failing_sincestring or null

    When deliveries started failing without a success since.

    ISO 8601 date-time, UTC

  • livemodeboolean
  • secretstring

    Only in the response to create and rotate_secret.

  • created_atstring

    ISO 8601 date-time, UTC

  • updated_atstring

    ISO 8601 date-time, UTC

Errors

Every error has the same shape. This endpoint can answer with: