API

Automate Edith workflows.

Use the Edith API for documents, versions, review links, suggestions, comments, files, assets, contacts, and admin workflows.

Open OpenAPI List actions

Live app endpoint

Base URL

https://edithmd.com/api/v1

Authenticate with a bearer token from Edith settings or OAuth.

Authorization: Bearer <token>

Contracts

OpenAPI: https://edithmd.com/api/v1/openapi.json
Actions: https://edithmd.com/api/v1/actions
OAuth resource metadata: https://edithmd.com/.well-known/oauth-protected-resource/api

Scopes

API scopes are separate from MCP scopes. Use api:* for full API access, or narrower api:documents:read, api:reviews:write, and related scopes.

mcp:* does not grant API access. api:* does not grant MCP access.

Example

curl -fsS https://edithmd.com/api/v1/actions/list_documents \
  -H "Authorization: Bearer $EDITH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"archived": false}'