Frequently Asked Questions

Common questions about accounts, assessments, candidates, AI scoring, integrations, the API, and security.

Jump to a section: Account, trial & billing · Jobs, templates & assessments · Candidate experience · AI & scoring · Integrations · Partner API · Security & privacy

Account, trial & billing

How do I sign in? Go to https://hr.cocolevio.com and sign in with your email and password, or via Google or Microsoft SSO. If your company enabled two-factor authentication, you'll also enter a code from your authenticator app.

Can I use single sign-on? Yes — SSO with Google and Microsoft is supported.

How is billing handled? Payments are processed by Stripe. Coco HR does not store your card number. Manage your plan and payment method from the dashboard.

What are "tokens"? Partner API and AI usage are metered in two token types: assessment tokens (one per prepare_assessment call) and resume tokens (one per AI resume parse). Fast resume contact extraction consumes no tokens. If your quota is exhausted, metered API calls return an error until the quota resets or is topped up.

Jobs, templates & assessments

What's the difference between a job, a template, and an assessment? A job is the role you're hiring for. A template is the question-set configuration (how many questions, time per question, answer mode, coding on/off). An assessment ties a job and template together with the actual questions. In the API, prepare_assessment creates all three in one call.

What question types are there?

  • Theory questions, AI-generated from the skills you specify.
  • Coding challenges, optionally enabled per skill.
  • Multiple choice, which is auto-graded.

What are the answer modes?

  • audio — the candidate speaks; answers are transcribed and evaluated.
  • both — the candidate chooses to type or speak.

Can I edit an assessment after creating it? Yes. Update it from the dashboard, or via POST /apikey/update_assessment, which re-generates the questions. Candidates who already finished keep their original results; only new candidates see the updated questions.

Can I delete an assessment? Only if no candidate has taken it yet. Once someone has submitted, deletion is blocked to preserve the record — update the assessment instead. Via the API this returns 409 Conflict.

Is there a public application link? Yes. Every job has a public URL, https://hr.cocolevio.com/job/<job_id>, where candidates can apply and upload a resume with no pre-registration. These applicants show up in your applicant list.

Candidate experience

What does a candidate need to take an assessment? A modern desktop browser. There's no app or SDK to install. They open the unique assessment link, grant camera/microphone permission, and begin.

Are candidates recorded? Yes — webcam video, screen recording, and periodic snapshots are captured for integrity review, and candidates consent before starting. See Anti-cheat and proctoring.

Can candidates copy and paste during the test? No. Copy/paste is blocked during the assessment.

What happens when time runs out? The answer is auto-submitted. Time-based auto-submit is the only automatic action the system takes.

Can a candidate request accommodations? Yes — the assessment includes an accessibility accommodation option.

AI & scoring

How are answers scored? Theory answers are scored by an LLM on Completeness, Relevance, and Technical (each out of 5). Coding submissions are scored on Technical Proficiency, Problem Understanding, and Solution Accuracy. Each question becomes a percentage with a badge (Meets Standard ≥60% / Partial / Inadequate); the overall score is the average. MCQs are auto-graded. See How AI scoring works.

Are spoken answers transcribed? Yes — speech is transcribed (Whisper / OpenAI) and then evaluated like a typed answer. The transcript is included in the report.

Does the AI decide who to hire? No. There is no automatic hire/reject verdict. A human recruiter reviews the report and sets the verdict (Pending / Selected / Rejected).

Can we use our own AI model? Yes. A company can configure OpenAI, Anthropic, OpenRouter, Groq, Mistral, or a custom endpoint. Scoring quality depends on the model you choose — see Responsible AI and fairness.

Does the platform do face detection? No. There is no automated face or multiple-face detection. Recordings are provided for human review.

Integrations

Does Coco HR integrate with Greenhouse? Yes — an optional Greenhouse ATS integration is available. Connect it from your dashboard settings.

Can I push assessments and pull reports from my own system? Yes — that's what the Partner API is for. See the Partner API reference.

Partner API

How do I authenticate? Send Authorization: ApiKey <your-api-key> on every request (except the two key-management endpoints, which use your logged-in browser session).

Where do I get an API key? Sign in as a Company Admin → API Management → Generate New Key (or Settings → API Keys), or call GET /apikey/fetch-api-key while logged in.

How do I rotate a key? Generate a new key — it replaces the old one immediately. There's no separate revoke step.

Do I have to store Coco's internal IDs? No. You pass your own integer IDs (p_candidate_id, p_job_id, job_id) and every endpoint accepts them back. Reuse the same p_candidate_id for process_candidate and get_candidate_report.

How do I try the API quickly? Import the OpenAPI spec into Postman or Insomnia from https://hr.cocolevio.com/partner-api/openapi.json, or browse the live docs at https://hr.cocolevio.com/developers.

Security & privacy

Where is my data hosted? On AWS. Each company's data is isolated per tenant.

How is access secured? JWT sessions, optional TOTP two-factor, Google/Microsoft SSO, bcrypt-hashed passwords, and login anomaly detection that can lock suspicious accounts.

Where are recordings and resumes stored? In AWS S3. The report includes playback and snapshot links.

Who are the sub-processors? AWS (hosting, storage, email), Stripe (payments), OpenAI/Anthropic (AI, default providers), Cloudflare (bot protection), and Greenhouse (optional ATS). See Security and privacy.

How do I delete candidate data? Use the dashboard's archive/delete controls, or contact support@cocolevio.com for data-subject requests.

Still stuck? See Troubleshooting or email support@cocolevio.com.