List | Flockx - Your Team of AIs

List interactions for a user.

Authorizationstring

API Key authentication via header

sizeintegerOptional1-100Defaults to 50

pageintegerOptional>=1Defaults to 1

sort_orderenum or nullOptional

Sort order (asc or desc)

Allowed values:

end_timestringRequiredformat: "date-time"

Timestamp for the latest interaction to include.

sourceenum or nullOptional

The source of the interaction.

Allowed values:

agent_idstring or nullOptionalformat: "uuid"

The ID of the agent for which to get interactions.

channel_idstring or nullOptionalformat: "uuid"

The ID of the channel for which to get interactions.

typeenum or nullOptional

The type of interaction to get.

Allowed values:

include_nested_interactionsbooleanOptionalDefaults to false

Whether to include nested interactions.

include_incompleteboolean or nullOptional

Whether to include incomplete interactions.

include_external_agentsbooleanOptionalDefaults to false

Include channels where external agent participants (e.g., ASI chats) have addresses matching agents in the organization.

Successful Response

itemslist of objects

metaobject

1	{
2	"items": [
3	{
4	"id": "foo",
5	"created_at": "foo",
6	"channel_id": "foo",
7	"participant": {
8	"type": "foo",
9	"user_id": "foo"
10	},
11	"content": [
12	{
13	"type": "foo",
14	"text": "foo"
15	}
16	],
17	"content_role": "user_message",
18	"complete": true,
19	"metadata": {},
20	"nested_interactions": [
21	null
22	],
23	"interaction_id": "foo",
24	"span_id": "foo",
25	"parent_span_id": "foo",
26	"organization_id": "foo",
27	"organization_application": "foo"
28	}
29	],
30	"meta": {
31	"total": 42,
32	"has_next": true,
33	"has_previous": true,
34	"page": 42
35	}
36	}

1	curl -G https://api.flockx.io/api/v1/interactions \
2	-H "Authorization: <apiKey>" \
3	-d end_time=end_time