Create cohort | Sarvam API Docs

curl -X POST https://apps.sarvam.ai/api/scheduling/v1/orgs/org_id/workspaces/workspace_id/deployments/deployment_id/cohorts \
     -H "Content-Type: application/json" \
     -u "<username>:<password>" \
     -d '{
  "name": "April Users Batch 2",
  "source": {
    "type": "pre_signed_url",
    "url": "https://storage.example.com/cohorts/april-batch-2.csv?signature=..."
  },
  "cohort_transformation": {
    "phone_number": {
      "column_name": "mobile",
      "country_code": "IN"
    },
    "app_variables": {
      "account_balance": {
        "column_name": "balance"
      },
      "customer_name": {
        "column_name": "name"
      }
    }
  }
}'

{
  "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
}

Create a cohort from a pre-signed URL source with a transformation configuration. Use this when your CSV is already hosted and accessible via a URL.

Path parameters

org_idstringRequired

workspace_idstringRequired

deployment_idstringRequired

Request

This endpoint expects an object.

namestringRequired

sourceobjectRequired

Source of the cohort data

cohort_transformationobjectRequired

Configuration for how CSV columns map to phone numbers and 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