Skip to main content
DELETE
/
callouts
/
{id}
curl --request DELETE \
     --url https://api.credira.com/v1/callouts/callout_123456789 \
     --header 'Authorization: Bearer YOUR_API_KEY' \
     --header 'Content-Type: application/json'

{
  "success": true,
  "data": {
    "id": "callout_123456789",
    "deleted": true,
    "deleted_time": "2024-01-15T10:30:00Z",
    "deleted_items": {
      "callout": true,
      "recordings": 2,
      "transcriptions": 2,
      "analytics": true
    }
  },
  "meta": {
    "timestamp": "2024-01-15T10:30:00Z",
    "request_id": "req_123456789",
    "message": "Callout deleted successfully"
  }
}

​
Delete Callout

Delete a specific callout and all associated data.
This action is irreversible. All callout data, including recordings, transcriptions, and analytics will be permanently deleted.

​
Request

​
id
string
required
The unique identifier of the callout to delete
​
Authorization
string
required
Bearer token for API authentication
curl --request DELETE \
     --url https://api.credira.com/v1/callouts/callout_123456789 \
     --header 'Authorization: Bearer YOUR_API_KEY' \
     --header 'Content-Type: application/json'

{
  "success": true,
  "data": {
    "id": "callout_123456789",
    "deleted": true,
    "deleted_time": "2024-01-15T10:30:00Z",
    "deleted_items": {
      "callout": true,
      "recordings": 2,
      "transcriptions": 2,
      "analytics": true
    }
  },
  "meta": {
    "timestamp": "2024-01-15T10:30:00Z",
    "request_id": "req_123456789",
    "message": "Callout deleted successfully"
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "Invalid callout ID format"
  },
  "meta": {
    "timestamp": "2024-01-15T10:30:00Z",
    "request_id": "req_123456789"
  }
}

{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or missing API key"
  },
  "meta": {
    "timestamp": "2024-01-15T10:30:00Z",
    "request_id": "req_123456789"
  }
}

{
  "success": false,
  "error": {
    "code": "FORBIDDEN",
    "message": "You don't have permission to delete this callout"
  },
  "meta": {
    "timestamp": "2024-01-15T10:30:00Z",
    "request_id": "req_123456789"
  }
}

{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Callout not found"
  },
  "meta": {
    "timestamp": "2024-01-15T10:30:00Z",
    "request_id": "req_123456789"
  }
}

{
  "success": false,
  "error": {
    "code": "CONFLICT",
    "message": "Cannot delete callout that is currently active"
  },
  "meta": {
    "timestamp": "2024-01-15T10:30:00Z",
    "request_id": "req_123456789"
  }
}