Integrate One Click Paste into your applications with our powerful REST API.
Clean, predictable REST endpoints following industry standards
API key-based authentication with rate limiting
All responses in JSON format with consistent structure
Detailed documentation with code examples
https://api.oneclickpaste.comComplete reference for all available endpoints
/api/roomsCreate a new room
pinstring4-digit PIN for room protection{
"roomId": "abc123",
"expiresAt": "2025-12-28T12:00:00Z",
"hasPin": false
}/api/rooms/:roomIdGet room information
roomIdstringrequiredThe room codepinstringPIN if room is protected{
"roomId": "abc123",
"expiresAt": "2025-12-28T12:00:00Z",
"hasPin": false,
"deviceCount": 2
}/api/rooms/:roomIdDelete a room
roomIdstringrequiredThe room code{
"success": true,
"message": "Room deleted successfully"
}/api/rooms/:roomId/contentUpdate room content
roomIdstringrequiredThe room codecontentstringrequiredThe content to share{
"success": true,
"content": "Updated content",
"timestamp": "2025-12-27T12:00:00Z"
}/api/rooms/:roomId/contentGet room content
roomIdstringrequiredThe room code{
"content": "Current content",
"timestamp": "2025-12-27T12:00:00Z"
}/api/rooms/:roomId/uploadUpload a file to a room
roomIdstringrequiredThe room codefilefilerequiredFile to upload (max 10MB){
"success": true,
"fileUrl": "https://oneclickpaste.com/files/abc123.jpg",
"fileName": "image.jpg",
"fileSize": 1024000
}/api/healthCheck API health status
{
"status": "healthy",
"timestamp": "2025-12-27T12:00:00Z",
"uptime": 99.97
}Get started quickly with these examples
// Create a new room
const response = await fetch('https://api.oneclickpaste.com/api/rooms', {
method: 'POST',
headers: {
'Content-Type': 'application/json'
},
body: JSON.stringify({
pin: '1234' // Optional
})
});
const data = await response.json();
console.log(data.roomId); // abc123import requests
# Create a new room
response = requests.post(
'https://api.oneclickpaste.com/api/rooms',
json={'pin': '1234'} # Optional
)
data = response.json()
print(data['roomId']) # abc123# Create a new room
curl -X POST https://api.oneclickpaste.com/api/rooms \
-H "Content-Type: application/json" \
-d '{"pin": "1234"}'To ensure fair usage and service stability, the following rate limits apply:
The One Click Paste API is currently in development. Sign up to be notified when it launches in Q1 2026.