FAQ
The most common questions about integrating and using the Evalyo API.
API keys
There is no limit on the number of active keys per organization. We recommend creating one key per application or service to make rotation easier.
Revoke it immediately from Integrations → API keys (... icon → Revoke). Then create a new key with the same scopes and replace it in your application.
No, scopes are set at creation time. To change permissions, revoke the key and create a new one with the scopes you need.
Interviews
Check that: (1) the candidate has accepted the invitation, (2) your browser allows microphone access, (3) the LiveKit connection is established. Review the logs in your dashboard.
No, an interview that has finished (status completed) cannot be restarted. You can create a new interview for the same candidate and the same job posting.
The recordingUrl field in the GET /api/v1/reports/interviews/:id response contains the signed URL of the recording (valid for 24h).
Billing & quotas
An interview is deducted from your quota as soon as it moves to the in_progress status. Interviews cancelled (cancelled) before they start are not counted.
The API returns a 402 error with the INSUFFICIENT_CREDITS code. Top up your quota from the Billing page or upgrade to a higher plan.
Security
Yes. All data is encrypted at rest (AES-256) and in transit (TLS 1.3). Audio recordings are stored in private S3 buckets with signed access.
Data is hosted in Europe (GCP europe-west1, Belgium) and never leaves the EU. Evalyo is GDPR-compliant.
Yes, via the DELETE /api/v1/candidates/:id endpoint (candidates:write scope). All associated data (interviews, recordings) is irreversibly deleted within 30 days.