Skip to content
Navigation

Replaces a webhook endpoint's signing secret and answers the new one once; the old one signs nothing more. Needs the read scopes of its events and of every event it still owes.

POST
https://api.sherpo.io/merchant/v1/stores/{store}/webhooks/{webhook}/secret/roll

Authorization

  • bearer
    HTTP
    required

Path parameters

  • store
    string
    required

    The store's id.

  • webhook
    string
    required
    minLength: 1

Request body JSON optional

Returns

200

Replaces a webhook endpoint's signing secret and answers the new one once; the old one signs nothing more. Needs the read scopes of its events and of every event it still owes.

JSON
  • webhook
    object
    required
    • id
      string
      required
    • url
      string
      required
    • description
      required

      One of the following:

      • string
      • null
    • events
      array of
      string
      required
    • enabled
      boolean
      required
    • connection_ended_at
      required

      When it was turned off because the connection that set it up ended.

      One of the following:

      • string
      • null
    • created_at
      string
      required
    • updated_at
      string
      required
  • secret
    string
    required
JSON
  • type
    string
    required
    format: uri
  • title
    string
    required
  • status
    integer
    required
  • detail
    string
    required
  • code
    optional
    string
  • context
    optional
    object
  • reached_core
    optional
    boolean
  • core_answer
    optional
    string

Type to search…

↑↓ navigate↵ selectEsc close