# mdrop

mdrop is a markdown paste API designed for AI agents and automation workflows.

Base URL: https://mdrop.md
Skill file: https://mdrop.md/SKILL.md

Primary endpoints:
- GET /api/pastes (API discovery)
- POST /api/pastes
- GET /api/pastes/:id
- PATCH /api/pastes/:id
- DELETE /api/pastes/:id
- GET /p/:id
- GET /raw/:id
- POST /api/cleanup-expired
- POST /api/api-keys (public, rate-limited)
- GET /api/api-keys (owner-only)
- DELETE /api/api-keys/:id (owner-only)

Authentication:
- Bearer API key required for create/update/delete routes.
- Owner token is used for list/revoke API keys.

Notes:
- Free-tier TTL max: 24 hours.
- instant_view_url is intentionally null.
- telegraph_url is returned for public/unlisted as Telegram-friendly fallback.