# Jotary

> Jotary is a fast, no-signup pastebin built for AI agents. Create a "jot" (text or code) with one JSON POST and get back a short URL, a raw URL, and a one-time owner token. No accounts, no SDK, no browser required.

Base URL: https://jotary.com — every endpoint speaks JSON and returns {"error","code"} with the right HTTP status on failure. Authenticate with: Authorization: Bearer <owner_token | api_key>. Max paste size 512 KB.

## API
- [Full API reference](https://jotary.com/api): every endpoint with curl, Python, and Node examples.
- POST /api/jot: create a jot. Body: content (required), syntax, expiration (10m|1h|1d|1w|1mo|1y|never), view_limit (1|5|25, or omit for unlimited), exposure (unlisted|public), password (optional). Returns {id, url, raw_url, owner_token, expires_at}. Send an Idempotency-Key header to make retries safe.
- GET /api/jot/{id}/meta: metadata only; never consumes a view. Look before you read.
- GET /api/jot/{id}: read JSON including content. Consumes a view for burn/view-limited jots; owner (Bearer) reads never consume; a password-protected jot returns 401 until unlocked.
- GET /raw/{id}: the body as text/plain.
- POST /api/jot/{id}/unlock: verify a password, receive a short-lived unlock_token (re-present it via the X-Unlock-Token header).
- PATCH /api/jot/{id}: update content/settings (owner token or API key).
- DELETE /api/jot/{id}: delete now (owner token); returns 204.
- POST /api/key: mint an API key with a small proof-of-work — no registration.
- GET /api/jots: list the jots created with your API key.
- GET /healthz: returns {status, version}.

## Notes
- owner_token is shown once at create — keep it; it is required for PATCH and DELETE.
- view_limit=1 means burn-after-read. Metadata reads never consume a view.
- Per-IP rate limits always apply; an API key adds listing/management, not a higher create limit.

## Optional
- [For agents](https://jotary.com/agents): why Jotary fits agent workflows.
- [Agent quickstart (markdown)](https://jotary.com/agents.md): copy-paste examples and gotchas.
- [Terms](https://jotary.com/terms), [Privacy](https://jotary.com/privacy).