{"uid":"cap_qy2Y58fDdqVn0YK337-1G","slug":"three-ws-x402-notification-endpoint-379fce49","name":"three.ws x402 Notification Endpoint","description":"Make a 3D AI agent from a selfie in 60 seconds. Drop one HTML tag to embed it on any website. Agents think on IBM watsonx.ai (Granite); optionally charge per chat with built-in micropayments.","url":"https://three.ws/api/x402/notify?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"channel":{"enum":["canary","ops","system"],"type":"string","default":"canary","description":"Delivery channel. \"canary\" is the autonomous-loop heartbeat lane."},"message":{"type":"string","default":"x402 loop heartbeat","maxLength":500,"description":"Notification message body."},"priority":{"enum":["low","normal","high"],"type":"string","default":"low","description":"Delivery priority hint."}}},"responseSchema":{"type":"json","example":{"ts":"2026-06-28T10:00:00Z","payer":null,"channel":"canary","message":"x402 loop heartbeat","priority":"low","delivered":true,"latency_ms":18,"notification_id":"a3f3d6c2-1f1b-4f10-9b6c-1b1f5e0c9c34"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_uEzUbJi9W8ttQ_06Cmi1i","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Sends a notification message to a specified delivery channel (canary, ops, or system) with a priority hint, returning delivery confirmation and latency metadata.","exampleAgentPrompt":"Send a normal-priority notification to the ops channel with the message 'Agent loop healthy — all systems nominal'.","exampleUseCases":[{"title":"Autonomous agent loop heartbeat","prompt":"Send a low-priority heartbeat ping to the canary channel with the message 'x402 loop heartbeat' so my autonomous agent loop stays alive."},{"title":"High-priority ops alert","prompt":"Send a high-priority notification to the ops channel saying 'Payment processor timeout detected — investigate immediately'."},{"title":"System event announcement","prompt":"Notify the system channel with normal priority that 'New 3D agent deployment completed for client workspace #42'."}],"resultDescription":"Returns a JSON object confirming delivery with fields: notification_id (UUID), delivered (boolean), latency_ms (integer), ts (ISO 8601 timestamp), channel, message, priority, and payer (null if no payer context).","failureModes":["Message exceeds 500 character limit — request rejected with validation error","Invalid channel enum value — must be 'canary', 'ops', or 'system'","Invalid priority enum value — must be 'low', 'normal', or 'high'","Payment not provided or insufficient USDC — x402 payment required before delivery","Delivery failure — delivered: false returned with latency_ms still populated","Network timeout to downstream notification system"],"whenToPreferThis":"Choose this endpoint when you need to send lightweight, real-time notifications within the three.ws 3D agent ecosystem — especially for autonomous loop heartbeats (canary channel), operational alerts (ops channel), or system-level events. It is particularly suited for agentic workflows that require x402 micropayment-gated messaging and need delivery confirmation with latency telemetry.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T12:32:53.875Z","isFirstParty":false,"canonicalSlug":"three-ws-x402-notification-endpoint-379fce49"}