Free Pastebin API — Share Code Snippets via REST

Need a programmatic way to share code snippets, logs, or text? The Agent Paste Bin API lets you create, retrieve, update, and delete pastes via REST. It auto-detects programming languages, supports paste collections, provides a line-by-line diff tool, and offers both formatted and raw content endpoints — all without creating an account.

In this guide you'll learn how to create pastes, organize them into collections, diff two pastes, and integrate paste sharing into your development workflow.

Quick Start — Create a Paste

curl -X POST https://agent-gateway-kappa.vercel.app/v1/agent-paste/api/pastes \
  -H "Content-Type: application/json" \
  -d '{
    "content": "def fibonacci(n):\n    a, b = 0, 1\n    for _ in range(n):\n        a, b = b, a + b\n    return a",
    "title": "fibonacci.py"
  }'

# Response:
{
  "id": "aii5yhht",
  "url": ".../api/pastes/aii5yhht",
  "rawUrl": ".../api/pastes/aii5yhht/raw",
  "title": "fibonacci.py",
  "language": "python",
  "lines": 5,
  "bytes": 89,
  "hash": "3d73da5b43ce076f",
  "expiresAt": null,
  "created": "2026-03-03T20:31:26.666Z"
}

import requests

BASE = "https://agent-gateway-kappa.vercel.app/v1/agent-paste"

code = """def fibonacci(n):
    a, b = 0, 1
    for _ in range(n):
        a, b = b, a + b
    return a"""

resp = requests.post(
    f"{BASE}/api/pastes",
    json={"content": code, "title": "fibonacci.py"}
)
paste = resp.json()
print(f"Paste ID: {paste['id']}")
print(f"Language: {paste['language']}")  # "python"
print(f"Raw URL: {paste['rawUrl']}")

const BASE = "https://agent-gateway-kappa.vercel.app/v1/agent-paste";

const code = `def fibonacci(n):
    a, b = 0, 1
    for _ in range(n):
        a, b = b, a + b
    return a`;

const resp = await fetch(`${BASE}/api/pastes`, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ content: code, title: "fibonacci.py" })
});
const paste = await resp.json();
console.log(`${paste.id} (${paste.language}) - ${paste.lines} lines`);

No API key required for basic paste creation. The language is detected automatically from the content and filename.

API Endpoints

Create Options

When creating a paste, you can set several options:

curl -X POST https://agent-gateway-kappa.vercel.app/v1/agent-paste/api/pastes \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "SELECT * FROM users WHERE active = true;",
    "title": "active-users-query.sql",
    "language": "sql",
    "expiresIn": "1h",
    "visibility": "public",
    "metadata": {
      "project": "user-dashboard",
      "author": "devops-bot"
    }
  }'

Get Raw Content

The /raw endpoint returns plain text — perfect for piping into scripts or embedding:

# Get raw content (no JSON wrapping)
curl https://agent-gateway-kappa.vercel.app/v1/agent-paste/api/pastes/aii5yhht/raw

def fibonacci(n):
    a, b = 0, 1
    for _ in range(n):
        a, b = b, a + b
    return a

# Pipe directly into a file
curl -s https://agent-gateway-kappa.vercel.app/v1/agent-paste/api/pastes/aii5yhht/raw > fibonacci.py

Collections — Multi-File Sharing

Group related pastes into a collection, like a multi-file Gist:

curl -X POST https://agent-gateway-kappa.vercel.app/v1/agent-paste/api/collections \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "API Bug Report",
    "description": "Files related to the auth token expiry bug",
    "pastes": ["paste_id_1", "paste_id_2", "paste_id_3"]
  }'

{
  "id": "col_x7y8z9",
  "name": "API Bug Report",
  "description": "Files related to the auth token expiry bug",
  "pasteCount": 3,
  "created": "2026-03-03T20:35:00.000Z"
}

Diff Two Pastes

Compare two pastes line-by-line to see what changed:

curl -X POST https://agent-gateway-kappa.vercel.app/v1/agent-paste/api/diff \
  -H "Content-Type: application/json" \
  -d '{
    "pasteA": "paste_id_old",
    "pasteB": "paste_id_new"
  }'

{
  "added": 3,
  "removed": 1,
  "unchanged": 12,
  "changes": [
    {"line": 5, "type": "removed", "content": "    return None"},
    {"line": 5, "type": "added", "content": "    return result"},
    {"line": 8, "type": "added", "content": "    logger.info('Done')"},
    {"line": 9, "type": "added", "content": "    return True"}
  ]
}

Real-World Use Cases

Comparison: Free Pastebin API vs Alternatives

Key advantage: Agent Paste is the only pastebin with built-in collections and a diff API. Pastebin.com's API only supports creating pastes (no retrieval or updates without paid plan). GitHub Gist requires authentication. Agent Paste gives you full CRUD, collections, diff, and auto language detection — all without an account.

FAQ