Get detailed thread context state

GET/v1/threads/{threadId}/context/details

Return detailed native Claude context information when available, with an estimate fallback.

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
threadIdpathstringYesThread ID
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.

200Detailed thread context stateapplication/json
FieldTypeRequiredDescription
contextobjectNo
context.threadIdstringNoThread ID.
context.sessionIdstringNoSession ID.
context.modelstringNoModel identifier.
context.maxTokensintegerNo
context.usedTokensintegerNo
context.remainingTokensintegerNo
context.remainingRationumberNo
context.sourcestringNo
context.exactbooleanNo
context.categoriesobject[]No
context.categories[].keysystem_prompt | skills | messages | free_space | autocompact_buffer | otherNo
context.categories[].labelstringNo
context.categories[].tokensintegerNo
context.categories[].rationumberNo
context.categories[].kindused | free | buffer | otherNo
context.rawTextstringNo
context.estimateobjectNo
context.estimate.threadIdstringNoThread ID.
context.estimate.sessionIdstringNoSession ID.
context.estimate.modelstringNoModel identifier.
context.estimate.maxTokensintegerNo
context.estimate.usedTokensintegerNo
context.estimate.remainingTokensintegerNo
context.estimate.remainingRationumberNo
context.estimate.sourcestringNo
context.estimate.exactbooleanNo
context.estimate.messageCountintegerNo
context.estimate.lastMessageAtstringNo
context.estimate.updatedAtstringNoISO 8601 timestamp.
availableActionsobjectNo
availableActions.compactbooleanNo
availableActions.clearbooleanNo
availableActions.btwbooleanNo
availableActions.forkbooleanNo
nativeErrorstringNo
Get detailed thread context state
Loading...
Response 200
Loading...
See the ACP quickstart and SDK flow