Update a webhook
<div style={{ border: "2px solid #1a1a1a", padding: "20px", backgroundColor: "#252e33", margin: "20px 0", borderRadius: "20px", color: "#cccccc" }} id="update-webhook">
<h2 style={{ color: "#cccccc" }}>🔔 Update a Webhook</h2>
<p style={{ color: "#cccccc" }}>
Change the settings of an existing webhook, like its web address or format.
</p>
<h3 style={{ color: "#cccccc" }}>Endpoint</h3>
<p style={{ color: "#cccccc" }}><code>PUT https://api.tor.app/developer/integrations/webhooks</code></p>
<h3 style={{ color: "#cccccc" }}>POST Body Parameters</h3>
<ul style={{ color: "#cccccc" }}>
<li><strong>webhookType</strong> (string, required): The ID of the webhook to update (e.g., <code>wh 2025-05-02 12:34:56</code>).</li>
<li><strong>url</strong> (string, required): The new web address for notifications.</li>
<li><strong>export_format</strong> (string, optional): Choose the transcript format: <code>Txt</code>, <code>Json</code>, or <code>Csv</code>. Default: <code>Txt</code>.</li>
<li><strong>include_timestamps</strong> (boolean, optional): Set to <code>true</code> to add timestamps. Default: <code>false</code>.</li>
<li><strong>include_speaker_names</strong> (boolean, optional): Set to <code>true</code> to include speaker names. Default: <code>false</code>.</li>
<li><strong>merge_same_speaker_segments</strong> (boolean, optional): Set to <code>true</code> to combine parts by the same speaker. Default: <code>false</code>.</li>
<li><strong>is_single_paragraph</strong> (boolean, optional): Set to <code>true</code> for one big paragraph. Default: <code>false</code>.</li>
<li><strong>paragraph_size</strong> (integer, optional): Lines per paragraph (if not single paragraph). Suggested: 1, 2, 4, or 8. Default: 1.</li>
<li><strong>folder_id</strong> (string, optional): Send notifications only for transcriptions in this folder. Default: none.</li>
</ul>
<h3 style={{ color: "#cccccc" }}>Responses</h3>
<details>
<summary style={{ borderLeft: "5px solid #28a745", padding: "10px", backgroundColor: "#d4edda", marginBottom: "10px", borderRadius: "5px" }}><strong>200 OK</strong></summary>
<pre style={{ backgroundColor: "#1a1a1a", padding: "10px", borderRadius: "10px", color: "#cccccc" }}>
<code>"Webhook updated."</code>
</pre>
</details>
<details>
<summary style={{ borderLeft: "5px solid #dc3545", padding: "10px", backgroundColor: "#f8d7da", marginBottom: "10px", borderRadius: "5px" }}><strong>400 Bad Request</strong></summary>
<pre style={{ backgroundColor: "#1a1a1a", padding: "10px", borderRadius: "10px", color: "#cccccc" }}>
<code>"webhookType is required."</code>
</pre>
</details>
<details>
<summary style={{ borderLeft: "5px solid #dc3545", padding: "10px", backgroundColor: "#f8d7da", marginBottom: "10px", borderRadius: "5px" }}><strong>404 Not Found</strong></summary>
<pre style={{ backgroundColor: "#1a1a1a", padding: "10px", borderRadius: "10px", color: "#cccccc" }}>
<code>"Webhook not found."</code>
</pre>
</details>
<details>
<summary style={{ borderLeft: "5px solid #dc3545", padding: "10px", backgroundColor: "#f8d7da", marginBottom: "10px", borderRadius: "5px" }}><strong>500 Internal Server Error</strong></summary>
<pre style={{ backgroundColor: "#1a1a1a", padding: "10px", borderRadius: "10px", color: "#cccccc" }}>
<code>"Failed to update webhook."</code>
</pre>
</details>
<h3 style={{ color: "#cccccc" }}>Notes</h3>
<ul style={{ color: "#cccccc" }}>
<li>Ensure the <code>webhookType</code> matches an existing webhook.</li>
<li>Notifications sent to the <code>url</code> include details like file ID and name.</li>
</ul>
</div>
Updated 16 days ago