* docs: fix and improve details on sending authenticated requests with API token * fix security schema