Projects

A project is a container for recordings, voice agents, virtual numbers, and operators. Every recording belongs to exactly one project. Integrations that provision tenants dynamically can create and manage projects through this API.

Scopes

API key scope	Allowed operations
Account-wide	All operations on any project in the account
Project-scoped	Read and update its own project only. Create and destroy return 403.

Endpoints

List ProjectsGET/projects

Enumerate projects the API key can access.

Create ProjectPOST/projects

Provision a new project. Account-wide keys only.

Get ProjectGET/projects/:id

Fetch the full detail record for one project.

Update ProjectPATCH/projects/:id

Change settings on an existing project.

Delete ProjectDELETE/projects/:id

Remove a project. Account-wide keys only.

Example: create a project


curl -X POST "https://api.identitycall.ai/api/v1/public/projects" \
  -H "Authorization: Bearer $IDENTITYCALL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Customer Support EN","language":"en"}'


{
  "data": {
    "id": 42,
    "name": "Customer Support EN",
    "language": "en",
    "industry": null,
    "created_at": "2026-04-15T10:00:00Z",
    "updated_at": "2026-04-15T10:00:00Z",
    "recordings_count": 0,
    "virtual_numbers_count": 0
  }
}

See the OpenAPI spec for the full field list.