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

# Preview features

> API features available to organisations in the Wordsmith pilot: the MCP server, OAuth sign-in, files, reviews, document actions, drafting, research, reports, repositories, skills, sharing and usage.

> [!NOTE]
>
> **Preview.** These features are available to organisations in the Wordsmith MCP and files pilot. Elsewhere they return `403 mcp_not_enabled`. They are not listed in the navigation while the pilot runs, so keep this link to find them again.

## What is in the preview

> **[MCP server](/mcp-server)**
>
> Use Wordsmith from ChatGPT, Claude, Claude Code and other MCP hosts.

> **[OAuth sign-in](/oauth)**
>
> Let users connect an app to Wordsmith without sharing an API key.

> **[Files API](/api-reference/files/get-file)**
>
> Add, read and download files, and attach them by `file_id`.

> **[Reviews and documents](/api-reference/reviews/create-review)**
>
> Review contracts, generate redlines, and compare, translate, redact, convert or merge files.

> **[Reports and repositories](/api-reference/reports/create-report)**
>
> Keep documents in repositories, search them, and answer the same questions across all of them.

## Areas in the preview

| Area | Endpoints | What it does |
| - | - | - |
| Files | [Complete Upload](/api-reference/files/complete-upload), [Import File](/api-reference/files/import-file), [Create File](/api-reference/files/create-file), [Get File](/api-reference/files/get-file), [Get File Text](/api-reference/files/get-file-text), [Get File Download](/api-reference/files/get-file-download) | Add files from an upload, a public URL or text, and read them back. [Upload URL](/api-reference/files/upload-url) is available to everyone. |
| Operations | [List Operations](/api-reference/operations/list-operations), [Get Operation](/api-reference/operations/get-operation), [Cancel Operation](/api-reference/operations/cancel-operation) | Wait for, or stop, work that takes longer than one request. |
| Agents, playbooks and blueprints | [Get Agent](/api-reference/agents/get-agent), [Get Playbook](/api-reference/playbooks/get-playbook), [List Blueprints](/api-reference/blueprints/list-blueprints), [Get Blueprint](/api-reference/blueprints/get-blueprint) | Read one agent, a playbook with its checks, or a blueprint with its placeholders. |
| Sessions | [List Sessions](/api-reference/sessions/list-sessions), [Get Session](/api-reference/sessions/get-session), [List Messages](/api-reference/sessions/list-messages) | Read past conversations. |
| Reviews | [Create Review](/api-reference/reviews/create-review), [List Reviews](/api-reference/reviews/list-reviews), [Get Review](/api-reference/reviews/get-review), [List Findings](/api-reference/reviews/list-findings), [Generate Redline](/api-reference/reviews/generate-redline) | Review contracts against a playbook or your instructions, and get a tracked-changes redline. |
| Document actions | [Compare Files](/api-reference/documents/compare), [Merge Files](/api-reference/documents/merge), [Redline File](/api-reference/documents/redline), [Translate File](/api-reference/documents/translate), [Redact File](/api-reference/documents/redact), [Convert File](/api-reference/documents/convert), [Accept Changes](/api-reference/documents/accept-changes) | Make a new file from files you have in Wordsmith. |
| Playbook authoring | [Create Playbook](/api-reference/playbooks/create-playbook), [Update Playbook](/api-reference/playbooks/update-playbook), [Delete Playbook](/api-reference/playbooks/delete-playbook), [Add Check](/api-reference/playbooks/add-check), [Update Check](/api-reference/playbooks/update-check), [Delete Check](/api-reference/playbooks/delete-check), [Generate Playbook](/api-reference/playbooks/generate-playbook) | Write playbooks and their checks, or generate one from examples or instructions. |
| Skills | [List Skills](/api-reference/skills/list-skills), [Get Skill](/api-reference/skills/get-skill), [Create Skill](/api-reference/skills/create-skill), [Update Skill](/api-reference/skills/update-skill), [Delete Skill](/api-reference/skills/delete-skill) | Read and write skills, the instructions and files the Wordsmith agent follows, or import a `SKILL.md` folder. |
| Drafts | [Create Draft](/api-reference/drafts/create-draft) | Draft a document from instructions, or fill a blueprint. |
| Research | [Search Research Sources](/api-reference/research/search), [Get Research Document](/api-reference/research/get-document) | Search case law and legislation, and read one document. |
| Reports | [List Reports](/api-reference/reports/list-reports), [Create Report](/api-reference/reports/create-report), [Get Report](/api-reference/reports/get-report), [Run Report](/api-reference/reports/run-report), [List Cells](/api-reference/reports/list-cells), [Export Report](/api-reference/reports/export-report), and the column and row routes | Answer the same questions across many documents, and export the grid. |
| Repositories and search | [List Repositories](/api-reference/repositories/list-repositories), [Create Repository](/api-reference/repositories/create-repository), [Add Documents](/api-reference/repositories/add-documents), [Search Repository](/api-reference/repositories/search-repository), [Search Knowledge](/api-reference/search/search-knowledge), and the document and folder routes | Keep documents in repositories and search them by meaning. |
| Sharing | [Get Sharing](/api-reference/sharing/get-sharing), [Update Sharing](/api-reference/sharing/update-sharing) | See and change who can see a repository, report, playbook, blueprint or session. |
| Organisation | [Get Member](/api-reference/organisation/get-member), [List Roles](/api-reference/organisation/list-roles), [Get Team](/api-reference/organisation/get-team), [List Invites](/api-reference/organisation/list-invites), [List Company Profiles](/api-reference/organisation/list-company-profiles), and the routes that change them | Read and administer members, roles, teams, invites and company profiles. |
| Usage and value | [Get Usage Summary](/api-reference/usage/get-usage-summary), [Get Usage Breakdown](/api-reference/usage/get-usage-breakdown), [Get Usage Over Time](/api-reference/usage/get-usage-timeseries) | Sessions, active users, hours saved and cost saved. |

Each area has an [MCP tool](/mcp-server#tools) that calls the same code.

## Attaching a file by `file_id`

In the preview, an attachment on [Create Question](/api-reference/agents/create-question) can name a file you already have, instead of uploading it again. [Attach Files](/api-reference/tasks/attach-files) already takes `file_ids` for tasks.

```json theme={null}
{
  "question": "Summarise the termination rights in this agreement.",
  "attachments": [{ "file_id": "7c3e9a51-2d84-4f06-b1c7-5e9d0a2f8b63" }]
}
```

With an OAuth token, a `file_id` attachment needs the `files:read` scope as well as `files:write`.


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