API tokens allow you to access our platform using your user's specific permissions. These tokens act on your behalf, meaning any API operations performed will be executed with your exact user credentials and access permissions.
For more information you can check our API documentation.
To find your API token / Refresh token navigate to My settings > API tokens:
What You Can Do with the API
Reads through the API are broad. Writes are limited to the set of published mutations, and new ones are added over time — the API documentation above is the authoritative list of what is currently available, rather than this article.
Some actions specifically have no API equivalent and have to happen inside Shapes. Approving or denying a time-away booking is one of these: there is no mutation for it today.
Workflow runs can be triggered through the API using the createWorkflowEmployeeAssignments mutation, with the workflows and workflowEmployeeAssignments queries available for managing them — for example, from a button in an external system that starts a request flow for an employee.