# Metakip API Reference

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

The API is available at `https://app.metakip.com/api/v1` and supports bearer tokens and browser sessions.

## Quick Start

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

```bash
curl https://app.metakip.com/api/v1/pages \
  -H "Authorization: Bearer $METAKIP_TOKEN"
```

Use the [Metakip CLI](/agents/metakip-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.