# API Overview

URL: https://docs.clinia.com/api/overview

> The base URL, OAuth scopes, stability tiers and bundled terminology releases shared by the REST API and the MCP server.

The Clinia Context Engine exposes two API surfaces backed by the same underlying data:

- **REST API**, for server-side integrations, dashboards and ingestion. Each operation has a page under REST, grouped by tag. The `sessions` endpoints follow the lifecycle in [Sessions](https://docs.clinia.com/docs/learned-memory/sessions). The `graph` endpoints read the [patient graph](https://docs.clinia.com/docs/get-started/patient-graph) directly, as [Audit the Patient Graph](https://docs.clinia.com/docs/trust-and-governance/audit-the-graph) shows, and are all [`Technical preview`](#api-stability).
- **MCP server**, for AI agents. [MCP Server](https://docs.clinia.com/api/mcp/server) covers connecting and the tools it exposes; [Connect an AI Agent](https://docs.clinia.com/docs/context-assembly/connect-an-ai-agent) walks through wiring them to a model.

## Base URL [#base-url]

```
https://<workspace-id>.w.clinia.cloud
```

Replace `<workspace-id>` with your workspace identifier.

## OAuth scopes [#oauth-scopes]

Every endpoint declares the scope it requires, `read` or `write`, on its reference page. [Authentication and Credentials](https://docs.clinia.com/docs/platform/authentication-and-credentials) explains how a credential's access level sets its scopes and what to do when a call returns `403 insufficient_scope`.

## API stability [#api-stability]

The `/v{n}` prefix does not indicate stability. Every endpoint declares a tier, published as `x-state` on its operation in the OpenAPI spec:

- `Generally available` — breaks only at a new version prefix.
- `Technical preview` — promises nothing. It may change or disappear in any release, including a patch.
- `Deprecated` — still works, unchanged, and will be removed in a future release.

Anything other than generally available sends a runtime warning header:

```
Warning: 299 ContextEngine-1.4.0 "Deprecated: this endpoint will be removed in a future release."
```

MCP server stability is never guaranteed; its tools are optimized for agents and change with the product.

## Bundled terminology releases [#bundled-terminology-releases]

The Context Engine bundles these terminology releases:

| Terminology | Bundled release                  |
| ----------- | -------------------------------- |
| RxNorm      | 20260601                         |
| NDC         | 20260823                         |
| SNOMED CT   | International Edition 2026-02-01 |

Codes from other terminologies are accepted and stored as received, and may be used to match entities during pairwise adjudication. See how [the patient graph](https://docs.clinia.com/docs/get-started/patient-graph) gets built for more details.