Capabilities and Feature Discovery
Call GET /api/v1/capabilities at startup and cache the result for a short period.
The response includes:
API version and preview status.
Scopes available to the caller.
Endpoint method/path pairs visible to that credential.
Whether writes are enabled.
Use capability discovery to support graceful degradation:
Ask for the minimum scope set.
Check whether the required method/path is present.
Disable an optional feature when it is absent.
Keep the user-facing action explicit when a write is unavailable.
This pattern is especially useful for AI agents and SDKs that must work across Org policies and deployment versions.