New integrations should start with the generated REST API v1 operations
section. The legacy /api/rest/* URLs are retained only as link-compatible
notices; they do not define a current REST contract.
/api/client/* family is a compatibility adapter for existing
workspace clients. It is not a second API version, and it should not be used to
infer an undocumented resource or lifecycle guarantee. The generated OpenAPI
pages are the only REST operation reference for new integrations.
Use the compatibility pages when you are maintaining an existing integration.
For new work, choose one of these paths:
- REST API v1 overview for the canonical namespace and shared rules.
- REST API v1 operations in the API Reference navigation for generated
method, parameter, request, response, and status documentation.
- MCP protocol for model-facing tools and approval flows.
The retained pages
These pages exist only so older links keep resolving. They are intentionally
absent from the sidebar and carry no contract:
