curl --request PUT \
--url https://app.hookie.ai/portal/api/destinations/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"enabled": false
}
'const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({enabled: false})
};
fetch('https://app.hookie.ai/portal/api/destinations/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.hookie.ai/portal/api/destinations/{id}"
payload = { "enabled": False }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text){
"ok": true
}{
"error": "<string>",
"retry_after": 123,
"upgrade_url": "<string>"
}{
"error": "<string>",
"retry_after": 123,
"upgrade_url": "<string>"
}Enable/disable or re-point one of this customer's destinations
curl --request PUT \
--url https://app.hookie.ai/portal/api/destinations/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"enabled": false
}
'const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({enabled: false})
};
fetch('https://app.hookie.ai/portal/api/destinations/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.hookie.ai/portal/api/destinations/{id}"
payload = { "enabled": False }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text){
"ok": true
}{
"error": "<string>",
"retry_after": 123,
"upgrade_url": "<string>"
}{
"error": "<string>",
"retry_after": 123,
"upgrade_url": "<string>"
}Authorizations
A hpt_… customer portal token, as Authorization: Bearer. Stored hashed; shown once at issue.
Path Parameters
Destination id. The update is scoped to the token's tenant, portal and customer, so another customer's id simply does not match.
Query Parameters
Portal access token (hpt_…), as an alternative to the Authorization: Bearer header.
Body
Only enabled and url can be changed. name and dataset_filter are NOT updatable through the portal (silently ignored), as are all server-controlled columns (secret, created_by, tenant_id, project_id, portal_id, customer_id). An absent or unparseable body is treated as {} — which re-enables the destination, since enabled defaults to 1.
Only the literal JSON false disables the destination. Any other value — true, null, a string, or the field being absent — sets enabled = 1.
Applied only when it is a string starting with https:// (case-insensitive); any other value is silently ignored and the stored URL is kept. A non-https url here is NOT an error.
^[Hh][Tt][Tt][Pp][Ss]://Response
Updated (also returned when the values were unchanged but the row matched).
true