{"uid":"cap_xqz5-zo76fqdDrxJt_-4o","slug":"forgemesh-api-call-shapes-lookup-beea3f15","name":"ForgeMesh API Call Shapes Lookup","description":"Returns the complete set of call shapes (routes, methods, input schemas, worked examples, prices) for a named ForgeMesh x402 service, so an agent can construct a correct request without probing the live API first. Required `product` — an id or name from fleet-products; unmatched values list the valid options.","url":"https://x402.forgemesh.io/api-call-shapes","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"product":{"type":"string","description":"Required: product id or name from fleet-products, e.g. \"imagegen\" or \"voice\""}}},"responseSchema":{"type":"json","example":{"product":{"id":"imagegen","host":"imagegen.coinopai.com","name":"AI Image Generation","summary":"Paid AI image generation via x402. Text-to-image, background removal, 4x HD upscaling.","category":"media","endpoints":[{"price":"$0.250000","route":"/generate","method":"GET","example":null,"description":"Standard AI image generation. Requires x402 payment of 0.25 USDC on Base.","input_schema":[{"in":"query","name":"prompt","schema":{"type":"string"},"required":true,"description":"Natural language image description"},{"in":"query","name":"aspect","schema":{"enum":["1:1","16:9","9:16","4:3"],"type":"string","default":"1:1"},"required":false,"description":"Aspect ratio"}]}],"price_range":{"max":0.75,"min":0.25},"route_count":4},"generated_at":"2026-07-17T11:53:32.075Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_M6NjxfnpPW07EW5ggvQPO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the complete route definitions, input schemas, worked examples, and pricing for a named ForgeMesh x402 service so an agent can construct correct API calls without live probing.","exampleAgentPrompt":"What are the exact routes, input schemas, and worked examples for the ForgeMesh 'imagegen' x402 service — I need to know how to call it correctly before making a live request.","exampleUseCases":null,"resultDescription":"A structured document containing all call shapes for the requested ForgeMesh product: the available routes, HTTP methods, input schemas with field descriptions, worked request/response examples, and per-call pricing. If the product name is unrecognized, the response lists the valid product options instead.","failureModes":["Unrecognized product name/id — returns list of valid options instead of call shapes","Missing required 'product' field — likely returns an error or empty response","Product exists but has no documented call shapes yet — may return empty or partial data","Network or payment failure — x402 payment of $0.05 USDC required per call"],"whenToPreferThis":"Use this endpoint when an AI agent needs to introspect a ForgeMesh x402 service before calling it — to understand its routes, required parameters, and pricing without trial-and-error probing. Prefer this over generic API documentation lookups when the target service is a ForgeMesh x402 product specifically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:46:37.112Z","isFirstParty":false}