{"uid":"cap_uJzfCRgHiRv_1-yHW5d-o","slug":"obol-api-code-generation-description-to-openapi-hono-server-pr-64a1939c","name":"Obol API Code Generation — Description to OpenAPI + Hono Server PR","description":"Obol: Description → OpenAPI spec + Hono server → GitHub PR — $5 USDC","url":"https://api.obol.sh/api?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["repo","description"],"properties":{"repo":{"type":"string","description":"Target GitHub repo in owner/repo format"},"email":{"type":"string","description":"Email address to notify when PR is ready"},"description":{"type":"string","description":"Plain-English description of the API (e.g. \"REST API for a todo app with auth and CRUD\")"}}},"responseSchema":{"pr":{"type":"string","description":"URL of the opened pull request"},"fork":{"type":"string","description":"URL of the forked repository"},"files":{"type":"array","description":"File paths written to the branch"},"branch":{"type":"string","description":"Branch name on the fork"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"5","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":"$5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_X6byFY5pg6eTSufc1TDcX","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"5","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Generates an OpenAPI spec and Hono server implementation from a plain-English API description and opens a GitHub pull request with the result","exampleAgentPrompt":"Can you generate an OpenAPI spec and Hono server for a REST API for a todo app with auth and CRUD operations, then open a pull request on my GitHub repo acme-org/todo-api? Notify me at dev@acme.com when it's ready.","exampleUseCases":[{"title":"Scaffold new microservice from description","prompt":"I need to build a microservice for handling user notifications — it should support creating, reading, updating, and deleting notification preferences, plus an endpoint to send notifications via email or SMS. Can you generate an OpenAPI spec and Hono server for it and open a pull request on my repo acme-org/notifications-service?"},{"title":"Auto-generate e-commerce API boilerplate","prompt":"We're starting a new e-commerce backend and I need a REST API that handles products, inventory, orders, and payments. Can you take that description, generate a full OpenAPI spec and Hono TypeScript server scaffold, and submit it as a pull request to our GitHub repo acme-org/shop-api so the team can review it?"},{"title":"Generate API spec for internal analytics","prompt":"I want to expose an internal analytics API that lets teams query event counts, funnel metrics, and retention data filtered by date range and user segment. Please generate an OpenAPI spec and a Hono server implementation from that description and open a PR on acme-org/analytics-api for me to review."}],"resultDescription":"Returns the URL of the opened pull request on a fork of the target repo, the fork URL, the branch name, and a list of file paths written — including the generated OpenAPI spec and Hono server files.","failureModes":["Invalid or inaccessible GitHub repo (owner/repo not found or no permissions) — PR creation fails","Insufficient payment or payment not sent via x402 protocol — 402 response returned","Malformed or too-vague description causing generation to fail — partial or empty file output","Invalid email format causing notification delivery failure","GitHub API rate limiting or downtime preventing fork or PR creation"],"whenToPreferThis":"Choose this endpoint when you need to go from a plain-English API description to a working OpenAPI spec plus a Hono TypeScript server scaffold, delivered directly as a GitHub PR. Prefer this over generic code generation tools when you want the result committed to a specific repository automatically rather than returned as raw text.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T00:28:09.214Z","isFirstParty":false,"canonicalSlug":"obol-api-code-generation-description-to-openapi-hono-server-pr-64a1939c"}