TRtrademeai
v1

Send a JSON-RPC request

Changed on

The single entry point for a session and for talking to the assistant. Set method to initialize (open a session), notifications/initialized (confirm it), message/send (send the member's message) or action/invoke (run a button's action; v1alpha1 only). See the request examples for each. Send the Anvil-Session-Id header returned by initialize on the other calls.

Any request that reaches this endpoint answers HTTP 200. Success carries result and failure carries error.

Error bodies are described in the error contract.

post/api/v1/assistant/trademe/conversations/{conversation_id}/rpc

Request

Path parameters

conversation_idstring required

Headers

Anvil-Session-Idstring nullable
authorizationstring nullable

Request body

jsonrpc'2.0' required
methodstring required
paramsobject nullable

Response

JSON-RPC 2.0 response. HTTP status is always 200 for any request that reaches the dispatcher; success vs error is signalled by the presence of result vs error in the body. On error, error.code is one of: -32600 Invalid Request, -32602 validation, -32001 quota, -32002 safety, -32003 rate_limit, -32004 action, -32603 internal. See the error contract reference for envelope shape and per-category data.kind registry. Non-200 responses (401/403 auth, 422 malformed body, 404 unknown route, 429 edge rate-limit/capacity) are resolved before the JSON-RPC envelope exists and are not part of this body contract.

jsonrpc'2.0'

Changes

  • 1164c8a5c534Revision changes
    • breaking

      added to the ///// response property oneOf list for the response status

    • breaking

      added to the //////// response property oneOf list for the response status

    • info

      added watchlist_toggle discriminator mapping keys to the ///// response property for the response status

    • info

      added watchlist_toggle discriminator mapping keys to the //////// response property for the response status

  • 4e5bd3197d6dRevision changes
    • breaking

      added to the ///// response property oneOf list for the response status

    • breaking

      added to the //////// response property oneOf list for the response status

    • info

      added text_input discriminator mapping keys to the ///// response property for the response status

    • info

      added text_input discriminator mapping keys to the //////// response property for the response status