{"uid":"cap_RppzSXuQDkK9RiQ100ELn","slug":"cueframe-composition-validate-2b20d8a6","name":"CueFrame Composition Validate","description":"Validate a composition body without saving it (dry-run)","url":"https://api.cueframe.ai/v1/composition/validate","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"properties":{}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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_Sv4up7aP6KPj3dnzzJ2Tm","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Dry-run validates a composition body against CueFrame's schema rules without saving or executing it","exampleAgentPrompt":"Before I save this composition, can you dry-run validate it to make sure the body is correct? It's a JSON body sent via POST — here's the composition payload I want to check.","exampleUseCases":[{"title":"Pre-flight check before composition save","prompt":"I've written a composition payload and want to validate it before actually saving it — can you run a dry-run validation on this JSON body so I can catch any errors first?"},{"title":"Debug a failing composition submission","prompt":"My composition keeps getting rejected when I try to submit it. Can you validate the body to tell me exactly what's wrong with the structure or fields?"},{"title":"CI pipeline composition schema check","prompt":"As part of our automated pipeline, validate this composition body against CueFrame's rules before we send it to production — it's a JSON POST body and we just need to know if it passes."}],"resultDescription":"Returns a validation outcome indicating whether the composition body is valid or contains errors; on failure, includes details about which fields or rules were violated so the caller can fix the payload before committing it.","failureModes":["Invalid composition body returns validation errors with field-level details","Missing required fields (type, method, bodyType, body) returns a 400-style error","Unsupported HTTP method (not POST/PUT/PATCH) causes a validation rejection","Unsupported bodyType (not json/form-data/text) triggers a schema error","Malformed JSON in the body may cause a parse error before validation runs","Payment failure (x402 protocol) prevents the call from executing"],"whenToPreferThis":"Use this endpoint when you want to check a composition body for correctness before committing it — ideal for CI pipelines, form pre-validation, debugging rejected submissions, or any workflow where you want to catch errors cheaply without side effects. Prefer this over directly calling the composition creation endpoint when you're uncertain about payload structure.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:40:12.912Z","isFirstParty":false}