API key template

April 24, 2019 ยท View on GitHub

If you want to add a new API key to the documentation, add it to the table of contents and follow the template below.

The section for one API key must include a Revoke a key subsection. It may include a Check for suspicious activity subsection (only if there is a way to do so).

See an example (Slack) below.

API key template

Slack

Revoke a key

Slack tokens are very convenient because they have the power to revoke themselves thanks to the auth.revoke API method! Easy as a command line:

curl "https://slack.com/api/auth.revoke?token=xoxp-YOUR-TOKEN-HERE"

Check for suspicious activity

There is an audit logs api which is only available to Enterprise Grid customers.