API Documentation

Overview

Neko provides a RESTful API for programmatic access to create, read, update, and delete pastes. All endpoints return JSON responses.

Base URL: https://Neko.hornymama.workers.dev/api

Endpoints

POST /api/pastes

Create a new paste

Request Body:

{
  "content": "console.log('Hello World');",
  "language": "javascript",
  "title": "My First Paste"
}

GET /api/pastes/[slug]

Get a specific paste by slug

Example:

curl https://Neko.hornymama.workers.dev/api/pastes/abc12345

PUT /api/pastes/[slug]

Update an existing paste

Request Body:

{
  "content": "Updated content",
  "language": "javascript",
  "title": "Updated Title"
}

DELETE /api/pastes/[slug]

Delete a paste

Example:

curl -X DELETE https://Neko.hornymama.workers.dev/api/pastes/abc12345

GET /api/pastes/[slug]/raw

Get raw paste content

Example:

curl https://Neko.hornymama.workers.dev/api/pastes/abc12345/raw

Response Format

Paste Object:

{
  "id": "uuid",
  "slug": "abc12345",
  "content": "console.log('Hello World');",
  "language": "javascript",
  "title": "My Paste",
  "created_at": "2024-01-01T12:00:00Z"
}

Error Responses

400 Bad Request

{"error": "Content is required"}

404 Not Found

{"error": "Paste not found"}

500 Internal Server Error

{"error": "Internal server error"}