List agent mode conversation items

GET /api/2.0/genie/agents/{agent_id}/conversations/{conversation_id}/items

Lists a conversation's items in chronological order, with cursor pagination.

API scopes: genie

Path parameters

agent_idstringRequiredpath

The ID of the Genie agent.

conversation_idstringRequiredpath

The conversation ID.

Query parameters

limitintegerquery

Maximum number of items to return.

Default: 100

Constraints: 1 to 100

afterstringquery

Pagination cursor. Pass the previous response's last_id.

orderstringquery

Sort order. Use asc for oldest first or desc for newest first.

Default: asc

Values: asc, desc

Response

The response uses the application/json content type.

objectstring

Always "list".

Values: list

dataarray of object

The conversation's output items in chronological order. User input appears as a message whose ID has an _input suffix. Each item is polymorphic on type.

Show child attributesHide child attributes

reasoningobject

The agent's reasoning. Contains reasoning_text content items and a status.

function_callobject

An SQL query the agent ran. Contains call_id, the name "execute_sql", and arguments encoded as a JSON string. It is paired with function_call_output by call_id.

function_call_outputobject

The query result. Its ID is always {call_id}_output; when completed, output contains the query title followed by a Markdown table.

messageobject

A user question, assistant report, or system error. Assistant content contains output_text chunks; table chunks include metadata for columns, preview rows, total row count, status, and SQL.

first_idstring

ID of the first item in the page. Absent when data is empty.

last_idstring

ID of the last item in the page. Pass it as after for the next page. Absent when data is empty.

has_moreboolean

Whether more items follow this page.

statusstring

Status of the latest response in the conversation.

Errors

HTTP status	Error code	Description
400	INVALID_PARAMETER_VALUE	A query parameter is invalid, such as a limit outside the allowed range or an unknown order value.
403	PERMISSION_DENIED	The caller lacks CAN QUERY on the Genie agent.
404	NOT_FOUND	The Genie agent or conversation does not exist.
429	RATE_LIMIT_EXCEEDED	The per-workspace rate limit was exceeded.
500	INTERNAL_ERROR	An unexpected server error occurred.

View as Markdown

Response

{
  "object": "list",
  "data": [
    {
      "type": "message",
      "role": "user",
      "content": [
        {
          "type": "input_text",
          "text": "What were our top 10 customers by revenue last quarter?"
        }
      ],
      "id": "01f14fe4e34b..._input",
      "status": "completed"
    },
    {
      "type": "function_call",
      "id": "01f14fe4f24e...",
      "call_id": "01f14fe4f24e...",
      "status": "completed",
      "name": "execute_sql",
      "arguments": "{\"title\": \"Top 10 Customers\", \"sql\": \"SELECT customer, SUM(revenue) AS total FROM sales GROUP BY customer ORDER BY total DESC LIMIT 10\"}"
    },
    {
      "type": "function_call_output",
      "id": "01f14fe4f24e..._output",
      "call_id": "01f14fe4f24e...",
      "status": "completed",
      "output": "Top 10 Customers\n\n| customer | total |\n| --- | --- |\n| Acme Corp | 1500000 |"
    },
    {
      "type": "message",
      "id": "01f14fe5383f...",
      "role": "assistant",
      "status": "completed",
      "content": [
        {
          "type": "output_text",
          "text": "Acme Corp leads with $1.5M [1](https://<workspace-url>/genie/rooms/<space_id>/chats/<conversation_id>?o=<workspace_id>&gra_focus=<attachment_id>)."
        }
      ]
    }
  ],
  "first_id": "01f14fe4e34b..._input",
  "last_id": "01f14fe5383f...",
  "has_more": false,
  "status": "completed"
}