# Authentication

The Tability API uses Personal API tokens to authenticate requests.

You can view your Personal API token from your **Account details** page accessible at <https://tability.app/account>.

Most API calls are scoped to a specific workspace, and your user account will need to have the **API access** setting enabled for that particular workspace (see [Setup guide](/api/getting-started/setup-guide.md)).

## Authenticating requests

To authenticate your requests, you will need to provide your Personal API token in in the `Authorization` header of the request:

```bash
curl -H "Authorization: API <personal_api_token>" https://api.tability.app/v2/whoami
```

Personal API tokens are tied to the corresponding Tability user account. **Using the token will provide the same level of access and privileges as the associated Tability user would have in the specific workspace.**

{% hint style="warning" %}
Keep your **Personal API tokens** secured! Do not share them in emails, chat messages, client-side code or publicly accessible sites.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guides.tability.io/api/tability-api/authentication.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
