> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zdlake.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Versioning

> Pin requests to the current Zero API contract.

Zero currently supports one public API contract: `2026-08-19`.

Requests without `X-API-Version` use that contract. Send the header when you want the request to state its expected version explicitly.

```bash theme={null}
curl "https://api.zdlake.com/search" \
  -H "X-API-Version: 2026-08-19" \
  -H "Content-Type: application/json" \
  -d '{"q":"log4j"}'
```

Every response includes the version used to process the request.

```http theme={null}
X-API-Version: 2026-08-19
```

## Unsupported versions

Any other value returns `400 BAD_REQUEST`.

```json theme={null}
{
  "type": "https://docs.zdlake.com/api/errors#bad-request",
  "title": "Bad Request",
  "status": 400,
  "detail": "Unsupported API version",
  "code": "BAD_REQUEST",
  "request_id": "req_01JABCD123",
  "errors": {
    "version": ["Supported value: 2026-08-19"]
  }
}
```

## Contract changes

Zero may add fields, enum values, endpoints, and optional response sections without changing the version. Clients should ignore unknown response fields.

A future breaking contract will use a new dated version. No older public version is currently available, so clients should not assume parallel version support until it is documented.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.