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:

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.