Click anywhere to close

Complicated API Documentation

The complicated API is incredibly simple. It’s only a single endpoint!


Base URL

The API is available at

base_url = 'https://customcomplication.mikelyons.org/complicated/set/'


Authentication

The API is authenticated using an API key. You can get your API key from the app once you have initialized it (by installing the app, see Complicated How To). To use the API, append your API key to the base url.

request_url = base_url + api_key
// example: https://customcomplication.mikelyons.org/complicated/set/abc1234


Update complication text

You can use this new endpoint to update any complication in the app. If you want to copy a pre-prepared link, you can do so from the update link part of the app after selecting a complication.

All requests are GET requests

The endpoint structure is as follows:

GET https://customcomplication.mikelyons.org/complicated/set/<api key>/<complication type>?value=<new value>

The values you need to fill in here are:

Example request

curl https://customcomplication.mikelyons.org/complicated/set/1234abcd/modularLarge?value=Stocks%0AAAPL%20%24152.29

This request will set the modularLarge complication to:

Stocks
AAPL $152.29

Note: Watch OS Only lets you change a complication ~15 times and hour. More than that and you likely will get rate limited.

If you have any other questions please feel free to reach out. My email is mdl0394@gmail.com


Other Tutorials

Here are some other resources to help you use Complicated: