Delete Project

Permanently remove a recording project.

DELETEhttps://api.identitycall.ai/api/v1/public/projects/:id

Delete a project. Account-wide API keys only.

Requires delete permission

This action is irreversible. Deleting a project cascades to its recordings, dialogues, goal evaluations, virtual numbers, voice agents, and other dependent records. Make sure you have exported anything you need first.

API Key Scope

Scope	Behavior
Account-wide	Allowed.
Project-scoped	403 Forbidden — project-scoped keys cannot delete projects.

Path Parameters

Parameters

Name	Type	Required	Default	Description
`id`	integer	Yes	-	Numeric project ID.

Request

cURL


curl -X DELETE "https://api.identitycall.ai/api/v1/public/projects/42" \
  -H "Authorization: Bearer $IDENTITYCALL_API_KEY"

Python


import requests
import os
 
API_KEY = os.environ.get("IDENTITYCALL_API_KEY")
project_id = 42
 
response = requests.delete(
    f"https://api.identitycall.ai/api/v1/public/projects/{project_id}",
    headers={"Authorization": f"Bearer {API_KEY}"}
)
 
if response.status_code == 204:
    print(f"Project {project_id} deleted")

Node.js


const API_KEY = process.env.IDENTITYCALL_API_KEY;
const projectId = 42;
 
const response = await fetch(
  `https://api.identitycall.ai/api/v1/public/projects/${projectId}`,
  {
    method: 'DELETE',
    headers: { 'Authorization': `Bearer ${API_KEY}` }
  }
);
 
if (response.status === 204) {
  console.log(`Project ${projectId} deleted`);
}

Response

Returns 204 No Content on success with an empty body.

Errors

Status	Condition
401	Missing or invalid `Authorization` header.
403	API key lacks `delete` permission, or the key is project-scoped.
404	Project does not exist in the account.

Example 403 body for a project-scoped key:


{
  "error": "Project-scoped API keys cannot create or destroy projects"
}

Try It

API Key

Parameters

id*

Delete Project

API Key Scope

Path Parameters

Parameters

Request

cURL

Python

Node.js

Response

Errors

Try It

Try It

See also