# Wordsmith API — developer documentation

> The Wordsmith API: OpenAPI 3.1 specification, authentication, webhooks and rate limits for the legal AI platform built for in-house legal teams.

Canonical URL: https://www.wordsmith.ai/developers

DEVELOPERS

## Wordsmith for developers

Build on the Wordsmith platform. API docs, SDKs, and developer resources.
[Read the docs](https://docs.wordsmith.ai/)

API OVERVIEW

### A legal assistant you can call from anywhere.

Wordsmith is a legal AI assistant designed to automate repetitive tasks for lawyers — document summarization, legal document review, research and analysis, and question answering with legal context. The Public API exposes those same capabilities through a simple REST interface so you can ask questions, upload and process documents, retrieve user and account information, and integrate Wordsmith's assistant into your existing workflows.

REST API BASE

https://api.wordsmith.ai/api/v1

MCP ENDPOINT

https://mcp.wordsmith.ai

Connect any MCP-compatible client to the Wordsmith legal AI platform.

- Ask questions and get AI-powered legal insights
- Upload and process documents for review or summarization
- Retrieve user and account information
- Integrate Wordsmith's capabilities into your existing workflows

### Start building.

[

Quickstart

Authenticate, ask your first question, and upload a document in three curl calls. Covers sync vs async execution modes and common error codes.
](https://docs.wordsmith.ai/quickstart)[

Authentication

Bearer-token authentication using API keys generated from your Wordsmith dashboard. Keys are prefixed with sk-ws-api1-.
](https://docs.wordsmith.ai/authentication)[

API reference

Assistants, files, playbooks, templates, and user endpoints — every parameter, response shape, and status code. Fully OpenAPI-backed.
](https://docs.wordsmith.ai/api-reference/assistants/create-question)[

Webhooks

Register callback URLs on async questions to receive completion notifications via HTTP POST instead of polling for results.
](https://docs.wordsmith.ai/webhooks)[

SDKs and libraries

No official SDKs yet — the API works with any HTTP client in Python (requests, httpx), Node.js (fetch, axios), PHP, Ruby, or Java.
](https://docs.wordsmith.ai/quickstart)[

Full documentation

Introduction, errors reference, rate limits, and every endpoint live in the Mintlify-hosted docs site.
](https://docs.wordsmith.ai/introduction)

[Open full documentation](https://docs.wordsmith.ai/)

### Machine-readable resources

Everything an AI agent needs to discover and call the Wordsmith API, published at predictable URLs.

- [Wordsmith OpenAPI specification](https://www.wordsmith.ai/openapi.json)

https://www.wordsmith.ai/openapi.json

OpenAPI 3.1 description of all 31 endpoints, with typed parameters, response schemas and a unique operation ID for every operation.

- [Wordsmith agent instructions](https://www.wordsmith.ai/.well-known/agent-instructions.md)

https://www.wordsmith.ai/.well-known/agent-instructions.md

When to reach for Wordsmith, when not to, and the exact call sequence — authentication, discovery, questions, documents and tasks.

- [Wordsmith llms.txt](https://www.wordsmith.ai/llms.txt)

https://www.wordsmith.ai/llms.txt

Site index for LLM crawlers: entity, audience, capabilities and every curated URL on wordsmith.ai.

BOOK A DEMO

### Ready to transform your legal department?

See how the world's leading legal teams are building the future of in-house legal.

[Book a demo](https://www.wordsmith.ai/book-demo)