# CueFrame Composition Validate

> CueFrame Composition Validate is a paid API for AI agents from api.cueframe.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Dry-run validates a composition body against CueFrame's schema rules without saving or executing it

## Facts

- Endpoint: POST https://api.cueframe.ai/v1/composition/validate
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/cueframe-composition-validate-2b20d8a6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RppzSXuQDkK9RiQ100ELn

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability cueframe-composition-validate-2b20d8a6 -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Validate a composition body without saving it (dry-run)

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cueframe-composition-validate-2b20d8a6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.cueframe.ai](https://www.zero.xyz/host/api.cueframe.ai/llms.txt)
