# Markdawn API Reference

Read and change pages, folders, and markdown content through the same content layer used by Markdawn.

The API is available at `https://markdawn.space/api/v1` and supports bearer tokens and browser sessions.

## Quick Start

Create a named API token in Markdawn Settings, store it in `MARKDAWN_TOKEN`, and send it as a bearer token:

```bash
curl https://markdawn.space/api/v1/pages \
  -H "Authorization: Bearer $MARKDAWN_TOKEN"
```

Use the [Markdawn CLI](/agents/markdawn-cli/) when you want a terminal workflow instead of making HTTP requests directly.

## Endpoint Groups

- **Identity**: Read the authenticated user and authentication context.
- **Pages**: List, create, and update pages, including their markdown content.
- **Folders**: List, create, and update folders.
- **Lifecycle**: Copy, move, trash, restore, and permanently delete pages and folders.
- **Imports and Exports**: Import markdown and Obsidian content, or export pages and accessible content.
- **API Tokens**: Create, list, and revoke API tokens with a browser session.