{"uid":"cap_232wqKPiUukj4ObDZXhro","slug":"aiskills402-openapi-operation-object-from-an-example-call-3d217966","name":"AISkills402: OpenAPI Operation Object From An Example Call","description":"OpenAPI Operation Object From An Example Call — Writes one OpenAPI 3.1 operation object, as bare JSON, from an example request, an example response and rules given in words - parameters with the right location, requirement flag and type, a request body, and a response per status the person actually showed. Uses the 3.1 forms, not the 3.0 ones - a field that may be null is a type list with \"null\" (never nullable), a path parameter is always required, a status is a quoted key, an identifier writt…","url":"https://api.aiskills402.com/v1/skills/openapi-operation-from-example/file?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD"],"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"file":{"name":"SKILL.md","content":"<the SKILL.md file>","encoding":"utf-8"},"name":"OpenAPI Operation Object From An Example Call","skill":"openapi-operation-from-example","sha256":"<sha256 of SKILL.md>","receipt":{"tx":"0x<settlement transaction>","settled":true},"version":"1.0.0","redownload":{"url":"<api>/v1/purchases/<token>","token":"<64 hex chars>"}}},"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_6DYBIVIsy3Z7kaJuY_BCD","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":"Downloads a SKILL.md file that teaches an AI agent how to generate an OpenAPI Operation Object from an example HTTP call, purchased once via x402 micropayment in USDC on Base.","exampleAgentPrompt":"Buy me the 'openapi-operation-from-example' SKILL.md file from AISkills402 using a GET request so I can teach you how to generate OpenAPI Operation Objects from real example API calls.","exampleUseCases":[{"title":"Auto-document a new REST API","prompt":"I've been calling a third-party API by hand and I want you to learn how to write proper OpenAPI Operation Objects from those example requests — can you purchase the openapi-operation-from-example skill from AISkills402 so you can do that for me going forward?"},{"title":"Bootstrap an OpenAPI spec from curl examples","prompt":"I have a bunch of example curl commands and I need you to turn them into OpenAPI operation definitions — go buy the SKILL.md that teaches you how to do that from AISkills402 using a GET request."},{"title":"Equip an agent pipeline with OpenAPI generation","prompt":"Our agent pipeline needs to be able to produce OpenAPI Operation Objects automatically from HTTP call examples — please purchase and download the openapi-operation-from-example skill file from AISkills402 so we can wire it in."}],"resultDescription":"Returns a JSON object containing the SKILL.md file (name, UTF-8 content, SHA256 hash), the skill's name and identifier, a version string, a blockchain settlement receipt with transaction hash, and a redownload URL and token for future free re-downloads of the same or updated versions.","failureModes":["Payment not settled on Base — transaction pending or failed, receipt shows settled:false","Invalid or missing required input fields (type or method) — 400 Bad Request","Method not allowed — only GET and HEAD are accepted","Insufficient USDC balance to cover $0.01 micropayment via x402","Network timeout during blockchain settlement","Redownload token expired or invalid when re-fetching"],"whenToPreferThis":"Choose this endpoint when an AI agent needs a tested, reusable SKILL.md instruction file specifically for generating OpenAPI Operation Objects from example HTTP calls, and you want a one-time purchase model with permanent ownership and free re-downloads rather than a subscription or per-use API. Ideal for agent pipelines that need to self-document APIs or scaffold OpenAPI specs from live traffic.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-22T18:48:32.636Z","isFirstParty":false,"canonicalSlug":"aiskills402-openapi-operation-object-from-an-example-call-3d217966"}