Delete Integration
Permanently remove an API integration from your brand.
Request
DELETE /api/v1/integrations/{id}
Headers
| Header | Value | Required |
|---|---|---|
Authorization | Bearer {client_token} | Yes |
Path Parameters
| Parameter | Type | Description |
|---|---|---|
id | integer | Integration ID to delete |
Example Request
curl -X DELETE "https://spideriq.ai/api/v1/integrations/42" \
-H "Authorization: Bearer $CLIENT_TOKEN"
Response
Success (200 OK)
{
"success": true,
"message": "Integration deleted successfully",
"deleted_id": 42
}
Error Responses
404 Not Found - Integration doesn't exist or belongs to another brand
{
"success": false,
"error": "Integration not found"
}
Notes
- Deletion is permanent and cannot be undone
- Historical spend data for this integration is retained for 90 days
- Active jobs using this key will continue with pool fallback
- Consider disabling (
is_active: false) instead of deleting if you may re-use the key