Welcome to Forvia
Simple, private sharing.
Choose a tool to get started.
Choose a tool to get started.
Text, links, or files. Optionally self-destructing. No accounts. No tracking. Just paste.
Create, retrieve, and manage pastes programmatically. No auth required.
Create a new paste. Returns a code and URL you can share.
| Field | Type | Required | Description |
|---|---|---|---|
content | string | Yes | The text content of the paste |
code | string | No | Custom code (4-10 uppercase alphanumeric). Auto-generated if omitted. |
burn | boolean | No | If true, paste is deleted after first retrieval. Default: false |
| Field | Type | Description |
|---|---|---|
code | string | The unique paste code |
url | string | Full URL to retrieve the paste |
burn | boolean | Whether the paste is burn-on-read |
size | number | Content size in bytes |
curl -X POST https://forvia.systems/api/paste \
-H "Content-Type: application/json" \
-d '{"content": "Hello, world!", "burn": false}'
{
"code": "A3X9K2",
"url": "https://forvia.systems/clipboard?code=A3X9K2",
"burn": false,
"size": 13
}
curl -X POST https://forvia.systems/api/paste \
-H "Content-Type: application/json" \
-d '{"content": "My secret note", "code": "MYCODE", "burn": true}'
Retrieve paste content by code. Returns raw content with appropriate content-type.
| Parameter | Type | Description |
|---|---|---|
code | string | The paste code (3-10 uppercase alphanumeric) |
| Header | Description |
|---|---|
Content-Type | text/plain for text, application/zip for zipped files |
X-Burn | true if paste was burn-on-read (deleted after this request) |
curl https://forvia.systems/api/paste/A3X9K2
Hello, world!
Permanently delete a paste. Only works for non-burn pastes that haven't been evicted.
curl -X DELETE https://forvia.systems/api/paste/A3X9K2
{
"ok": true,
"code": "A3X9K2",
"message": "Paste deleted."
}
Get platform-wide statistics.
curl https://forvia.systems/api/stats
{
"total_pastes": 142,
"total_views": 8731,
"active_users": 29
}
All errors return JSON with an error field.
| Status | Meaning |
|---|---|
400 | Invalid code format or empty content |
404 | Paste not found |
409 | Code already exists (when using custom code) |
429 | Rate limited (5 failed requests per minute) |
{
"error": "Code not found."
}
5 failed retrieve/delete attempts per IP per 60 seconds. Successful requests are not rate-limited.
Total storage capped at 20GB. When exceeded, oldest non-burn pastes are evicted automatically. Burn-on-read pastes are never evicted by the cleaner.
Help us improve. Share your ideas and vote on what matters most.