# Outline (slim)

> Outline is a team wiki and knowledge base from General Outline, available hosted or self-hosted. Agents reach it through an RPC-style HTTP API with a public OpenAPI description, or an MCP server built into each workspace.

- Full: https://www.anchorterminal.com/tools/outline.md (~8,000 tokens) · this version ~2,080 tokens · JSON https://www.anchorterminal.com/tools/outline.json · canonical https://www.anchorterminal.com/tools/outline
- Index: https://www.anchorterminal.com/llms.txt · API: https://www.anchorterminal.com/api/v1/index.json · Updated: 2026-10-09

**C · 60.3/100 · rank #408 of 722 · #2 in Work & productivity · not agent-ready · confidence medium**


Assessment: API keys and OAuth tokens can be limited to single endpoints, all 154 operations document a 429 response with Retry-After, and the workspace MCP server registers tools by granted scope. Two scope-bypass flaws were published and fixed in May and June 2026, rate limits carry no published numbers, and there are no official client libraries.

## Facts

- Kind: HTTP API · vendor: General Outline, Inc. · category: Work & productivity · legal entity: General Outline, Inc. · provenance 79/100
- Endpoint: `https://app.getoutline.com/api` (HTTP, Streamable HTTP)
- Auth: OAuth or key · pricing: Paid · x402: no · licence: Source available under BSL 1.1, which bars running it as a document service for third parties and converts each release to Apache 2.0 on its change date (2030-09-09 for 1.10.1). The OpenAPI description is BSD-3-Clause. The hosted service is under the vendor's terms
- Probe metrics: not measured yet (probes haven't run)
- Surface graded: The hosted Outline Cloud API at https://app.getoutline.com/api, with the built-in MCP server described alongside it. The same API and MCP server ship in the self-hosted editions
- API: OpenAPI 3.0, 154 operations in 26 groups, all POST with JSON bodies. Documents (30 operations), collections (19), users (12), comments (9), groups (9), templates (7), plus shares, revisions, attachments, events and webhook subscriptions
- Documents: Bodies are Markdown up to 1,536,000 characters. `documents.update` takes `editMode` with `findText` for patch edits and `lastRevision` for a 409 on a stale write. `documents.delete` moves to the trash for 30 days unless `permanent` is set
- Search: `documents.search` returns a context snippet and ranking per hit with structured `filters`, `documents.search_titles` matches titles only, and `documents.answerQuestion` answers from documents where the workspace has AI answers on
- MCP server: https://<subdomain>.getoutline.com/mcp, Streamable HTTP only, 19 tools (documents, collections, comments, templates, attachments, users and a `fetch` tool), OAuth or API key, off or on per workspace. The source limits it to 1,000 requests an hour
- Credentials: API keys with optional expiry and scopes, or OAuth 2.0 with PKCE, refresh tokens, revocation and dynamic client registration. Scopes are `read`, `write`, namespaced such as `documents:read`, or single methods and wildcards
- Rate limits: No numbers in the API documentation. A 429 carries `Retry-After`, `RateLimit-Limit`, `RateLimit-Remaining` and `RateLimit-Reset`. The source defaults to 1,000 requests a minute overall, with document methods at 25 or 100 a minute and some at 10 or 100 an hour
- Errors: JSON with `ok`, `error`, `message` and `status`, for example `validation_error` at 400 and `rate_limit_exceeded` at 429. 401 and 429 are documented on every operation, 403 on 151
- Paging: `limit` and `offset` with `sort` and `direction` on list methods, and a `nextPath` in each response. No field selection
- Webhooks: Workspace webhooks post JSON for document, collection, comment, user, group and share events, signed where a secret is set, and are managed through four `webhookSubscriptions` methods. Repeatedly failing webhooks are disabled
- Client libraries: None official. The vendor publishes the OpenAPI description in outline/openapi for generating clients
- Audit: Audit log with actor, IP address and authentication type, kept for one year, in Settings and through `events.list` with `auditLog`
- Status: status.getoutline.com on Oh Dear with three monitors (Application, Website, Collaboration). The history page showed no incidents on 8 October 2026 and gives no uptime figures
- Data: Servers in the US on AWS, AES-256 at rest, daily backups kept at least three months, per the vendor's security page. The DPA lists 13 sub-processors with countries, OpenAI among them for generative AI
- Releases: v1.10.1 on 9 September 2026 and five tagged releases since 11 July 2026. The hosted changelog has 172 dated entries, the newest on 9 September 2026
- Prices: Cloud, 1 to 10 members $10 per month (plan); Cloud, 11 to 100 members $79 per month (plan); Cloud, 101 to 200 members $249 per month (plan)

- Scores: Reliability 67, Performance pending, Schema & documentation 76, Agent ergonomics 62, Security & auth 71, Payments & pricing 30, Task success pending, Maintenance & community 83, Transparency & trust 69 · negative events -5 · total over the 7 assessed categories
- Why: Reliability, Graded on the hosted Outline Cloud API with the hosted lines. · Schema & documentation, Public OpenAPI 3.0 description at www.getoutline.com/openapi.json and in outline/openapi, 154 operations, and MCP tools typed with zod schem… · Agent ergonomics, `documents.search` returns a context snippet and ranking with each hit, and list methods take `limit`. · Security & auth, OAuth 2.0 with PKCE (S256), refresh tokens, revocation and dynamic client registration, and API keys that are shown once, revocable, optiona… · Payments & pricing, No x402, MPP or L402 (0). · Maintenance & community, v1.10.1 was released on 9 September 2026, 29 days before the check, and the main branch had 200 commits since 5 September (30). · Transparency & trust, The source is public under BSL 1.1, which is not an OSI licence and bars running a competing document service, with each release converting…
- Sources: 31, open questions: 8, both in the full twin
- Capabilities: work.docs, knowledge.search
- JSON: https://www.anchorterminal.com/api/v1/tools/outline.json
- Verify (for the vendor): the badge `https://www.anchorterminal.com/badges/outline.svg` or a link to https://www.anchorterminal.com/tools/outline from a page on getoutline.com or one of its subdomains, or the README of github.com/outline/outline, then `POST https://www.anchorterminal.com/api/v1/verify` `{"slug", "url"}` or `verify_listing` at /mcp; re-checked weekly, no effect on the grade. Snippets in the full twin.

## Before you call it

1. Send every call as POST with a JSON body to `https://app.getoutline.com/api/<method>`, for example `documents.search`, with a Bearer key in the header
2. Ask for a key scoped to the methods the task needs, such as `documents.info documents.search`. An unscoped key has all of its owner's access
3. Pass `lastRevision` on `documents.update` so a stale write is rejected with 409, and use `editMode` `patch` with `findText` to change one passage
4. Wait for the seconds in `Retry-After` on a 429. Write methods have tighter limits than reads
5. Leave `permanent` unset on `documents.delete`. The default moves the document to the trash, where it can be restored for 30 days

## Connect

```bash
curl https://app.getoutline.com/api/documents.info -X POST -H 'authorization: Bearer MY_API_KEY' -H 'content-type: application/json' -H 'accept: application/json' -d '{"id": "outline-api-NTpezNwhUP"}'
```

```bash
claude mcp add --transport http outline https://<yoursubdomain>.getoutline.com/mcp
```
Full config and headless snippets are in the full page. Through letme (picks today, calling later): https://letme.dev/outline

## Similar tools

| Tool | Grade | Score | Shared capabilities | Slim |
| --- | --- | --- | --- | --- |
| Atlan | B | 62.5 | knowledge.search, work.docs | https://www.anchorterminal.com/tools/atlan.min.md |
| Guru | E | 45.1 | knowledge.search, work.docs | https://www.anchorterminal.com/tools/guru.min.md |
| Google Drive API + MCP | A | 79.6 | work.docs | https://www.anchorterminal.com/tools/google-drive-api.min.md |
| monday.com | BB | 76.4 | work.docs | https://www.anchorterminal.com/tools/monday.min.md |
| Glean | B | 69.8 | knowledge.search | https://www.anchorterminal.com/tools/glean.min.md |


## Panel reviews (0, desk reviews from public material, no calls made)