Upload cohort | Sarvam API Docs

curl -X POST https://apps.sarvam.ai/api/scheduling/v1/orgs/org_id/workspaces/workspace_id/deployments/deployment_id/cohorts/upload \
     -H "Content-Type: multipart/form-data" \
     -u "<username>:<password>" \
     -F cohort_file=@"(binary CSV file)" \
     -F cohort_transformation_file=@"(binary JSON file)" \
     -F name="April Users Batch 1"

{
  "name": "April Users Batch 1",
  "cohort_id": "coh-x1y2z3",
  "status": "completed",
  "source_type": "file_upload",
  "created_by": "user@company.com",
  "created_at": "2026-04-01T09:00:00Z",
  "updated_at": "2026-04-01T09:02:30Z",
  "result": {
    "total_records": 5000,
    "valid_records": 4850,
    "rejected_records": 150
  },
  "updated_by": null
}

Upload a cohort of users for a deployment. When a known user calls in, the agent receives their personalized variables (name, balance, language, etc.) for a tailored conversation.

Upload as multipart form-data with three fields:

name — Cohort name (1–50 characters)
cohort_file — CSV file with a header row and user data
cohort_transformation_file — JSON file that maps CSV columns to phone numbers and agent variables

Upload a cohort of users for a deployment. When a known user calls in, the agent receives their personalized variables (name, balance, language, etc.) for a tailored conversation. Upload as multipart form-data with three fields: - `name` — Cohort name (1–50 characters) - `cohort_file` — CSV file with a header row and user data - `cohort_transformation_file` — JSON file that maps CSV columns to phone numbers and agent variables

Path parameters

org_idstringRequired

workspace_idstringRequired

deployment_idstringRequired

Request

This endpoint expects a multipart form with multiple files.

namestringRequiredformat: "^[\w\- ]{1,50}$"<=50 characters

Cohort name (1-50 characters)

cohort_filefileRequired

CSV file containing the cohort data

cohort_transformation_filefileRequired

JSON file defining how CSV columns map to agent variables

Response

Successful Response

namestring

Name of the resource

cohort_idstring

Unique identifier for the cohort

statusenum

Current status

source_typeenum

How the cohort was uploaded

created_bystring

User who created this resource

created_atdatetime

Timestamp when the resource was created (ISO 8601)

updated_atdatetime

Timestamp when the resource was last updated (ISO 8601)

resultobject or null

Processing result with record counts

updated_bystring or null

User who last updated this resource

Errors

422

Unprocessable Entity Error