These endpoints are intended for administrators and platform operators only. Most users will receive a pre-configured token and do not need to interact with these APIs directly.
The Data Ingestion API uses JWT-based access tokens to authenticate requests. Administrators can generate tokens with specific permission scopes, list active tokens, and revoke tokens that are no longer needed.
Available permissions
Tokens are scoped to specific capabilities. Request only the permissions your integration requires.
| Permission | Description |
|---|
workflow:* | Full workflow access (video and document processing) |
workflow:video | Video processing jobs only |
workflow:document | Document processing jobs only |
file:* | Full file management access |
file:list | List uploaded files |
file:upload | Upload new files |
token:* | Full token management access |
token:generate | Generate new tokens |
token:list | List existing tokens |
token:revoke | Revoke tokens |
Tokens with token:generate can only create tokens with permissions equal to or less than their own scope. A token cannot escalate privileges.
Common workflows