Review a thread owner’s visible messages before sharing

GET/v1/packages/thread-previews/{threadId}

Only the thread owner can preview. At most 200 user/assistant messages; excludes logs, system context, tools, attachments and metadata. Does not grant access to the original thread.

How to call this endpoint

Every ACP API request uses bearer authentication. The examples here show the actual request path, auth header, and body shape that the platform expects.

Path, query, and header parameters

These parameters control which ACP object the endpoint acts on and how the request is processed.

Path parameters
NameLocationTypeRequiredDescription
threadIdpathstringYes—
Query parameters
None.

Body schema

This endpoint does not require a request body.

None.

What the API returns

Each response code below includes the documented payload shape for the ACP API.

200Package operation resultapplication/json
FieldTypeRequiredDescription
messagesobject[]Yes—
messages[].idstringYesUnique identifier.
messages[].roleuser | assistantYes—
messages[].contentstringYesRaw text content.
messages[].createdAtstringYesISO 8601 timestamp.
400Package request rejected. HTTP status distinguishes invalid input (400), authentication (401), API scope (403), unavailable resource (404), changed revision or confirmation (409), and unsupported storage (503).application/json
FieldTypeRequiredDescription
errorstringNo—
codestringNo—
messagestringNoMessage text.
401Package request rejected. HTTP status distinguishes invalid input (400), authentication (401), API scope (403), unavailable resource (404), changed revision or confirmation (409), and unsupported storage (503).application/json
FieldTypeRequiredDescription
errorstringNo—
codestringNo—
messagestringNoMessage text.
403Package request rejected. HTTP status distinguishes invalid input (400), authentication (401), API scope (403), unavailable resource (404), changed revision or confirmation (409), and unsupported storage (503).application/json
FieldTypeRequiredDescription
errorstringNo—
codestringNo—
messagestringNoMessage text.
404Package request rejected. HTTP status distinguishes invalid input (400), authentication (401), API scope (403), unavailable resource (404), changed revision or confirmation (409), and unsupported storage (503).application/json
FieldTypeRequiredDescription
errorstringNo—
codestringNo—
messagestringNoMessage text.
409Package request rejected. HTTP status distinguishes invalid input (400), authentication (401), API scope (403), unavailable resource (404), changed revision or confirmation (409), and unsupported storage (503).application/json
FieldTypeRequiredDescription
errorstringNo—
codestringNo—
messagestringNoMessage text.
503Package request rejected. HTTP status distinguishes invalid input (400), authentication (401), API scope (403), unavailable resource (404), changed revision or confirmation (409), and unsupported storage (503).application/json
FieldTypeRequiredDescription
errorstringNo—
codestringNo—
messagestringNoMessage text.
Review a thread owner’s visible messages before sharing
Loading...
Response 200
Loading...
See the ACP quickstart and SDK flow