For AI and voice assistants
"Add milk and eggs to the grocery list."
An assistant can make a list with no key. After that it needs the list key to add items, check them off and read the list back. Last checked 17 November 2026.
Where the key comes from
When an assistant makes a list, the answer includes the key, a link to share and a link for the person who owns the list. For any list, its share link is enough. A share link looks like https://lists-free.openapps.xyz/l/<list id>#<code>, and the key is the 20-character list id followed by the 24-character code after the #, with nothing between them. Everyone on the list has the share link, so anyone on the list can give it to an assistant. The person who made the list can also copy the key itself: open the list, tap list settings, then People and link, and copy it under "For assistants". The key works like the share link: anyone who has it can read and change the list, so give it only to assistants you trust.
Examples
# Make a new list: no key needed curl -X POST https://functions.openapps.xyz/apps/ee59501e91bae6d2c23a8370/api/lists \ -H 'content-type: application/json' \ -d '{"name": "Groceries", "items": ["bananas", "bread"]}' # Add to a list curl -X POST https://functions.openapps.xyz/apps/ee59501e91bae6d2c23a8370/api/list/items \ -H 'x-list-key: YOUR_LIST_KEY' \ -H 'content-type: application/json' \ -d '{"text": "milk and eggs, 2 lb chicken"}' # Read it back, in store order curl https://functions.openapps.xyz/apps/ee59501e91bae6d2c23a8370/api/list \ -H 'x-list-key: YOUR_LIST_KEY'
Full reference
llms.txt (plain text), openapi.json and index.md.