Candidate accounts and talent

Build candidate profiles and resume import, then expose the permitted talent directory.

Build two deliberately separate experiences: a candidate’s private profile editor under board.me, and the board’s public or employer-only talent directory under board.talent.

Prerequisites

board.context().features.candidates is true for candidate accounts.
A server-owned board-user session for every board.me request.
features.talentDirectory checked before creating a talent route (!== 'off').

The examples expect a stateless server client and pass the access token per call.

Load and update the candidate profile

1// src/data/candidate-profile.ts
2import type { FetchOptions, UpdateCandidateProfileBody } from '@cavuno/board';
3
4import { board } from '../lib/board';
5
6function session(accessToken: string): FetchOptions {
7  return {
8    cache: 'no-store',
9    headers: { authorization: `Bearer ${accessToken}` },
10  };
11}
12
13export function loadCandidateProfile(accessToken: string) {
14  return board.me.profile.retrieve(undefined, session(accessToken));
15}
16
17export function updateCandidateProfile(
18  accessToken: string,
19  input: UpdateCandidateProfileBody,
20) {
21  return board.me.profile.update(input, undefined, session(accessToken));
22}

update is a merge patch: omitted fields remain unchanged. Check handle availability before submission for responsive feedback, but treat the update response as authoritative because availability can change.

For the candidate's location, use a board.locations.search picker and send the picked id as locationId, with commuteRadiusKm and openToRelocate next to it. Job matches use these to keep on-site and hybrid jobs within commuting distance. Show the distance in miles for a US or UK home and kilometres elsewhere; see Home location and commute distance.

Import a resume

Resume parsing is asynchronous. Upload once, then poll until parseStatus is parsed or failed.

1export async function importResume(accessToken: string, file: Blob) {
2  const options = session(accessToken);
3  let resume = await board.me.resume.upload(
4    file,
5    { keepResumeOnFile: true, importMode: 'append_only' },
6    options,
7  );
8
9  while (resume.parseStatus === 'parsing') {
10    await new Promise((resolve) => setTimeout(resolve, 1_500));
11    resume = await board.me.resume.retrieve(options);
12  }
13
14  if (resume.parseStatus === 'failed') {
15    throw new Error(resume.parseFailureReason ?? 'Resume parsing failed');
16  }
17
18  return board.me.profile.retrieve(undefined, options);
19}

Use replace_all only after an explicit confirmation. The SDK requires confirmReplaceAll: true for that destructive import mode.

Load the talent directory

1export async function loadTalent(
2  skill: string | undefined,
3  employerAccessToken?: string,
4) {
5  const context = await board.context();
6
7  if (context.features.talentDirectory === 'off') return null;
8
9  return board.talent.list(
10    { skill, limit: 20 },
11    employerAccessToken ? session(employerAccessToken) : undefined,
12  );
13}

Only public profiles appear. On an employers_only board, anonymous requests throw a 403 talent_directory_restricted; render an employer sign-in or upsell rather than pretending the directory is empty.

Expected result

The private account loader returns the signed-in candidate’s profile and parsed resume state. The talent loader returns only profiles visible to the current viewer, or no route when the directory is off.

Verify the result

Candidate profile responses never enter a shared cache.
A profile update returns the edited values from the server.
Resume import reaches parsed or shows the returned failure reason.
Hidden and logged-in-only profiles do not appear in anonymous talent reads.
An employers-only directory distinguishes 403 restricted access from 404 disabled access.

Production cautions

Stop polling when the request is aborted or the user leaves the page.
Keep short-lived resume download URLs out of logs and durable caches.
Do not expose board.me profile data through public loaders.
Treat jobSearchStatus: null in a talent profile as an intentional visibility outcome.

Next, let candidates act on jobs with Applications.