API Reference

The Pastevio API is REST over HTTPS and returns JSON. Public pastes can be created without a key; private pastes, comments, keys, and team resources require authentication.

Base URL

https://pastevio.com/api/v1

Authentication

Create a key in Settings → API Keys, then send it as a bearer token:

Authorization: Bearer pv_live_xxxxxxxx

Example

curl -X POST https://pastevio.com/api/v1/pastes \
  -H "Authorization: Bearer pv_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{"content":"hello","title":"Demo","visibility":"public"}'

Endpoints

POST/pastes

Create a paste. Body: content (required), title, type, visibility, expiry, language, password, burnAfterRead, viewLimit, slug.

GET/pastes/{slug}

Fetch a paste. Pass ?password=… for protected pastes.

GET/raw/{slug}

Raw text of a paste (text/plain, noindex).

GET/pastes/mine

Your pastes + usage stats (auth).

POST/pastes/import

Import a paste from a raw URL / GitHub Gist / Pastebin. Body: url.

GET/explore

Public pastes. Query: q, type, sort, page.

POST/pastes/{slug}/comments

Add a comment (auth).

POST/pastes/{slug}/report

Report a paste. Body: reason.

POST/keys

Create an API key (auth). Returned once.