Detail | Flockx - Your Team of AIs

{
  "id": "foo",
  "created_at": "foo",
  "channel_id": "foo",
  "participant": {
    "type": "foo",
    "user_id": "foo"
  },
  "content": [
    {
      "type": "foo",
      "text": "foo"
    }
  ],
  "content_role": "user_message",
  "complete": true,
  "metadata": {},
  "invocation_config": {
    "planner_mode": true,
    "model_name": "foo",
    "mentions": [
      {
        "type": "agent",
        "id": "foo",
        "identifier": "foo",
        "identifier_type": "handle",
        "offset": 42,
        "length": 42
      }
    ],
    "voice_mode": true,
    "voice_id": "foo",
    "enable_avatar": true,
    "character_id": "foo",
    "force_collaboration": true,
    "collaboration_participant_ids": [
      "foo"
    ],
    "activity_id": "foo",
    "feed_activity_id": "foo",
    "use_reasoning_history": true,
    "thinking": true,
    "thinking_budget": 42,
    "enable_web_search": true,
    "enable_study_mode": true,
    "enable_scheduled_prompt_tools": true,
    "avoid_repetition": true,
    "enable_threads": true,
    "slash_skills": [
      "foo"
    ],
    "slash_only": true
  },
  "nested_interactions": [
    {
      "id": "foo",
      "created_at": "foo",
      "channel_id": "foo",
      "participant": {
        "type": "foo",
        "user_id": "foo"
      },
      "content": [
        {
          "type": "foo",
          "text": "foo"
        }
      ],
      "content_role": "user_message",
      "complete": true,
      "metadata": {},
      "invocation_config": {
        "planner_mode": true,
        "model_name": "foo",
        "mentions": [
          {
            "type": "agent",
            "id": "foo",
            "identifier": "foo",
            "identifier_type": "handle",
            "offset": 42,
            "length": 42
          }
        ],
        "voice_mode": true,
        "voice_id": "foo",
        "enable_avatar": true,
        "character_id": "foo",
        "force_collaboration": true,
        "collaboration_participant_ids": [
          "foo"
        ],
        "activity_id": "foo",
        "feed_activity_id": "foo",
        "use_reasoning_history": true,
        "thinking": true,
        "thinking_budget": 42,
        "enable_web_search": true,
        "enable_study_mode": true,
        "enable_scheduled_prompt_tools": true,
        "avoid_repetition": true,
        "enable_threads": true,
        "slash_skills": [
          "foo"
        ],
        "slash_only": true
      },
      "nested_interactions": [
        null
      ],
      "interaction_id": "foo",
      "span_id": "foo",
      "parent_span_id": "foo",
      "organization_id": "foo",
      "organization_application": "foo",
      "reactions": [
        {
          "interaction_id": "foo",
          "emoji": "foo",
          "count": 42,
          "reacted_by_me": true
        }
      ],
      "agent_read_receipts": [
        {
          "id": "foo",
          "message_event_id": "foo",
          "interaction_id": "foo",
          "agent_id": "foo",
          "read_at": "foo"
        }
      ]
    }
  ],
  "interaction_id": "foo",
  "span_id": "foo",
  "parent_span_id": "foo",
  "organization_id": "foo",
  "organization_application": "foo",
  "reactions": [
    {
      "interaction_id": "foo",
      "emoji": "foo",
      "count": 42,
      "reacted_by_me": true
    }
  ],
  "agent_read_receipts": [
    {
      "id": "foo",
      "message_event_id": "foo",
      "interaction_id": "foo",
      "agent_id": "foo",
      "read_at": "foo"
    }
  ]
}

Authentication

Authorizationstring

API Key authentication via header

Path parameters

interaction_idstringRequired

Response

Successful Response

idstringformat: "uuid"

The ID of the interaction.

created_atstringformat: "date-time"

The date and time the interaction was created.

channel_idstringformat: "uuid"

The ID of the channel.

participantobject

The participant that sent this interaction.

contentlist of objects

The content of the interaction.

content_roleenum

Whether the content is from a user message, intermediate agent reasoning, or final agent response.

completeboolean

Whether the interaction is complete. Incomplete interactions are only included when include_incomplete query parameter is True.

metadatamap from strings to any or null

Metadata for the interaction. Assistant agent_response messages may include display_artifacts (canonical artifact cards for this turn) and display_artifact_deletes (deleted artifact id and name pairs).

invocation_configobject or null

Typed user-driven invocation configuration for the turn (model, planner mode, voice, mentions, etc.). Null when no invocation config was set.

nested_interactionslist of objects or null

Nested interactions for this interaction. This will only be present when include_nested_interactions is True.

interaction_idstring or nullformat: "uuid"

Groups all events from a single user turn. Use this to group related messages.

span_idstring or nullformat: "uuid"

Unique identifier for this specific event in the interaction tree.

parent_span_idstring or nullformat: "uuid"

The span_id of the parent event, for hierarchical grouping.

organization_idstring or nullformat: "uuid"

The ID of the organization that owns the channel this interaction belongs to. Used for business intelligence filtering in Kibana.

organization_applicationstring or null

The application that created the organization (e.g., ‘flockx’, ‘asi_one’, ‘fetch_business’). Used for filtering interactions by product in Kibana.

reactionslist of objects or null

Emoji reaction summaries for this interaction.

agent_read_receiptslist of objects or null

Agent read receipts attached to the originating user message.

Errors

422

Unprocessable Entity Error

1	{
2	"id": "foo",
3	"created_at": "foo",
4	"channel_id": "foo",
5	"participant": {
6	"type": "foo",
7	"user_id": "foo"
8	},
9	"content": [
10	{
11	"type": "foo",
12	"text": "foo"
13	}
14	],
15	"content_role": "user_message",
16	"complete": true,
17	"metadata": {},
18	"invocation_config": {
19	"planner_mode": true,
20	"model_name": "foo",
21	"mentions": [
22	{
23	"type": "agent",
24	"id": "foo",
25	"identifier": "foo",
26	"identifier_type": "handle",
27	"offset": 42,
28	"length": 42
29	}
30	],
31	"voice_mode": true,
32	"voice_id": "foo",
33	"enable_avatar": true,
34	"character_id": "foo",
35	"force_collaboration": true,
36	"collaboration_participant_ids": [
37	"foo"
38	],
39	"activity_id": "foo",
40	"feed_activity_id": "foo",
41	"use_reasoning_history": true,
42	"thinking": true,
43	"thinking_budget": 42,
44	"enable_web_search": true,
45	"enable_study_mode": true,
46	"enable_scheduled_prompt_tools": true,
47	"avoid_repetition": true,
48	"enable_threads": true,
49	"slash_skills": [
50	"foo"
51	],
52	"slash_only": true
53	},
54	"nested_interactions": [
55	{
56	"id": "foo",
57	"created_at": "foo",
58	"channel_id": "foo",
59	"participant": {
60	"type": "foo",
61	"user_id": "foo"
62	},
63	"content": [
64	{
65	"type": "foo",
66	"text": "foo"
67	}
68	],
69	"content_role": "user_message",
70	"complete": true,
71	"metadata": {},
72	"invocation_config": {
73	"planner_mode": true,
74	"model_name": "foo",
75	"mentions": [
76	{
77	"type": "agent",
78	"id": "foo",
79	"identifier": "foo",
80	"identifier_type": "handle",
81	"offset": 42,
82	"length": 42
83	}
84	],
85	"voice_mode": true,
86	"voice_id": "foo",
87	"enable_avatar": true,
88	"character_id": "foo",
89	"force_collaboration": true,
90	"collaboration_participant_ids": [
91	"foo"
92	],
93	"activity_id": "foo",
94	"feed_activity_id": "foo",
95	"use_reasoning_history": true,
96	"thinking": true,
97	"thinking_budget": 42,
98	"enable_web_search": true,
99	"enable_study_mode": true,
100	"enable_scheduled_prompt_tools": true,
101	"avoid_repetition": true,
102	"enable_threads": true,
103	"slash_skills": [
104	"foo"
105	],
106	"slash_only": true
107	},
108	"nested_interactions": [
109	null
110	],
111	"interaction_id": "foo",
112	"span_id": "foo",
113	"parent_span_id": "foo",
114	"organization_id": "foo",
115	"organization_application": "foo",
116	"reactions": [
117	{
118	"interaction_id": "foo",
119	"emoji": "foo",
120	"count": 42,
121	"reacted_by_me": true
122	}
123	],
124	"agent_read_receipts": [
125	{
126	"id": "foo",
127	"message_event_id": "foo",
128	"interaction_id": "foo",
129	"agent_id": "foo",
130	"read_at": "foo"
131	}
132	]
133	}
134	],
135	"interaction_id": "foo",
136	"span_id": "foo",
137	"parent_span_id": "foo",
138	"organization_id": "foo",
139	"organization_application": "foo",
140	"reactions": [
141	{
142	"interaction_id": "foo",
143	"emoji": "foo",
144	"count": 42,
145	"reacted_by_me": true
146	}
147	],
148	"agent_read_receipts": [
149	{
150	"id": "foo",
151	"message_event_id": "foo",
152	"interaction_id": "foo",
153	"agent_id": "foo",
154	"read_at": "foo"
155	}
156	]
157	}

$	curl https://api.flockx.io/api/v1/interactions/interaction_id \
>	-H "Authorization: <apiKey>"