Update Project

Change one or more settings on an existing recording project.

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

Update project settings. Send only the fields you want to change.

Requires write permission

API Key Scope

Scope	Behavior
Account-wide	Can update any project in the account.
Project-scoped	Can update its own project only. Other IDs return `404`.

Path Parameters

Parameters

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

Request Body

All fields are optional. Send only the keys you wish to change — omitted fields are left untouched.

Body Parameters (application/json)

Name	Type	Required	Default	Description
`name`	string	No	-	Display name of the project.
`language`	string	No	-	Default ISO language code for transcription.
`description`	string	No	-	Free-form description for internal reference.
`industry`	string	No	-	Industry tag (e.g. insurance, ecommerce, healthcare).
`goal_language`	string	No	-	Language used for goal-evaluation prompts.
`summary_language`	string	No	-	Language used to render call summaries.
`long_pause_threshold_seconds`	integer	No	-	Minimum gap in seconds before a silence is flagged as a long pause.
`transcription_hints`	string	No	-	Domain vocabulary or proper nouns to bias the transcriber towards.
`retention_days`	integer	No	-	Number of days to retain recordings. Null disables retention.
`quality_baseline_enabled`	boolean	No	-	Whether to compute a quality baseline.
`quality_baseline_pct`	number	No	-	Target percentile (0-100) for the quality baseline.

Request

cURL


curl -X PATCH "https://api.identitycall.ai/api/v1/public/projects/42" \
  -H "Authorization: Bearer $IDENTITYCALL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Inbound English-language support line.",
    "retention_days": 730,
    "quality_baseline_enabled": true,
    "quality_baseline_pct": 80
  }'

Python


import requests
import os
 
API_KEY = os.environ.get("IDENTITYCALL_API_KEY")
project_id = 42
 
response = requests.patch(
    f"https://api.identitycall.ai/api/v1/public/projects/{project_id}",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    },
    json={
        "description": "Inbound English-language support line.",
        "retention_days": 730,
        "quality_baseline_enabled": True,
        "quality_baseline_pct": 80
    }
)
 
project = response.json()["data"]
print(f"Updated {project['name']} (retention: {project['retention_days']} days)")

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: 'PATCH',
    headers: {
      'Authorization': `Bearer ${API_KEY}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      description: 'Inbound English-language support line.',
      retention_days: 730,
      quality_baseline_enabled: true,
      quality_baseline_pct: 80
    })
  }
);
 
const { data: project } = await response.json();
console.log(`Updated ${project.name} (retention: ${project.retention_days} days)`);

Response

Response200 OK

{
"data": {
  "id": 42,
  "name": "Customer Support EN",
  "language": "en",
  "industry": "ecommerce",
  "created_at": "2026-04-15T10:00:00Z",
  "updated_at": "2026-04-15T12:14:00Z",
  "description": "Inbound English-language support line.",
  "goal_language": "en",
  "summary_language": "en",
  "long_pause_threshold_seconds": 5,
  "transcription_hints": "IdentityCall, KYC, SCA",
  "retention_days": 730,
  "quality_baseline_enabled": true,
  "quality_baseline_pct": 80.0,
  "recordings_count": 1284,
  "virtual_numbers_count": 3
}
}

The full ProjectDetail schema is documented under Get Project.

Errors

Status	Condition
401	Missing or invalid `Authorization` header.
403	API key lacks `write` permission.
404	Project does not exist, or a project-scoped key requested an `id` other than its own.
422	Validation failed. The `errors` array lists the offending fields.

Try It

API Key

Parameters

id*

Body

name

description

retention_days

Update Project

API Key Scope

Path Parameters

Parameters

Request Body

Body Parameters (application/json)

Request

cURL

Python

Node.js

Response

Errors

Try It

Try It

See also