Update a webhook

🔔 Update a Webhook

Change the settings of an existing webhook, like its web address or format.

Endpoint

PUT https://api.tor.app/developer/integrations/webhooks

POST Body Parameters

  • webhookType (string, required): The ID of the webhook to update (e.g., wh 2025-05-02 12:34:56).
  • url (string, required): The new web address for notifications.
  • export_format (string, optional): Choose the transcript format: Txt, Json, or Csv. Default: Txt.
  • include_timestamps (boolean, optional): Set to true to add timestamps. Default: false.
  • include_speaker_names (boolean, optional): Set to true to include speaker names. Default: false.
  • merge_same_speaker_segments (boolean, optional): Set to true to combine parts by the same speaker. Default: false.
  • is_single_paragraph (boolean, optional): Set to true for one big paragraph. Default: false.
  • paragraph_size (integer, optional): Lines per paragraph (if not single paragraph). Suggested: 1, 2, 4, or 8. Default: 1.
  • folder_id (string, optional): Send notifications only for transcriptions in this folder. Default: none.

Responses

200 OK
"Webhook updated."
    
400 Bad Request
"webhookType is required."
    
404 Not Found
"Webhook not found."
    
500 Internal Server Error
"Failed to update webhook."
    

Notes

  • Ensure the webhookType matches an existing webhook.
  • Notifications sent to the url include details like file ID and name.