Workflows

Current coded workflow

1. Recruiter creates or imports a candidate.
2. A reference request starts in either candidate_intake or manual_references launch mode.
3. In candidate_intake, the candidate receives a public intake link, grants permission, confirms work history, and submits referee contacts.
4. In manual_references, the recruiter or agent supplies referee contacts up front and the request starts in collection.
5. Referees receive email/SMS outreach and scheduled reminders.
6. Referees complete the agentic reference chat or legacy response path.
7. Veref extracts evidence, updates work-history verification, cancels reminders for completed referees, and moves the request to recruiter review when all contacts have responded.
8. The recruiter or agent drafts, approves, and shares the customer-safe report.

Headless agent workflow

The recruiter app chat, the local CLI, Claude, GPT, Codex, and partner agents are all clients for the same reference-check workflow.

1. Agent starts the request with veref references start or POST /v1/api/reference-requests.
2. By default, launchMode is candidate_intake: the candidate token drives permission, work-history extraction, and referee contact collection.
3. For known referees, the agent can set launchMode to manual_references and provide contacts with both email and phone so referee outreach starts directly.
4. Referee checks continue through public referee tokens and the agentic reference conversation.
5. Agent inspects state with veref references get.
6. Agent can ask veref agent ask / POST /v1/api/agent for workspace guidance backed by the same agent tools.
7. Agent requests recruiter review or drafts, approves, and shares the report when the workflow is ready.

See Agent CLI and Endpoint Reference for the callable surface.

Target Veref hiring flow

1. Candidate completes mobile identity verification before interview access.
2. Candidate joins the browser-native interview room.
3. Active challenges, virtual camera checks, and live behavioral signals establish integrity in real time.
4. The candidate receives a portable Veref Passport after verification.
5. Verified references are collected and linked back to the same candidate-owned record.

Recruiter flow

1. Review inbox.
2. Trigger reminders or approve agent suggestions.
3. Read evidence-backed report.
4. Move the candidate to the next stage.