Command line (curl)

Every machine with curl can work with Clipline – a server you just logged into, a colleague's laptop, a container, a VM console. Use a session if there is no account on that side, or your API token for your own entries.

Sessions: short addresses

A session (see Sessions) has one short address, https://clipline.roedlach.tirol/s/{code}. It is the share link too: in a browser it opens the session page, in curl it lists the entries.

Fetch

curl https://clipline.roedlach.tirol/s/aB3-x9Z            # list: numbers, type, age, content
curl https://clipline.roedlach.tirol/s/aB3-x9Z/last       # print the newest entry (also: latest)
curl https://clipline.roedlach.tirol/s/aB3-x9Z/2          # print entry 2
curl -fOJ https://clipline.roedlach.tirol/s/aB3-x9Z/1     # save entry 1, a file, under its own name

The list looks like this, oldest first so the newest one is right above your prompt:

Clipline session aB3-x9Z, 12 min left

  #  TYPE  AGE    ENTRY
  1  file  6m     deploy-notes.pdf (48 KB)
  2  text  2m     ssh [email protected]

Print the newest:  curl https://clipline.roedlach.tirol/s/aB3-x9Z/last
Print entry N:     curl https://clipline.roedlach.tirol/s/aB3-x9Z/N
Save file N:       curl -fOJ https://clipline.roedlach.tirol/s/aB3-x9Z/N
Send text:         echo "hello" | curl -T - https://clipline.roedlach.tirol/s/aB3-x9Z
Send a file:       curl -T notes.txt https://clipline.roedlach.tirol/s/aB3-x9Z/

Entries keep their number for as long as they exist: entry 2 is still entry 2 when more arrive.

Send

No account needed – the code is enough, as on the session page.

ip a | curl -T - https://clipline.roedlach.tirol/s/aB3-x9Z          # output of a command (PUT)
echo "hello" | curl -T - https://clipline.roedlach.tirol/s/aB3-x9Z  # text
curl -d "hello" https://clipline.roedlach.tirol/s/aB3-x9Z           # text (POST)
curl -T notes.txt https://clipline.roedlach.tirol/s/aB3-x9Z/        # a file; keep the / – curl adds the file name
curl -F [email protected] https://clipline.roedlach.tirol/s/aB3-x9Z   # a file (POST, form upload)

The answer tells you the number:

Saved as entry 3 of session aB3-x9Z.
Get it with: curl https://clipline.roedlach.tirol/s/aB3-x9Z/3

Text loses the line break echo adds at the end, so it can be pasted into a shell without running right away. Data that isn't text (e.g. curl -T - < image.png) is saved as a file named upload.bin, and text longer than a million characters as upload.txt. Entries can be up to 100 MB.

Burn after reading

Add ?burn (with quotes, so the shell leaves the ? alone) and the text is deleted with its first copy – on the web page, in a client or with curl:

echo "$TOKEN" | curl -T - 'https://clipline.roedlach.tirol/s/aB3-x9Z?burn'

The list shows such an entry as 🔥 burn after reading (fetching it deletes it) instead of its text. Fetching it (curl https://clipline.roedlach.tirol/s/aB3-x9Z/3, or /last) prints the text once and deletes the entry for everyone, also when you sent it yourself. Text only: a file, binary data or text over a million characters with ?burn answer 422. Opening the address in a browser, a curl -I (HEAD) or a chat app's link preview doesn't burn it: they get a note instead of the text.

Errors

Private entries of a session are not available via curl.

With your account

Create an API token with read (and create to add entries) and send it with --oauth2-bearer. You get the entries of all your teams, including your private ones. Here 1 is always the newest entry.

TOKEN=your-api-token
curl --oauth2-bearer $TOKEN https://clipline.roedlach.tirol/api/list
curl --oauth2-bearer $TOKEN https://clipline.roedlach.tirol/api/latest
curl -fOJ --oauth2-bearer $TOKEN https://clipline.roedlach.tirol/api/entry/2
curl --oauth2-bearer $TOKEN https://clipline.roedlach.tirol/api/team/1/list             # only team 1

curl --oauth2-bearer $TOKEN -F entry="hello" https://clipline.roedlach.tirol/api/entry
curl --oauth2-bearer $TOKEN -F [email protected] https://clipline.roedlach.tirol/api/entry
curl --oauth2-bearer $TOKEN -F entry="secret" -F password=true https://clipline.roedlach.tirol/api/entry   # only you

A missing or wrong token answers 401, a team you are not in 403.

All addresses

For everything else the clients use, see the API.