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

# API Overview

> Base URL, authentication, and the shape of Dexi's REST surface

```
https://api.dexi.net
```

Dexi's public REST surface is deliberately small — two endpoint families:

| | Auth | Purpose |
| - | - | - |
| [`POST /api/v1/bookmarks/save`](/api/save-bookmark) | `dxi_` [API token](/authentication) | Save a page into your workspace |
| [`GET /api/v2/publisher/feeds/{id}/…`](/api/feeds) | none | Read someone's published feed (JSON or RSS) |

Everything else under `api.dexi.net` belongs to the Dexi app's own session-authenticated API; personal API tokens deliberately don't work there. If you want programmatic **read** access to a workspace — search, browse, full note text — that's the [MCP server](/mcp/overview), not REST. For bulk data, the app's export (Settings → Export) produces ZIP/CSV/markdown.

## Conventions

* Requests and responses are JSON (`Content-Type: application/json`); the RSS route returns `application/rss+xml`.
* Timestamps are ISO 8601 with timezone offsets. IDs are UUIDs.
* Authentication uses a bearer header: `Authorization: Bearer dxi_…`.
* Validation failures return `422` with FastAPI's standard `detail` array. Missing/invalid credentials return `401`. Resources you can't see return `404` — never `403`. Structured errors carry a machine-readable `detail.code` — see [Versioning & Deprecation](/api/versioning) for the error model.
* Responses carry `RateLimit-*` headers; a `429` includes `Retry-After`. Self-throttle from these — details in [Versioning & Deprecation](/api/versioning).
* A machine-readable [OpenAPI 3 spec](https://dexi.net/openapi.json) describes this whole surface, typed responses and errors included.


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