Authentication
Bearer keys for the Plurall AI API: issue, rotate, and revoke.
GET/api/v1/scans
curl -X GET https://api.plurall.tech/api/v1/scans \
-H "Authorization: Bearer $PLURALL_API_KEY"- Operation
- List scans
- Scopes
- scans:read
- Request
- none
- Response
- 200 ScanList
Every Plurall AI API request is authenticated with a bearer key. Keys are scoped to a single environment (production, staging, or sandbox) and a configurable subset of permissions. Manage keys in the Integrations console.
Issuing a key
Open Integrations -> API keys -> New key. Choose a label, an environment, and the scopes that match the workload. Plurall AI returns the full key value once; copy it into your secret manager. After this point only a masked prefix is visible.
Making a request
Send the key in the Authorization header. The example submits a single piece of media for scanning. The response includes the scan id; poll GET /api/v1/scans/{id} until status is "complete", or subscribe to the scan.completed webhook.
Rotating without downtime
Issue a new key, swap it in your runtime, and only revoke the old key after the Integrations table reports that it has not been used in the last hour. Plurall AI surfaces last-used timestamps in real time so you can confirm the cutover before revocation.