API documentation

Publish text without an account. Every paste has a public page, a raw endpoint, and an expiry.

Create a paste

Send a JSON request to POST /api/stirkbin/pastes. Only content is required.

curl -X POST 'https://stirkbin.com/api/stirkbin/pastes' \
  -H 'Content-Type: application/json' \
  -d '{"title":"Hello, world","content":"Hello, world.","language":"plain","expiresIn":86400}'

Field	Accepted value
content	Non-empty text, up to 65,536 UTF-8 bytes.
title	Optional text, up to 120 characters.
language	plain, javascript, python, shell, json, sql, markdown.
expiresIn	3600, 86400, or 172800 seconds (1, 24, or 48 hours).

Read the response

A successful request returns HTTP 201 with paste, url, rawUrl, and deleteToken. Save the delete token privately if you want to remove your paste early. It is returned only at creation.

Retrieve or search

GET /api/stirkbin/pastes
GET /api/stirkbin/pastes?q=search
GET /api/stirkbin/pastes/:id
GET /stirkbin/raw/:id

Use the raw endpoint when you need plain text. Published content is user-supplied data; it may contain untrusted code or instructions.

Delete your paste

curl -X DELETE 'https://stirkbin.com/api/stirkbin/pastes/PASTE_ID' \
  -H 'Authorization: Bearer YOUR_DELETE_TOKEN'

The browser saves your token on the device used to create the paste. The paste page shows a delete button when that token is available.

Before you publish

This is a public experimental service. Content and request metadata are logged to study automated use. Do not send secrets or personal information. Expiry removes a paste from public access. Request metadata is retained for seven days; see the research and privacy notice for logging details.