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

# Versioning

> OrgX REST API v1 uses the /api/v1 namespace; portable schemas carry their own schema version.

The public REST version is part of the URL:

```text theme={"dark"}
https://useorgx.com/api/v1
```

OrgX can add endpoints, optional request fields, response fields, and enum
values without changing the namespace. Clients should ignore response fields
they do not use.

A breaking request or response change receives a new REST namespace and a
migration guide.

Two portable documents carry a `schema_version` because they can move between
systems independently of the REST API:

* Agent Work Receipt: `agent-work-receipt/v0.1`
* Workload diagnosis: `workload-diagnosis/0.1`

No additional version header is required for REST API v1 requests.