Paste / Scratchpad API • Live on Signet test network only

Temporary notes and JSON snippets with a short shareable URL.

Use Paste when you need a quick scratchpad for notes, draft output, or JSON checkpoints. Send text or JSON, set a TTL if you want, and ArkAPI gives you a short public URL that expires automatically.

2 sats / call
POST /api/paste
GET /v1/p/{id}
TTL: 60s to 7d
Default TTL: 24h

How It Works

Send one payload plus an optional TTL, and ArkAPI stores it until the expiry time you choose.

  • Use content for plain UTF-8 text
  • Use json for structured JSON
  • Use ttl_seconds to shorten or extend retention from 60 seconds up to 7 days
  • The response includes a short id, a public url, and the exact expires_at time
  • Each funded session can keep up to 100 active pastes at once
  • Optional burn_after_read and max_views support one-time or limited-view sharing

What To Expect

This is a simple expiring scratchpad, not a document editor or file hosting service.

  • Pastes are public-by-link until they expire
  • Reading a paste does not require a token once you have the link
  • You can force a one-time handoff with burn_after_read or cap successful reads with max_views
  • Public fetches are returned as JSON
  • Expired pastes disappear automatically
  • Responses include noindex and nosniff headers

Example Request

curl -X POST https://arkapi.dev/api/paste \ -H "Authorization: Bearer ak_your_token" \ -H "Content-Type: application/json" \ -d '{"content":"Lorem ipsum dolor sit amet, consectetur adipiscing elit.","ttl_seconds":3600,"max_views":3}' | jq

Use a funded token from the Fund page. ArkAPI returns a short public URL under /v1/p/{id} that works until the paste expires.

Example Create Response

{ "success": true, "data": { "id": "k3m8v2q4r7tz", "url": "https://arkapi.dev/v1/p/k3m8v2q4r7tz", "content_kind": "text", "size_bytes": 56, "ttl_seconds": 3600, "burn_after_read": false, "max_views": 3, "views_remaining": 3, "expires_at": "2026-04-02T13:00:00Z" }, "cost_sats": 2, "balance_remaining": 498, "endpoint": "/api/paste" }

Example Public Fetch

curl https://arkapi.dev/v1/p/k3m8v2q4r7tz | jq
{ "id": "k3m8v2q4r7tz", "content_kind": "text", "content": "Lorem ipsum dolor sit amet, consectetur adipiscing elit.", "size_bytes": 56, "burn_after_read": false, "max_views": 3, "view_count": 1, "views_remaining": 2, "created_at": "2026-04-02T12:00:00Z", "expires_at": "2026-04-02T13:00:00Z" }

Good Uses

Discovery

For broader platform usage, see the main docs and the live catalog.