> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usequotable.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API changelog

> Changes to the Quotable REST API, MCP server and webhooks, newest first.

Every change to the API contract is listed here, newest first, with the date it shipped. Additive changes keep the `/api/v1` path; see [Versioning](https://docs.usequotable.com/api-reference/versioning.md) for what counts as breaking.

**2026-11-15**

Facts, fact checks and reporting

## REST API

**New endpoints**

| Endpoint | Scope |
| - | - |
| `GET /projects/{project_id}/facts` | `read:facts` |
| `POST /projects/{project_id}/facts` | `write:facts` |
| `PATCH /projects/{project_id}/facts/{fact_id}` | `write:facts` |
| `DELETE /projects/{project_id}/facts/{fact_id}` | `write:facts` |
| `GET /projects/{project_id}/fact-checks` | `read:facts` |
| `GET /projects/{project_id}/fact-checks/{claim_id}/sources` | `read:facts` |
| `GET /reporting/answers` | `read:visibility` |
| `GET /reporting/mentions` | `read:visibility` |
| `GET /reporting/citations` | `read:visibility` |

* The facts endpoints are the first writes in the REST API. `POST` accepts an `Idempotency-Key` header. See [Retry writes safely](https://docs.usequotable.com/api-reference/errors.md#retry-writes-safely).
* New problem types for writes and gated features: `invalid_body`, `conflict`, `plan_limit`, `forbidden` and `unavailable`. See [Errors](https://docs.usequotable.com/api-reference/errors.md#problem-types).
* The reporting endpoints return one row per answer, mention or citation for BI tools, with pages of up to 5,000 answers. See [Pagination](https://docs.usequotable.com/api-reference/pagination.md).

## API keys

Keys created in **Settings → API keys** now hold every scope and don't expire. You choose whether a key reaches one brand or the whole workspace. Existing keys keep their scopes and expiry. See [Authentication](https://docs.usequotable.com/api-reference/authentication.md).

## MCP server

New tools `get_shopping_overview` and `get_shopping_product`, with the `read:visibility` scope.

## Webhooks

`article.published`, `article.publish_failed` and `content.run.finished` are no longer sent, and new endpoints can't subscribe to them. `tracking.run.finalized` is unchanged. See [Events](https://docs.usequotable.com/webhooks/events.md).

**2026-10-14**

Agents and tables in the MCP server

## MCP server

* New tools `list_agents`, `get_agent` and `get_agent_run` (`read:agents`), `list_tables` and `get_table_rows` (`read:tables`), and `run_agent` (`run:agents`).
* `run_agent` starts a run that uses the workspace's credits. Pass an `idempotency_key` so a retried call can't start a second run.
* The list tools and `get_table_rows` take an optional `fields` input to return only the fields you need.

**2026-10-01**

OAuth sign-in for the MCP server

## MCP server

MCP clients can connect by signing in with OAuth instead of sending an API key. Tokens from an OAuth sign-in work only with the MCP server, not with the REST API. API keys keep working in both. See [MCP authentication](https://docs.usequotable.com/mcp-server/authentication.md#sign-in-with-oauth).

**2026-09-18**

v1

## REST API v1

The first public version of the Quotable API: read-only, at `https://app.usequotable.com/api/v1`, with contract date `2026-09-18`.

**Endpoints**

| Endpoint | Scope |
| - | - |
| `GET /me` | Any valid key |
| `GET /projects` | `read:projects` |
| `GET /projects/{project_id}` | `read:projects` |
| `GET /projects/{project_id}/prompts` | `read:visibility` |
| `GET /projects/{project_id}/visibility` | `read:visibility` |
| `GET /projects/{project_id}/citations` | `read:visibility` |
| `GET /projects/{project_id}/articles` | `read:content` |
| `GET /projects/{project_id}/articles/{article_id}` | `read:content` |
| `GET /projects/{project_id}/demand/terms` | `read:demand` |

**Platform**

* API keys with scopes, optional brand allowlists and expiry, managed in **Settings → API keys**. See [Authentication](https://docs.usequotable.com/api-reference/authentication.md).
* 300 requests per 60-second window per key. See [Rate limits](https://docs.usequotable.com/api-reference/rate-limits.md).
* Cursor pagination, RFC 9457 problem details, `ETag` revalidation and `X-Request-Id` correlation.
* A public OpenAPI 3.1 document at `/api/v1/openapi.json`.

## MCP server

A remote MCP server at `https://app.usequotable.com/api/mcp`, authenticated with the same API keys and sharing their rate limit. Tools: `list_projects`, `get_visibility`, `list_prompts`, `list_citations`, `list_articles` and `search_demand`. See the [MCP overview](https://docs.usequotable.com/mcp-server/overview.md).

## Webhooks

Signed outbound webhooks for `article.published`, `article.publish_failed`, `content.run.finished` and `tracking.run.finalized`, with automatic retries and a delivery log in **Settings → Webhooks**. The article and content-run events were retired on 2026-11-15. See [Webhooks](https://docs.usequotable.com/webhooks/overview.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.