CLI

Create, share, and fetch JotSpot notes from your terminal.

`POST /api/v1/jots/text` creates a draft jot with a short slug and returns the share URL, raw URL, and private manage URL.

Create anonymously

curl -X POST https://jotspot.io/api/v1/jots/text -d "Hello world"

Draft by default. Add ?visibility=public to publish immediately.

Create with an API key

curl -H "Authorization: Bearer <api_key>" -X POST https://jotspot.io/api/v1/jots/text --data-binary @notes.md

Create from stdin

cat README.md | curl -X POST https://jotspot.io/api/v1/jots/text --data-binary @-

Edit with a manage token

curl -X PATCH "https://jotspot.io/api/v1/jots/abc123/text?token=<owner_token>" --data-binary @notes.md

Add &visibility=public to publish, or &visibility=draft to unpublish.

Edit as an authenticated user

curl -H "Authorization: Bearer <api_key>" -X PATCH "https://jotspot.io/api/v1/jots/abc123/text" --data-binary @notes.md

Fetch raw text

curl https://jotspot.io/j/abc123.txt
curl https://jotspot.io/j/abc123.md
curl -H "Accept: text/plain" https://jotspot.io/j/abc123

Plain text response mode

curl -s -X POST "https://jotspot.io/api/v1/jots/text?format=text" -d "Hello"

Sample JSON response

{
  "success": true,
  "jot_id": "x93dst55",
  "url": "https://jotspot.io/j/abc123",
  "raw_url": "https://jotspot.io/j/abc123.txt",
  "manage_url": "https://jotspot.io/manage/abc123/<token>",
  "visibility": "draft"
}

Ownership modes

Anonymous: Anonymous jots return a private manage URL. Keep that URL or token to edit from the browser or CLI.
Account-owned: Signed-in users can generate an API key in settings and send it as Authorization: Bearer <api_key>.
Visibility: CLI text endpoints create drafts by default. Pass ?visibility=public to publish immediately or when editing.

Returned fields

success: Boolean success flag for quick shell checks.
jot_id: The jot slug used in /j/<id>.
url: The normal jot page URL.
raw_url: The raw markdown URL.
manage_url: The private ownership URL to open in a browser for editing.
visibility: The initial jot visibility. Terminal-created jots start as draft.