DocumentationAPI Reference
Deployment cohorts

List deployment cohorts

GET
/workspaces/{workspaceId}/deployment-cohorts

Authorization

API key Deployments: read
AuthorizationBearer <token>

API key (sf_...) with any of the required scopes. Generate it in the Spotflow portal on the settings page.

In: header

Scope: Deployments: read

Path Parameters

workspaceId*string
Formatuuid

Response Body

application/json

curl -X GET "https://example.com/workspaces/00000000-0000-0000-0000-000000000001/deployment-cohorts"

All deployment cohorts in the workspace.

[  {    "id": "m3Yg84tDx7Rn",    "name": "Field test devices",    "createdAt": "2026-01-07T10:00:00+00:00",    "deviceCount": 24  },  {    "id": "n9Ac37zEv2Hq",    "name": "Production rollout",    "createdAt": "2026-01-09T13:20:00+00:00",    "deviceCount": 1840  }]