Ellie Help
Ellie Help Home What's new Getting started9 Work with Ellie4 Write and organise content7 Keep your docs up to date1 Publish and brand3 Walkthrough videos2 Changelog2 Measure and improve1 API reference1
Workspace and billing6
Connect AI tools1 Security and data3 Troubleshooting1
Powered by Ellie Docs
Workspace and billing/Create and use API keys

Create and use API keys

Updated 30 Oct 2026

On this page

Create an API key to connect tools that cannot sign in through the browser, or to authenticate CI and scripts. In Settings → API keys, you can create an API key, choose its access level, copy it when it is shown, and revoke it later.

Step by step

  1. Open Settings → API keys.
  2. In the key name field, enter a name such as the tool or workflow that will use the key.
    • The field placeholder is Key name (e.g. Cursor, CI).
    • If you leave the name blank, the key is created as API key.
    The API keys tab with the key name field, access select and Create key button
  3. Choose an access level:
    • Read only for AI tools that only need to look things up and preview
    • Read and draft for AI tools that should also create drafts, edits, and structure changes
    • Full content for AI tools that should also publish and accept suggestions
    • Admin (REST API) for CI and scripts that need the full workspace API
  4. Click Create key.
  5. Copy the key from the alert as soon as it appears.
    • The alert says: Copy this key now. It won't be shown again.
  6. Paste the key into your tool or script.
  7. When you no longer need the key, revoke it with the trash icon in the key list.

Access levels

Access levelWhat it allows
Read onlyAI tools only: look things up and preview
Read and draftAI tools only: also drafts, edits and structure. Nothing goes live
Full contentAI tools only: also publish and accept suggestions
Admin (REST API)The full workspace API for CI and scripts, including members, keys and billing

The Full content level here is the same access level that the consent page shown when an AI tool connects calls Full content access.

Good to know

I lost my key, can I see it again? No. The key is shown once when you create it. Create a new one and revoke the old key.

What does the key start with? API keys start with edocs_.

Which access level should I pick for Cursor or Claude? Usually Read only or Read and draft. Use Full content only if the tool should publish and accept suggestions.

Can a Read only key call the REST API? No. Read only, Read and draft, and Full content only work with the MCP server. Only Admin (REST API) works with the REST API.

Who can create or revoke keys? Workspace owners and admins can create or revoke keys.

How do I know a key is in use? In the key list, each key shows either Last used with a date or Never used.

What happens when I revoke a key? It stops working immediately.

For MCP setup with Claude, Cursor, and similar tools, see Connect Claude, Cursor and other AI tools. For the full Settings area, see Workspace settings reference.
On this page