{"uid":"cap_WnrswHQvXsbudQutiGFHN","slug":"agents-gedx402-com-create-agent-session-ed132d71","name":"agents.gedx402.com – Create Agent Session","description":"Hosted agent session — pay per turn on Durable Objects. Omitted from default shard OpenAPI (jobs/agents/d1); use GET /v1/models?shard=agents.","url":"https://agents.gedx402.com/v1/agents/sessions","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"namespace":{"type":"string"}}},"responseSchema":{"type":"json","example":{"session_id":"550e8400-e29b-41d4-a716-446655440000","message_url":"https://agents.gedx402.com/v1/agents/sessions/550e8400-e29b-41d4-a716-446655440000/message"}},"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_udclVw4lM7WxMXwYuH9Ck","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":"Creates a new AI agent session via x402 micropayment (USDC), returning a session ID and message URL for subsequent interactions","exampleAgentPrompt":"Start a new AI agent session on gedx402, using the namespace 'myproject' so the agent can remember context across turns — I'll pay with USDC on Base.","exampleUseCases":[{"title":"Trustless customer support bot launch","prompt":"Initialize a new AI agent session for handling customer support tickets using x402 micropayments — I want to pay per interaction with USDC instead of managing API keys."},{"title":"Multi-turn debugging assistant via crypto","prompt":"Create an AI agent session that remembers conversation history across multiple turns so I can debug code issues iteratively — use my Base USDC wallet to handle micropayments automatically."},{"title":"Decentralized onboarding workflow setup","prompt":"Spin up a new namespaced agent session for user onboarding that maintains memory between conversation steps and accepts stablecoin payments on Arbitrum."}],"resultDescription":"A JSON object containing a unique session_id (UUID) and a message_url (HTTPS endpoint) that the agent can use to send follow-up messages to this session.","failureModes":["Payment not received or x402 payment header missing — returns 402 Payment Required","Invalid or malformed namespace string — may return 400 Bad Request","Session creation timeout on Workers AI backend — may return 503","Unsupported payment chain — returns error if chain not in Base/Polygon/Arbitrum/World/Solana set"],"whenToPreferThis":"Use this endpoint when you need to start a stateful AI agent session without traditional API keys, paying per-call with USDC via x402 micropayment protocol. Prefer this over standard LLM APIs when operating in a trustless, keyless crypto-payment environment or when you need namespaced agent memory across conversation turns.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:36:44.350Z","isFirstParty":false}