API Authentication

1 min read Updated 1 month 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

Note: The API token creation feature is not publicly available yet but will be available soon.

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

Once available, you'll be able to:

  • Create tokens: Generate new personal access tokens with custom names and optional expiration dates
  • List tokens: View all your active tokens (token values are never shown after creation)
  • Revoke tokens: Immediately invalidate tokens you no longer need

Token Scopes

All tokens have full API access.

Rate Limiting

API requests are rate limited to:

  • 60 requests per minute per user
  • Rate limit is based on authenticated user ID
  • HTTP 429 status code is returned when limit is exceeded

Token Expiration

By default, personal access tokens expire after 6 months. You can set custom expiration dates when creating tokens, or create non-expiring tokens for long-term integrations.

API Documentation

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