Developers
Here you can find all the information you need to integrate with our API.
CLI
Install the pento CLI to interact with the API from your shell. This is a bash wrapper over a curl but provides QoL improvements such as file piping and slim STDOUT.
Warning!
Don't run scripts from the internet without understanding what they do.
View the script here: https://pento.page/developers/script
$ mkdir ~/bin $ curl https://pento.page/developers/script > ~/bin/pento $ chmod +x ~/bin/pento $ export PATH=$PATH:~/bin
API
Use the following curl command to interact with the API. This example creates a new note with the title " == TITLE ==". The content of the note is " == YOUR DATA HERE ==". The note is public and has the tag "tag".
Using a wrapper over this shell is recommended!
Request
curl --request POST \ --url https://pento.pockethost.io/api/custom/notes \ --header 'Accept: application/json, text/plain, */*' \ --header 'Connection: keep-alive' \ --data '{ "content": "== YOUR DATA HERE ==", "title": " == TITLE ==", "encrypted": false, "type": "raw", "tags": "tag", "visibility": "public" }'
Response
"data": { "created": "2024-09-27 09:57:52.030Z", "id": "ivw9mmet791q7pp", "shortcut": "microscopic-hollow-translator", "tags": [ "ykks2pmtfv2w3hc" ], "title": "test curl", "type": "raw", "updated": "2024-09-27 09:57:52.030Z", "visibility": "public" }, "success": true