SIsignalshq
CPA CHAT

Send a CPA chat message and run one agent turn.

post/internal/api/cpa-chat/messages

Request

  • Base URL
    https://api.signalshq.io (the document declares no server; this is the origin it was published from)
  • Auth
    OAuth 2
    Password
    Token URL: /auth/login

Request body

client_idstring uuid required
tax_yearinteger
messagestring required

Free-text user message.

selected_option_idstring nullable

When the prior turn was a ClarificationRequest, the id of the option the CPA picked. Mutually compatible with message (free-text addendum).

expected_clarification_versioninteger nullable

Monotonic clarification version the client expects to resolve. If the server's version is higher, another caller (e.g. second browser tab) already resolved the pending clarification — the router returns 409 StaleClarificationReply.

Response

Successful Response

outcome_kindstring required

answer | clarification

narrativestring nullable
questionstring nullable
iterationsinteger required
tool_calls_madeinteger required
tokens_ininteger required
tokens_outinteger required
cache_read_tokensinteger
elapsed_msinteger required
conversation_idstring uuid required
correlation_idstring required
raw_outcomeobject required

Full TurnOutcome JSON for clients that want the canonical shape.

Changes

No recorded changes to this operation across all 1 revision of this API.