Model

List conversation items

List a conversation's items.

Call Create conversation first, then replace conv_123 with the returned conv_ ID.

GET /model/v1/conversations/{conversation_id}/items● Supported

Official docs ↗

Request parameters

  • conversation_idstring必填

    path: Id of the conversation, the `id` of the object returned by createConversation (it looks like conv_...). Another tenant's conversation, an unknown id and a deleted conversation all answer 404 conversation_not_found.

  • limitinteger可选
    默认 20

    query: Maximum items per page (values above 100 are clamped).

  • afterstring可选

    query: Item ID from the previous page; returns items after this cursor.

  • orderstring可选
    默认 "desc"

    query: Sort by stored creation order.

    取值 ascdesc

Returns

200 list

Lists a conversation's items in creation order, with limit/after/order pagination.

Platform errors (auth, rate limits, validation) and OCR errors use problem+json; other model call errors follow the endpoint's own format (OpenAI or Anthropic) — see error codes

Response

HTTP 200

The conversation's items

application/json

NameTypeDescription
objectstringObject type; always `list`.
dataarray<object>Items of the conversation, in the order the list requested.
first_idstringId of the first item of this page; null for an empty page.
last_idstringId of the last item of this page; null for an empty page.
has_morebooleanWhether more items exist beyond this page; pass `last_id` as `after` to read them.