Skip to main content
DELETE
/
v1
/
call-log
/
{call_id}
Delete Call Log
curl --request DELETE \
  --url https://api.getbluejay.ai/v1/call-log/{call_id} \
  --header 'X-API-Key: <x-api-key>'
{
  "message": "<string>",
  "status": "200"
}
Integration Prompt for AI Agents
# Bluejay — Testing & Monitoring Platform for Conversational AI Agents

You are a senior backend engineer integrating the Bluejay API. Think step-by-step: first understand the endpoint, then plan the integration, then implement with minimal changes.

## Delete Call Log — DELETE /v1/call-log/{call_id}

> **What this endpoint does:** Delete a specific call log given its ID. Validates that the user has access to the call log by checking organization membership. Args: call_id: The ID of the call to delete recording_only: If True, only delete the recording file and clear recording fields. If False (default), delete the entire call log.

**Endpoint:** DELETE `https://api.getbluejay.ai/v1/call-log/{call_id}`
**Auth:** `X-API-Key` header

### Required Parameters
| Name | Type | Description |
|------|------|-------------|
| call_id | string |  |
| X-API-Key | string | API key required to authenticate requests. |

Review the full parameter list at https://docs.getbluejay.ai/api-reference/endpoint/delete-call-log and include any optional parameters (e.g., `recording_only`) that serve your integration's use case and align with Bluejay's testing and monitoring capabilities.

### Example
**DELETE request:**
```python
import requests

def delete_call_log(call_id: str, api_key: str) -> dict:
    url = f"https://api.getbluejay.ai/v1/call-log/{call_id}"
    headers = {"X-API-Key": api_key}
    response = requests.delete(url, headers=headers)
    response.raise_for_status()
    return response.json()
```

### Constraints
- Minimal changes — only add/change files needed for this integration.
- Match existing codebase patterns (naming, file structure, error handling).
- Include error handling for 422: Validation Error.

### Integration Checklist
Before writing code, verify:
1. Which module/service owns this API domain in the codebase?
2. What HTTP client and error-handling patterns does the project use?
3. Are there existing types/interfaces to extend?

Then implement the integration, export it, and confirm it compiles/passes lint.
This endpoint allows you to delete a call log and optionally the recording only.

Headers

X-API-Key
string
required

API key required to authenticate requests.

Path Parameters

call_id
string
required

Query Parameters

recording_only
boolean
default:false

If true, only delete the recording file and clear recording fields. If false, delete the entire call log including all data.

Response

Successful Response

message
string
required

Success message

status
string
default:200

Status of the response