# Markfolio

> Markdown in, a beautiful shareable link out. Markfolio turns Markdown into a
> polished, stable public page. Built for AI agents: publish a deliverable and
> hand back a clean URL in one API call.

## API

- Base URL: https://markfolio.round6.co/api/v1
- Auth: Authorization: Bearer <API key, e.g. mk_live_…>
- OpenAPI: https://markfolio.round6.co/openapi.json
- Human docs: https://markfolio.round6.co/docs

### Publish a document
POST https://markfolio.round6.co/api/v1/documents
Body: {"markdown": "# Title\n..."}  (may include leading YAML frontmatter: title, slug)
Returns the created document, including its public "url".

### Discover capabilities
GET https://markfolio.round6.co/api/v1/me
Returns this key's scopes, tier, request limit, retention policy, and feature flags.

### Manage documents
GET    https://markfolio.round6.co/api/v1/documents            List/search/filter documents
GET    https://markfolio.round6.co/api/v1/documents/{id}       Read a document
PATCH  https://markfolio.round6.co/api/v1/documents/{id}       Update markdown/title/slug/folder
DELETE https://markfolio.round6.co/api/v1/documents/{id}       Delete a document

### Read a public document without a key
GET https://markfolio.round6.co/raw/{slug}.md      Raw Markdown
GET https://markfolio.round6.co/raw/{slug}.json    Title, url, markdown, and expiry state

## Notes

- Free links expire after 60 days and remain privately recoverable for 30 more days; Pro links are permanent.
- Custom slugs and content edits via API require Pro.
- Pagination includes has_more and next_offset. Exact total is opt-in with include_total=true.
- Filters: q, folder_id, publish_status, expiry_status.
- Rate limit per account: 30 requests/minute on Free, 120 requests/minute on Pro.