> For the complete documentation index, see [llms.txt](https://doc.celantur.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.celantur.com/cloud-api/authorization.md).

# Authorization

Authenticating with Celantur Cloud API

Celantur Cloud API is only usable when a user is authenticated. 🔒

Files are assigned to the user who has uploaded them. Other users can't access your files.

## How to get your authorization token

1. Create a new account or log in to app.celantur.com.
2. Use your app.celantur.com credentials with the [API Endpoints](/cloud-api/api-endpoints.md#sign-in-authorization) API endpoint to receive your authorization token.
3. Use the authorization token for interacting with the [API Endpoints](/cloud-api/api-endpoints.md)

```python
import requests

def main():
  credentials = {'username': 'xxx', 'password': 'xxx'}
  response = requests.post(
    'https://api.celantur.com/v2/signin/',
    json=credentials,
    headers={'Content-Type': 'application/json'}
  )
  auth_token = response.json()['AccessToken']

  status = requests.get(
    'https://api.celantur.com/v2/task/' + task_id + '/status',
    headers={'Authorization': auth_token}
  )
```

The access token expires after `ExpiresIn` seconds (typically 3600). Sign in again to obtain a new token.
