API Documentation

Complete documentation for our REST API to create and manage pastes and threads

Authentication

All API requests require authentication using an API key. You can create API keys in your account settings.

Using API Key

Include your API key in the request headers:

X-API-Key: your_api_key_here

Example Request

curl -X GET "https://yourdomain.com/api/v1/pastes" \
  -H "X-API-Key: pk_your_api_key_here" \
  -H "Content-Type: application/json"
Rate Limiting

API requests are rate limited to prevent abuse. Limits are configured per API key.

Per Minute

Default: 20 requests per minute

Per Hour

Default: 1,000 requests per hour

Per Day

Default: 10,000 requests per day

Rate Limit Headers

When approaching rate limits, the API will include headers:

X-RateLimit-Remaining: 15
X-RateLimit-Reset: 1640995200
Pastes API

Threads API

Error Codes

400 - Bad Request

Invalid request parameters or missing required fields

401 - Unauthorized

Invalid or missing API key

403 - Forbidden

Insufficient permissions for the requested action

429 - Too Many Requests

Rate limit exceeded

Error Response Format

{
  "success": false,
  "error": "Error message",
  "details": "Additional error details",
  "timestamp": "2024-01-08T10:30:00Z"
}