API authentication

1 min read Updated 3 months ago

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 "Authorization: Bearer YOUR_API_TOKEN" \
       https://ploi.cloud/api/v1/applications

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