{"uid":"cap_dYqxDz4jm4zm6cr0RAp7Y","slug":"api-vectorway-io-77222329","name":"VectorWay Agent Onboard","description":"Onboard an autonomous AI agent in one x402 USDC payment: receive a chat completions API key, a USDC-funded balance, a JWT session, and persistent vector memory. Authenticates against a Gemini-backed LLM runtime with optional RAG-style memory recall + write per call, plus semantic memory search and delete. Wallet is derived from the signed payment; balance is atomic USDC ($0.000001/unit, max $1000).","url":"https://api.vectorway.io/v1/auth/agent-onboard","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"credits":{"type":"integer","maximum":1000000000,"minimum":1000,"description":"Atomic USDC to pre-fund the agent account with (1_000_000 = $1.00). The balance is debited per chat call against a Gemini-backed LLM runtime with optional RAG-style vector memory recall + write. Calls are billed by real input/output tokens × Vertex list prices × the operator's discount multiplier."},"key_name":{"type":"string","maxLength":64,"minLength":1,"description":"Optional human-readable label for the returned API key. The key authenticates the agent against the chat completions and memory endpoints; the label is shown in the Vectorway dashboard alongside the key id."},"agent_only":{"type":"boolean","description":"True (default) creates a headless agent-only account with no Privy email/social login, suitable for autonomous LLM agents. False allows the same wallet to later log into the dashboard via SIWE."}}},"responseSchema":{"type":"json","example":{"tokens":{"expires_in":900,"token_type":"bearer","access_token":"<jwt>","refresh_token":"<jwt>"},"api_key":"vw_<id>_<secret>","created":true,"credits":1000000,"agent_only":true,"wallet_address":"0xC0FFEE0000000000000000000000000000000001","api_key_metadata":{"key_id":"<id>","key_name":"my-agent","created_at":1730000000,"last_used_at":null}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"1000","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":"$1000/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"1000","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"1000","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_RXBSjxeyHY0IlenPwWon_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1000","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Onboards an autonomous AI agent via a $1 USDC x402 payment, returning a chat completions API key, funded USDC balance, JWT session, and persistent vector memory namespace derived from the payer wallet.","exampleAgentPrompt":"Onboard me as a new autonomous agent on VectorWay — pay the $1 USDC x402 fee and give me back an API key, a funded balance, a JWT session, and a persistent vector memory namespace tied to my wallet so I can start making Gemini-backed chat completions with memory recall.","exampleUseCases":[{"title":"Bootstrap agent with crypto wallet","prompt":"I need to spin up a new AI agent that can remember past conversations — use my wallet to pay the $1 USDC x402 fee through Vectorway and get me back an API key, JWT session, and a vector memory namespace so the agent can start chatting with Gemini and recall context across sessions."},{"title":"Fund agent runtime in one call","prompt":"Set up a fully funded, ready-to-run agent session for me on Vectorway — handle the USDC payment atomically, provision the OpenAI-compatible API key and balance, and make sure I have a persistent memory namespace tied to my wallet so I don't have to create any accounts or do any extra steps."},{"title":"Provision RAG-enabled LLM agent","prompt":"I want an autonomous agent that can do RAG-style memory recall without me having to manage any infrastructure — bootstrap it on Vectorway with a single x402 USDC payment, and return the API key, funded balance, JWT, and vector memory namespace so it can immediately start making context-aware Gemini completions."}],"resultDescription":"Returns a chat completions API key (OpenAI-compatible), a USDC-funded balance (in $0.000001 units, up to $1000), a JWT session token, and a persistent vector memory namespace derived from the signed payment wallet — enabling immediate authenticated calls to the Gemini LLM runtime with RAG-style memory.","failureModes":["Payment insufficient or invalid x402 signature — 402 Payment Required","Payment exceeds $1000 max balance cap — 400 Bad Request","Wallet derivation fails due to malformed signed payment — 400 Bad Request","Gemini backend unavailable — 503 Service Unavailable","Duplicate onboard attempt with same wallet — may return existing session or conflict error"],"whenToPreferThis":"Choose this endpoint when an autonomous agent needs a complete, self-contained bootstrap in a single atomic x402 payment — getting API key, funded balance, JWT, and vector memory namespace in one call without any prior account registration. Ideal for walletless-to-ready agent provisioning workflows where the payer wallet doubles as the persistent memory namespace.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:36:50.721Z","isFirstParty":false}