API Documentation

VoidBin provides a simple RESTful API that allows you to programmatically create pastes. Note that for security reasons, only the POST endpoint for creating pastes is publicly available. Retrieval of pastes is restricted to the VoidBin website interface only.

POST

Create a Paste

Creates a new paste with the provided content, optional title, and language.

Endpoint

/api/paste

Request Body

{ "content": "console.log('Hello, World!');", // Required: The content of the paste "language": "javascript", // Optional: The language for syntax highlighting (defaults to plaintext) "title": "My First Paste" // Optional: A title for the paste }

Response (201 Created)

{ "id": "abc123" // The unique ID of the created paste }

Example

fetch('/api/paste', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ content: 'console.log("Hello, World!");', language: 'javascript', title: 'My First Paste' }) }) .then(response => response.json()) .then(data => console.log(data)) .catch(error => console.error('Error:', error));

Rate Limits

A maximum of 5000 pastes can be created per hour from a single IP address.

NOTE

API Access Restrictions

For security and privacy reasons, VoidBin does not provide public API access for retrieving paste content. The following operations are restricted to the VoidBin website interface only:

Retrieving paste content (GET /api/paste/[id])
Listing recent pastes (GET /api/paste)

These restrictions help prevent automated scraping and maintain the privacy of paste content. If you need to access paste content programmatically for legitimate purposes, please contact us to discuss your use case.

⚠️ Important

Attempts to access these restricted endpoints programmatically may result in your IP address being temporarily blocked.

Ready to create your first paste?

Create New Paste