Troubleshooting
The handful of things that actually go wrong before an interview, and what to do about each.
3 min read
| Symptom | What to do |
|---|---|
| The app says screen recording is denied, but I just granted it | On macOS a new screen-recording grant takes effect only after the app restarts. Quit it fully and reopen; the wizard will confirm. |
| The join link says the session is not joinable | Links are per participant and per role, and they expire. Ask the interviewer to mint a fresh one — it takes a second and does not disturb the others. |
| The candidate's network dropped mid-session | Nothing is lost. The agent buffers locally and resumes the upload; the session page fills in as the backlog clears. |
| Evidence is missing after the session ended | Uploads finish in the background after a session ends. If a piece is still absent an hour later, that is worth reporting. |
| A webhook endpoint was disabled | That happens after repeated consecutive delivery failures. Fix the receiver, re-enable it in Developers → Webhooks, and replay the deliveries from the log. |
| A 429 from the API | You hit a rate-limit ceiling. RateLimit-Scope says which one, and Retry-After says how long to wait; the SDK honours both automatically. |