Delete webhook subscription
curl --request POST \
--url https://api.tilta.io/v1/webhooks/{type}/unsubscribe \
--header 'Authorization: Bearer <token>'const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.tilta.io/v1/webhooks/{type}/unsubscribe', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.tilta.io/v1/webhooks/{type}/unsubscribe"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.tilta.io/v1/webhooks/{type}/unsubscribe",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"destination_url": "<string>"
}{
"code": "BAD_REQUEST",
"error": "Request validation failed. 1 issue found.",
"issues": [
{
"code": "INVALID_TYPE",
"path": "body.registered_at",
"message": "Invalid type"
}
]
}{
"error": "Unauthorized",
"code": "UNAUTHORIZED"
}Webhooks
Delete a subscription
Unsubscribe from a Tilta webhook event type. After deletion, Tilta stops delivering events of that type to your registered endpoint.
POST
/
v1
/
webhooks
/
{type}
/
unsubscribe
Delete webhook subscription
curl --request POST \
--url https://api.tilta.io/v1/webhooks/{type}/unsubscribe \
--header 'Authorization: Bearer <token>'const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.tilta.io/v1/webhooks/{type}/unsubscribe', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.tilta.io/v1/webhooks/{type}/unsubscribe"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.tilta.io/v1/webhooks/{type}/unsubscribe",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"destination_url": "<string>"
}{
"code": "BAD_REQUEST",
"error": "Request validation failed. 1 issue found.",
"issues": [
{
"code": "INVALID_TYPE",
"path": "body.registered_at",
"message": "Invalid type"
}
]
}{
"error": "Unauthorized",
"code": "UNAUTHORIZED"
}Unsubscribing stops all future event deliveries for the specified event type or prefix. Any events already queued at the moment of deletion may still be delivered, but no new events are dispatched. To resume receiving events of this type later, create a new subscription.
Deleting a subscription is irreversible, and the associated
signature_key is discarded with it. To pause deliveries
temporarily instead, replace the subscription with a destination_url that
returns 2xx without processing the payload.Deleting a parent-prefix subscription (e.g.
FACILITY) removes the single subscription for that prefix. It does not
cascade to delete any separate leaf-event subscriptions you may have created under the same namespace (e.g. a distinct
FACILITY.CREATION.ACCEPTED subscription). Delete each subscription individually if needed.Authorizations
Your Tilta API key, sent as Bearer <key>.
Path Parameters
The webhook's type. Supports the hierarchical dot-notation taxonomy; subscribing to a parent (e.g. FACILITY) implicitly subscribes to every descendant event (e.g. FACILITY.CREATION.ACCEPTED). Other valid values include ORDER.CONFIRMED and INVOICE.DUE.
Available options:
BUYER, BUYER.CREATED, BUYER.UPDATED, FACILITY, FACILITY.CREATION, FACILITY.CREATION.ACCEPTED, FACILITY.CREATION.IN_REVIEW, FACILITY.CREATION.REJECTED, FACILITY.EXPIRED, FACILITY.FROZEN, FACILITY.INCREASE, FACILITY.INCREASE.ACCEPTED, FACILITY.INCREASE.IN_REVIEW, FACILITY.INCREASE.REJECTED, FACILITY.RENEWAL, FACILITY.RENEWAL.ACCEPTED, FACILITY.RENEWAL.IN_REVIEW, FACILITY.RENEWAL.REJECTED, FACILITY.UNFROZEN, INVOICE, INVOICE.CLOSED, INVOICE.CREATED, INVOICE.DUE, INVOICE.FILE, INVOICE.FILE.CREATED, INVOICE.FILE.DELETED, INVOICE.FILE.REPLACED, INVOICE.FINANCING, INVOICE.FINANCING.PAID_OUT, ORDER, ORDER.CANCELLED, ORDER.CLOSED, ORDER.CONFIRMED, ORDER.DISBURSED, ORDER.EXPIRED Example:
"FACILITY.CREATION.ACCEPTED"
Response
Where the webhook should be sent to. This must be an endpoint that handles POST requests.