Gladys URL Callback Scheme

Gladys is a shelf app for iOS and macOS. Find out more about it here.


Please note that Gladys now has extensive support for all these functions (and more) via App Intents on all supported platforms. You may find it more intuitive to use this new interface through Shortcuts, rather than the x-callback-url interface here. 


Pasting Items from the clipboard

gladys://x-callback-url/paste-clipboard?...

Parameters are all optional. All values must be properly url-encoded.

title: A title to use to override the name of the item being pasted.

labels: A comma-separated list of labels that will be added to the item that is being pasted.

note: Text to add as a note for the item being pasted.

 

Example

gladys://x-callback-url/paste-clipboard

?title=Override%20The%20Title

&labels=Pasted%20Items,New%20Items

&note=Some%20Notes


Creating a new item

gladys://x-callback-url/create-item?...

You must specify either 'text', 'url', or ‘base64data‘. The other parameters are optional.  All values must be properly url-encoded.

text: Create an item with this text, OR:

url: Create an item with this URL, OR:

base64data: Created an item with this binary data, encoded as a base 64 string

title: A title to use for the item being created.

labels: A comma-separated list of labels that will be added to the item that is being created.

note: Text to add as a note for the item being created.

 

Examples

A new text item

gladys://x-callback-url/create-item

?text=Hi%20There

&title=Greeting

&labels=Created%20Items,New%20Items

&note=Some%20Notes

 

A new url item

gladys://x-callback-url/create-item

?url=http://bru.build

&title=The%20Gladys%20Guy

&labels=Developer,iOS,macOS,Embedded

&note=Some%20Notes

A new binary data item

gladys://x-callback-url/create-item

?base64data=RXhhbXBsZSB0ZXh0IGZpbGUuCg==

&title=Test.txt

&labels=Text%20Files

&note=Pretending%20I%20am%20a%20file


More Info

For more details on the x-url-callback scheme and how it works, please visit the page of the spec. Gladys supports the x-success and x-error parameters from the spec.