Authentication

The Plati AI API uses API keys for authentication. You’ll need to include your API key in the Authorization header of all your requests.

Obtaining API Keys

API keys can be generated from your workspace. To create a new API key:

Navigate to your workspace in the Plati AI dashboard
Go to “API Keys” section
Click “Create API Key”
Choose a descriptive name for your key
Select the appropriate role:
- read-only - Can only read data
- read-write - Can read and modify data
Store your API key securely - it will only be displayed once

Include your API key in the Authorization header of all requests:

curl -X GET https://api.plati.ai/workers \
  -H "Authorization: Bearer YOUR_API_KEY"

Follow these best practices to keep your API keys secure:

Never expose API keys in client-side code
Don’t commit API keys to version control
Use environment variables to store keys
Implement key rotation periodically
Create separate keys for different environments (development, staging, production)
Apply the principle of least privilege (use read-only keys when write access is not required)

API keys have different roles that determine their permissions:

Role	Description
`read-only`	Can only retrieve data, cannot make changes
`read-write`	Can both retrieve data and make changes

Choose the appropriate permission level based on your integration needs.

If an API key is compromised, you should immediately revoke it:

Once revoked, all requests using that key will be rejected.