List | Flockx - Your Team of AIs

{
  "items": [
    {
      "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,
        "athena_mode": true,
        "model_name": "foo",
        "mentions": [
          {
            "type": "agent",
            "id": "foo",
            "identifier": "foo",
            "identifier_type": "handle",
            "offset": 42,
            "length": 42
          }
        ],
        "withheld_mentions": [
          {
            "type": "agent",
            "id": "foo",
            "identifier": "foo",
            "identifier_type": "handle",
            "offset": 42,
            "length": 42
          }
        ],
        "private_mention_requests": [
          {
            "twin_id": "foo",
            "outcome": "private_friend_request",
            "friendship_id": "foo",
            "channel_id": "foo",
            "owner_display_name": "foo"
          }
        ],
        "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,
        "reasoning_effort": "low",
        "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,
        "supports_tool_call_upsert": true
      },
      "nested_interactions": [
        null
      ],
      "interaction_id": "foo",
      "sequence": 42,
      "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,
          "target_role": "user",
          "reacted_by_agent": false,
          "reactor_names": [
            "foo"
          ],
          "target_sender_id": "foo"
        }
      ],
      "mention_invite_prompt_dismissed": false,
      "agent_read_receipts": [
        {
          "id": "foo",
          "message_event_id": "foo",
          "interaction_id": "foo",
          "agent_id": "foo",
          "read_at": "foo"
        }
      ]
    }
  ],
  "meta": {
    "total": 42,
    "has_next": true,
    "has_previous": true,
    "page": 42,
    "next_cursor": "foo"
  }
}

List interactions for a user.

Authentication

Authorizationstring

API Key authentication via header

Query parameters

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.

start_timestring or nullOptionalformat: "date-time"

Timestamp for the earliest interaction to include. When unset, history extends to the channel's oldest row.

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.

around_sequenceinteger or nullOptional

Return a window of messages centered on this per-channel sequence. Mutually exclusive with before_sequence and after_sequence. Requires channel_id. end_time is still required but ignored.

before_sequenceinteger or nullOptional

Return messages with sequence strictly less than this value. Replaces page offset. Requires channel_id.

after_sequenceinteger or nullOptional

Return messages with sequence strictly greater than this value. Replaces page offset. Requires channel_id.

include_tool_progressbooleanOptionalDefaults to false

Include the latest in-flight tool progress update per running tool call as ephemeral tool_call_update interactions on the first page. Off by default; responses are unchanged unless requested.

Response

Successful Response

itemslist of objects

metaobject

Errors

422

Unprocessable Entity Error