Upload cohort | Sarvam API Docs

Upload a cohort as multipart form-data with three fields:

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

Upload a cohort as multipart form-data with three fields: - `name` — Cohort name (1–50 characters) - `cohort_file` — CSV file with a header row and at least one data row - `cohort_transformation_file` — JSON file that maps CSV columns to phone numbers and agent variables

Path parameters

org_idstringRequired

workspace_idstringRequired

campaign_idstringRequired

Request

This endpoint expects a multipart form with multiple files.

namestringRequired

Name of the resource

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

$	curl -X POST https://apps.sarvam.ai/api/scheduling/v1/orgs/org_id/workspaces/workspace_id/campaigns/campaign_id/cohorts/upload \
>	-H "Content-Type: multipart/form-data" \
>	-u "<username>:<password>" \
>	-F cohort_file=@string \
>	-F cohort_transformation_file=@string \
>	-F name="April Batch 1"

1	{
2	"name": "April Batch 1",
3	"cohort_id": "coh-x1y2z3",
4	"status": "completed",
5	"source_type": "file_upload",
6	"created_by": "user@company.com",
7	"created_at": "2026-04-01T09:00:00Z",
8	"updated_at": "2026-04-01T09:05:00Z",
9	"result": {
10	"total_records": 10000,
11	"valid_records": 9750,
12	"rejected_records": 250
13	},
14	"updated_by": null
15	}