curl -X DELETE "https://api.hooked.so/v1/social/account/cm7g8h9i0j1k2l3m4n5o6p7q8" \
-H "x-api-key: your_api_key_here"
const response = await fetch('https://api.hooked.so/v1/social/account/cm7g8h9i0j1k2l3m4n5o6p7q8', {
method: 'DELETE',
headers: { 'x-api-key': 'your_api_key_here' }
});
const result = await response.json();
console.log(result.message);
import requests
response = requests.delete(
'https://api.hooked.so/v1/social/account/cm7g8h9i0j1k2l3m4n5o6p7q8',
headers={'x-api-key': 'your_api_key_here'}
)
print(response.json()['data']['deleted'])
{
"success": true,
"message": "Account deleted successfully",
"data": {
"id": "cm7g8h9i0j1k2l3m4n5o6p7q8",
"deleted": true
}
}
{
"code": "not_found",
"message": "Account not found",
"errorCode": "RESOURCE_NOT_FOUND",
"details": { "resource_id": "cm7g8h9i0j1k2l3m4n5o6p7q8", "resource_type": "Account" }
}
Account Analysis
Delete Account
Delete an analyzed account and its saved data
DELETE
/
v1
/
social
/
account
/
{accountId}
curl -X DELETE "https://api.hooked.so/v1/social/account/cm7g8h9i0j1k2l3m4n5o6p7q8" \
-H "x-api-key: your_api_key_here"
const response = await fetch('https://api.hooked.so/v1/social/account/cm7g8h9i0j1k2l3m4n5o6p7q8', {
method: 'DELETE',
headers: { 'x-api-key': 'your_api_key_here' }
});
const result = await response.json();
console.log(result.message);
import requests
response = requests.delete(
'https://api.hooked.so/v1/social/account/cm7g8h9i0j1k2l3m4n5o6p7q8',
headers={'x-api-key': 'your_api_key_here'}
)
print(response.json()['data']['deleted'])
{
"success": true,
"message": "Account deleted successfully",
"data": {
"id": "cm7g8h9i0j1k2l3m4n5o6p7q8",
"deleted": true
}
}
{
"code": "not_found",
"message": "Account not found",
"errorCode": "RESOURCE_NOT_FOUND",
"details": { "resource_id": "cm7g8h9i0j1k2l3m4n5o6p7q8", "resource_type": "Account" }
}
Overview
Permanently deletes an analyzed account from your team, with its saved videos and analytics. It only removes Hooked’s copy; nothing happens on the platform. Credits spent on the analysis are not refunded. To analyze the account again, call Analyze Account (it gets a newid).
curl -X DELETE "https://api.hooked.so/v1/social/account/cm7g8h9i0j1k2l3m4n5o6p7q8" \
-H "x-api-key: your_api_key_here"
const response = await fetch('https://api.hooked.so/v1/social/account/cm7g8h9i0j1k2l3m4n5o6p7q8', {
method: 'DELETE',
headers: { 'x-api-key': 'your_api_key_here' }
});
const result = await response.json();
console.log(result.message);
import requests
response = requests.delete(
'https://api.hooked.so/v1/social/account/cm7g8h9i0j1k2l3m4n5o6p7q8',
headers={'x-api-key': 'your_api_key_here'}
)
print(response.json()['data']['deleted'])
{
"success": true,
"message": "Account deleted successfully",
"data": {
"id": "cm7g8h9i0j1k2l3m4n5o6p7q8",
"deleted": true
}
}
{
"code": "not_found",
"message": "Account not found",
"errorCode": "RESOURCE_NOT_FOUND",
"details": { "resource_id": "cm7g8h9i0j1k2l3m4n5o6p7q8", "resource_type": "Account" }
}
Errors
| Status | When |
|---|---|
| 401 | Missing or invalid API key (code: "not_authenticated") |
| 403 | Your team does not have the Hooked app product (code: "entitlement_required") |
| 404 | No account with that id, including one already deleted (code: "not_found"). An id that belongs to another team answers the same way |
| 500 | { "success": false, "message": "Failed to delete account", "error": "..." } |