API Documentation

Authentication (Required)

Authorization: Bearer <YOUR_API_TOKEN>

Base URL

https://paste.su/dev

Create Paste (POST)

• paste_title (string, optional) — default: Untitled Paste
• content (string, required)
• type (string, optional) — public | private | password — default: public
• expiration (string, optional) — unlimited | 1h | 1d | 7d | 1mo | 1y | burn — default: unlimited
• paste_password (string, required if type=password)

Response (201):

{
"paste_id": "a1b2c3d4e5f6",
"url": "https://paste.su/view/a1b2c3d4e5f6"
}

Fetch Paste (GET)

• paste_id (string, required)
• password (string, required only if paste is password-protected)

Response (200):

{
"paste_id": "a1b2c3d4e5f6",
"paste_title": "My Title",
"paste_content": "Decrypted body here",
"type": "public",
"expiration": "unlimited",
"creator": "username",
"create_time": "2025-08-25 12:34:56",
"burn": 0
}

Error Codes

• 401 — Missing / invalid token
• 403 — Password required / invalid password
• 404 — Not found
• 410 — Expired
• 422 — Missing fields / invalid params
• 405 — Wrong method