# Content Disposition Parse

> Content Disposition Parse is a paid API for AI agents from api.delx.ai, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Parses an HTTP Content-Disposition header to extract disposition type, filename, and safe parameters deterministically without external dependencies.

## Facts

- Endpoint: POST https://api.delx.ai/api/v1/x402/content-disposition-parse
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/content-disposition-parse-205f535e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xqzHoQh6T4Vqz4F5m5aZo

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 content-disposition-parse-205f535e -d '<json body>'
```

Example prompt: Parse this Content-Disposition header for me and tell me the disposition type, filename, and whether it passes safety checks: 'attachment; filename="report_2024.pdf"; filename*=UTF-8''report_2024.pdf'

## When to prefer this

Use this endpoint when an AI agent or pipeline needs to safely parse and validate a caller-supplied or server-returned Content-Disposition HTTP header before acting on it (caching, redirecting, downloading, or retrying). It is deterministic, stateless, and processes data in-memory without retention, making it suitable for security-sensitive pipelines. Prefer this over manual parsing when you need a normalized, versioned JSON finding with an explicit safety status rather than raw header string splitting.

## Known failure modes

- Header string exceeds 8192 character limit — request rejected
- Malformed or unparseable header value — advisory/fail status returned with partial findings
- Empty header input — returns advisory status with no extracted fields
- Payment not included or insufficient — x402 payment required error

## How this service works

Content Disposition Parse: Content Disposition Parse extracts disposition type, filename, and safe parameters from bounded caller-supplied values without an external provider. Call Content Disposition Parse before accepting, caching, redirecting, or retrying a caller-supplied web response. Returns normalized web evidence, the computed finding, and an explicit pass or advisory status for Content Disposition Parse as versioned deterministic JSON. Price: $0.001 USDC via x402 on Base. First-party,…

## Output

Returns versioned deterministic JSON containing: normalized representation of the input header, computed finding (extracted disposition type, filename, and safe parameters), and an explicit pass or advisory status indicating whether the header is safe to proceed with.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "header": {
   "type": "string",
   "maxLength": 8192,
   "description": "Header supplied to Content Disposition Parse; used only for this bounded calculation and processed in memory without retention."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {
   "value": "attachment",
   "parameters": {
    "filename": "report.csv"
   }
  },
  "schema": "delx/util-content-disposition-parse/v1",
  "status": "pass",
  "evidence": {
   "retained": false,
   "input_sha256": "51f2b47182084fb3d000affd2a526acd9dd50f69e5ab61be18bb0d0cca2fed19",
   "external_calls": 0
  },
  "operation": "web_reliability:content_disposition_parse"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/content-disposition-parse-205f535e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.delx.ai](https://www.zero.xyz/host/api.delx.ai/llms.txt)