Gladys URL Callback Scheme

Gladys is a shelf app for iOS and macOS. Find out more about it 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.