REST API: data sources
List data source groups
Read all data source groups.
Purpose
Use this call to list the groups of data sources that exist in your account.
Request
POST <API_BASE_URL>/source/groups. All calls are POST under your API address. Replace <API_BASE_URL> with the API address provided with your access.
This operation takes no permanent API token. Send a user token in the token header. See authentication and user authorization.
The body has no fields.
Response
HTTP 200. Every group of the account, sent as a bare array. This operation does not wrap its success in the status envelope.
| Field | Type | Description |
|---|---|---|
group_id | string (uuid) | The identifier of the group, as you send it in group_id. |
created | string (date-time) | When the group was created. |
name | string | The name of the group. |
Errors
400: The request body failed validation.401: The token is missing, expired or unknown.
A refusal can also come before the operation runs: an address outside your IP allowlist, a token bound to another address, or a body that is not valid JSON. See response format and errors.
Example
Request:
curl -X POST "<API_BASE_URL>/source/groups" \
-H "token: <your user token>" \
-H "Content-Type: application/json"
Response:
[
{
"group_id": "<group id>",
"created": "2026-01-01T10:00:00.000Z",
"name": "Main entrance"
}
]