# API authentication

> Learn how to authenticate with the Ploi Cloud API.

API authentication
------------------

The Ploi Cloud API uses OAuth2 token-based authentication. All API requests must include a valid Bearer token.

### Getting your API token

To create an API token:

1. Navigate to **Settings** in your user menu
2. Click on **API keys** in the sidebar
3. Click **Create new key**
4. Enter a descriptive name for your token
5. Copy the generated token immediately - it will only be shown once

### Using your token

Include your token in the Authorization header:

```
curl -H <span class="hljs-string">"Authorization: Bearer YOUR_API_TOKEN"</span> \
       <span class="hljs-attr">https</span>:<span class="hljs-comment">//ploi.cloud/api/v1/applications</span>
```

### Token management

You can manage your API tokens from the **Settings > API keys** page:

- **Create tokens:** Generate new personal access tokens with custom names
- **List tokens:** View all your active tokens including creation date and last usage (token values are never shown after creation)
- **Revoke tokens:** Immediately invalidate tokens you no longer need by clicking the delete button

### Token scopes

All tokens have full API access for all teams your user has access too.

### API documentation

For complete API endpoint documentation, visit <https://ploi.cloud/docs/api>