{"uid":"cap_yyeDjStUFU8SDIKJxJvPY","slug":"arch-tools-session-message-94018ac0","name":"Arch Tools — Session Message","description":"Arch Tools — session-message","url":"https://archtools.dev/v1/tools/session-message","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"message":{"type":"string","description":"User message to send"},"session_id":{"type":"string","description":"Session ID from session-create"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_p0MLDKrAE_CYZ_Dd0xPRz","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Sends a user message to an existing AI session and retrieves a response, enabling multi-turn conversational interactions.","exampleAgentPrompt":"Continue my Arch Tools session (session ID 'abc-123') and send the message: 'What are the next steps based on what we discussed?'","exampleUseCases":[{"title":"Multi-turn customer support agent","prompt":"My Arch Tools session ID is 'sess-7f2a'. Send the message 'Can you clarify the refund policy you mentioned earlier?' and get the response."},{"title":"Iterative data extraction workflow","prompt":"I have an ongoing Arch Tools session 'wf-session-99'. Send it the message 'Now extract the phone numbers from the second paragraph' and return what it says."},{"title":"Conversational research assistant follow-up","prompt":"Using my active Arch Tools session 'research-44b', ask it 'Can you summarize the key risks you identified so far?' and show me the reply."}],"resultDescription":"A JSON object containing the AI-generated response to the user message within the specified session, reflecting the current conversational context accumulated across session turns.","failureModes":["Invalid or expired session_id returns an error indicating the session does not exist","Missing required 'message' or 'session_id' fields returns a 400-level validation error","Session timeout or expiry may return a session-not-found or unauthorized error","Empty or malformed message string may result in an error or empty response","Payment failure (insufficient USDC balance) blocks the request with a 402 error"],"whenToPreferThis":"Use this endpoint when you have an active session created via session-create and need to send follow-up messages in a stateful, multi-turn conversation. It is ideal for workflows that require context continuity across multiple interactions, such as iterative data extraction, guided reasoning, or conversational agents. Prefer this over stateless endpoints when session history and context must be preserved between calls.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:42:33.013Z","isFirstParty":false}