Skip to main content
DELETE
/
api
/
integrations
/
{integration_id}
Delete Integration
curl --request DELETE \
  --url https://api.example.com/api/integrations/{integration_id} \
  --header 'X-API-Key: <x-api-key>' \
  --header 'X-Organization-Id: <x-organization-id>'
{
  "success": true,
  "message": "Integration deleted successfully",
  "data": {
    "integration_id": "intg_a1b2c3d4e5f6",
    "client_id": "org_abc123",
    "name": "Twilio Production",
    "provider": "twilio",
    "category": "telephony",
    "status": "active",
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-15T10:30:00Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.getbutter.ai/llms.txt

Use this file to discover all available pages before exploring further.

Delete an integration and its stored credentials. Note that integrations currently referenced by phone numbers cannot be deleted until those phone numbers are reassigned or removed.

Headers

X-API-Key
string
required
Your API key for authentication.
X-Organization-Id
string
required
The organization ID.

Path Parameters

integration_id
string
required
The unique identifier of the integration (format: intg_[a-f0-9]{12}).

Permissions

  • integrations:delete (admin, agent_manager)

Response

success
boolean
Indicates if the request was successful.
message
string
Human-readable success message.
data
object
The deleted integration object.
{
  "success": true,
  "message": "Integration deleted successfully",
  "data": {
    "integration_id": "intg_a1b2c3d4e5f6",
    "client_id": "org_abc123",
    "name": "Twilio Production",
    "provider": "twilio",
    "category": "telephony",
    "status": "active",
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-15T10:30:00Z"
  }
}

Error Responses

Returned when the integration is still referenced by one or more phone numbers. The error message will list the phone numbers that must be removed or reassigned first.
{
  "detail": "Integration is still referenced by phone numbers: ['+1234567890']. Remove or reassign them first."
}