generated: '2026-07-21'
method: searched
source: https://run-ai-docs.nvidia.com/api/getting-started/nvidia-run-ai-api-policy.md
docs: https://run-ai-docs.nvidia.com/api/getting-started/about-the-rest-api.md
versioning:
  scheme: dual-track
  current: latest
  description: >-
    The control-plane API is versioned on two tracks. The "latest" version is
    continuously updated (~every two weeks) and is used by SaaS deployments.
    Versioned APIs (e.g. 2.22, 2.23, 2.24, 2.25, 2.26) align with self-hosted
    product releases and have fixed behavior for the lifetime of the release.
  docs: https://run-ai-docs.nvidia.com/api/getting-started/about-the-rest-api.md
maturity_labels:
- Experimental
- Beta
- Legacy
deprecation:
  policy_url: https://run-ai-docs.nvidia.com/api/getting-started/nvidia-run-ai-api-policy.md
  saas_support_window: six months after deprecation
  self_hosted_support_window: two additional released versions
  process:
  - Deprecated API or field is clearly labeled in the documentation with a replacement where applicable.
  - Deprecations are announced in the release notes.
  - Customers are notified as part of regular release communications.
  removal: After the backward-compatibility window ends, deprecated APIs/fields are removed from the codebase and docs.
  deprecated_operations_count: 47
  deprecated_operations_note: >-
    47 operations in the current OpenAPI carry deprecated: true (e.g. legacy
    node-pool, project, storage-class, metrics, and Researcher CLI endpoints).
    See openapi/runai-openapi-original.json for the authoritative list.
release_cadence:
  saas: ~every two weeks; all customers receive changes within 10 days of initial release
  hotfixes: deployed as needed, immediately
status_page: null
status_page_note: >-
  No genuine public status dashboard was found. status.run.ai resolves to a Run:ai
  documentation "Service Update" page, not a live status/uptime dashboard, so no
  StatusPage pointer is emitted.
sla: null