{"uid":"cap_kbwWqI_2M8tWr9pX25C57","slug":"spraay-gateway-session-auth-d3982c5f","name":"Spraay Gateway Session Auth","description":"Create authenticated session with scoped permissions.","url":"https://gateway.spraay.app/api/v1/auth/session","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"address":{"type":"string"},"ttlSeconds":{"type":"number"},"permissions":{"type":"array"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Aq14v_2R-gVlYyCRunNCz","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Creates an authenticated session with scoped permissions for a given wallet address, returning a token valid for a specified duration.","exampleAgentPrompt":"Create an authenticated session on the Spraay gateway for wallet address 0xAbC123... with a 3600-second TTL and permissions for payroll and inference, so I can start making API calls.","exampleUseCases":[{"title":"Agent pre-flight authentication","prompt":"Before running any Spraay API calls, create a session for my wallet 0xDe...F1 that lasts 1800 seconds and has permissions scoped to email notifications and OFAC screening only."},{"title":"Short-lived token for AI inference","prompt":"Spin up a Spraay gateway session for address 0xAaB2... with a 600-second TTL and GPU inference permissions so my agent can run a quick Replicate model call."},{"title":"Payroll execution session setup","prompt":"I need to authorize a Spraay session for wallet 0x99...CC with a 7200-second lifetime and full payroll permissions so I can execute this week's payroll run."}],"resultDescription":"Returns a session token or credential object scoped to the specified permissions, valid for the requested TTL. The agent can use this token to authenticate subsequent calls to other Spraay gateway endpoints without re-authorizing.","failureModes":["Invalid or malformed wallet address returns a 400 error","Unsupported or unrecognized permission scopes may be rejected","TTL value out of acceptable range returns validation error","Expired or revoked session if used after TTL has elapsed","Payment failure (x402) if USDC balance is insufficient or not pre-authorized"],"whenToPreferThis":"Use this endpoint as the first step before calling any other Spraay gateway API that requires authentication. It is the canonical session-creation mechanism for the Spraay ecosystem, producing scoped tokens that gate access to payroll, inference, email, sanctions screening, and RPC endpoints on the same gateway.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T05:58:54.564Z","isFirstParty":false}