TRtrademeai
v1beta1

List artifacts

Changed on

Returns the current version of each artifact in the conversation, most recently changed first. By default only artifacts the member has been shown are returned, and only documents the assistant wrote with the member. Add include_unpresented=true for artifacts the member has not seen yet, and include_snapshots=true for the copies of search results, listings and similar data the assistant collects along the way.

get/api/v1beta1/assistant/trademe/conversations/{conversation_id}/artifacts

Request

Path parameters

conversation_idstring required

Query parameters

include_unpresentedboolean

Include artifacts that have never been surfaced to the member. Defaults to false: this endpoint returns ONLY artifacts with a presentedAt timestamp, so an in-progress draft the assistant has not shown yet cannot appear in a member's list.

include_snapshotsboolean

Also include SNAPSHOT-provenance artifacts — the search results, property cards, listing summaries, crisis resources and reply offers a conversation accumulates as its tools run. Defaults to false: the member-facing view of this endpoint is the AUTHORED documents, and the snapshots are machinery. Set it to watch that machinery work, which is what the assistant app's artifacts sidebar does behind its 'show machinery' toggle.

Headers

authorizationstring nullable
accept-nodesstring[] nullable

Optional. The node types and versions the app can render, in the format GET /messages takes. A card's actions are served only to an app that declares non_binding_action:1, and only on v1alpha1. Omitted = nothing declared, so no actions.

Response

Successful Response

Changes