Classify an activity message without persisting it

POST/v1/threads/{threadId}/activity/classify

Deterministically preflight an attachment-free message so clients can choose the communicator activity endpoint, legacy worker follow-up queue, or legacy control path without creating duplicate messages, runs, or deliveries.

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

Content type: application/json · Required

FieldTypeRequiredDescription
contentstringYesRaw text content.
runIdstringNo
replyToRunIdstringNo
modecheckpoint | interrupt | fyiNo
targetTypestringNo

What the API returns

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

200Non-persisted routing classification and suggested transportapplication/json
None.
Classify an activity message without persisting it
Loading...
Response 200
Loading...
See the ACP quickstart and SDK flow