list | Documentation

list all groups within your GroundX account.

Authentication

X-API-Keystring

API Key authentication via header

Query parameters

nintegerOptional

The maximum number of returned groups. Accepts 1-100 with a default of 20.

nextTokenstringOptional

A token for pagination. If the number of groups for a given query is larger than n, the response will include a "nextToken" value. That token can be included in this field to retrieve the next batch of n groups.

Response

Successful retrieval of groups

groupslist of objectsOptional

countintegerOptional

The number of groups returned in the current response

remainingintegerOptional

The number of groups that have not been returned yet, will be null if there are no remaining groups

totalintegerOptional

The total number of groups found

1	from groundx import GroundX
2
3	client = GroundX(
4	api_key="YOUR_API_KEY_HERE",
5	)
6
7	client.groups.list()

1	{
2	"groups": [
3	{
4	"groupId": 42,
5	"buckets": [
6	{
7	"bucketId": 101,
8	"created": "2024-05-10T14:22:35.123Z",
9	"fileCount": 25,
10	"fileSize": "12.4GB",
11	"name": "Marketing Assets",
12	"updated": "2024-06-01T09:15:47.456Z"
13	}
14	],
15	"created": "2024-04-15T10:05:20.789Z",
16	"fileCount": 250,
17	"fileSize": "120.7GB",
18	"name": "Product Launch Group",
19	"prompt": "Collaborate on Q3 product launch materials",
20	"updated": "2024-06-01T09:15:47.456Z"
21	}
22	],
23	"count": 1,
24	"remaining": 10,
25	"total": 30
26	}