List cohorts

GET

https://apps.sarvam.ai/api/scheduling/v1/orgs/:org_id/workspaces/:workspace_id/deployments/:deployment_id/cohorts

GET

/api/scheduling/v1/orgs/:org_id/workspaces/:workspace_id/deployments/:deployment_id/cohorts

$ curl https://apps.sarvam.ai/api/scheduling/v1/orgs/org_id/workspaces/workspace_id/deployments/deployment_id/cohorts \
>      -u "<username>:<password>"

1 {
2   "items": [
3     {
4       "name": "April Users Batch 1",
5       "cohort_id": "coh-x1y2z3",
6       "status": "completed",
7       "source_type": "file_upload",
8       "created_by": "user@company.com",
9       "created_at": "2026-04-01T09:00:00Z",
10       "updated_at": "2026-04-01T09:02:30Z",
11       "result": {
12         "total_records": 5000,
13         "valid_records": 4850,
14         "rejected_records": 150
15       },
16       "updated_by": null
17     }
18   ],
19   "total": 1,
20   "limit": 10,
21   "offset": 0,
22   "next_page_uri": null,
23   "prev_page_uri": null
24 }

List all cohorts belonging to a deployment with pagination, sorting, and search.

Path parameters

org_idstringRequired

workspace_idstringRequired

deployment_idstringRequired

Query parameters

offsetintegerOptional>=0Defaults to 0

Number of records to skip

limitintegerOptional1-100Defaults to 10

Number of records to return (max 100)

sort_bystring or nullOptional

Field to sort by

sort_orderstring or nullOptional

Sort order (asc or desc)

searchstring or nullOptional

Search query string

Response

Successful Response

itemslist of objects

List of cohorts on this page

totalinteger

Total number of cohorts matching the query

limitinteger

Maximum number of items per page

offsetinteger

Number of items skipped

next_page_uristring or null

URI to fetch the next page, or null if this is the last page

prev_page_uristring or null

URI to fetch the previous page, or null if this is the first page

Errors

422

Unprocessable Entity Error