apply_to_job
ChatGPTApply the signed-in candidate to one open WORKFORCE shift. Acts only on this candidate’s own account and sends the application to WORKFORCE and the office. confirm false previews and writes nothing. Preferred candidates on Managed or Full Service are assigned immediately after confirm true — the preview says so. New grads (career start under 3 months, or a *** name prefix) must set acknowledgeNewGradRate true after the $5/hr terms. Same Worker Required needs acknowledgeSameWorkerDays. Never returns the office name or street before assignment.
broadcast_temp_availability
ChatGPTPublish this candidate’s temp availability broadcast (the Availability pin offices and recruiters use for outreach). When the user asks to let offices know they are available, call this tool directly with dateKeys (YYYY-MM-DD, from today through 4 calendar months ahead) and commuteKm. Day limit per broadcast: up to 10 days, or up to 20 once the candidate has worked a WORKFORCE shift before. The preview returns this candidate’s own limit (maxDays and a dayLimit sentence to show them); too many days or a day more than 4 months out returns VALIDATION_ERROR explaining the limit. A published broadcast stays live for 14 days. Associate dentists only: no day cap and days up to 9 months ahead, and they can instead pass mode RECURRING (weekdays + startDateKey + endDateKey, e.g. every Friday) or BLOCK (startDateKey and an optional endDateKey; no end = open-ended), with optional exceptionDateKeys to carve days out. Ask associates first: do they have a handful of days for extra work, or blocks / recurring time for locum work? Recurring and block broadcasts stay live while the associate answers a confirmation ping every 30 days, and offices see one summary line (e.g. "Available every Friday, Nov 6 – Dec 31"), never a day list. Other professions must use individual dateKeys. Non-associates can also broadcast for a permanent job: ask first whether they want temp days only, a permanent job, or both (availabilityKind TEMP / PERM / BOTH). PERM and BOTH need a permNote of at least 100 characters; tell them: "When you broadcast your permanent availability, offices will be able to read this. Your bio is already included, so tell offices what kind of schedule, office, culture and type of work you're looking for." PERM needs no dateKeys. The permanent part stays live while the candidate confirms every 30 days; BOTH keeps the 14-day rule and day limit for its temp days. Do not call get_candidate_setup_pack or get_my_profile_status first: this tool checks the profile itself and returns NOT_READY with what is missing when it cannot publish. Step 1: confirm false (or omitted) returns a preview with a summary and an idempotencyKey and writes nothing. Show the summary and ask the user to confirm. Step 2: on yes, call again with the same dateKeys and commuteKm, confirm true, and that idempotencyKey. A retry with the same key returns the original result. Requires a complete and verified WORKFORCE profile. Do not call during signup. A Deactivated account cannot broadcast; the tool returns a neutral error and writes nothing. Does not list offices. When this connection is in dry-broadcast mode, or the candidate is a designated test viewer or the nightly e2e candidate, confirm true still saves the pin for status tools but suppresses it from office availability maps, the recruiter ops map, and availability email blasts. The response says it was suppressed.
confirm_my_shift
ChatGPTConfirm a booked WORKFORCE shift. Opens 48 hours before start. confirm false previews and writes nothing.
create_my_candidate_upload_slot
ChatGPTCreate a short-lived upload link for one document on the signed-in candidate’s own WORKFORCE profile (profile photo, resume, dental licence, or course certificate). Use it only when the file cannot be passed to upload_my_candidate_document as an https URL. Returns putUrl, headers, storagePath, expiresAt, and maxBytes. Send the original file bytes to putUrl with HTTP PUT, then call upload_my_candidate_document with the returned storagePath to attach it. This tool does not change the profile by itself, cannot reach any other person’s account, and the link expires on its own. ID verification is not done in this assistant; the candidate finishes it in the WORKFORCE app.
create_or_update_my_candidate_profile
ChatGPTIdempotent create/update of this token’s WORKFORCE candidate only (subject Candidate.id). Creating a profile requires firstName, lastName, email, and profession; a VALIDATION_ERROR names every missing field. Returns status (percent, missing[]) and, the first time profession and region are both known, the scoped pack2 cell. Do not call get_my_profile_status after this write. For every required document (photo, resume, license, CPR, Ontario DA path docs, EFDA credential, other REQUIRED certs), call upload_my_candidate_document — it attaches the file and returns status. If that attachment is only a local box path, call create_my_candidate_upload_slot, PUT the raw bytes to putUrl, then upload_my_candidate_document with the returned storagePath. ID verification is finished in the WORKFORCE app, not in this assistant. Do not ask for ID documents or ID numbers here. It does not block ready or missing[]. Never browse the candidate’s device. Never send another candidateId.
flag_perm_interest
ChatGPTTurn permanent-role interest on or off for this candidate (jobVisibility). Requires a complete and verified WORKFORCE profile.
generate_bio_from_resume
ChatGPTDraft a first-person bio from this candidate’s latest RESUME (or a resumeUrl that is their Storage object). Returns a cached draft instantly when extract + draft already ran at resume upload. Optional regenerate/force re-extracts and re-drafts, and a long resume may be sent to an external model to draft the text. A short resume stays on the in-app heuristic. Returns { bio, source, maxChars } draft text only — the profile bio is not saved and nothing is published. Read it back and wait for approve or edit. Do not save until they confirm via create_or_update_my_candidate_profile { bio }. Candidate bio hard maximum is 800 characters. Auto-drafts are generate-to-fit within 800 characters and should end as complete sentences (no mid-sentence "…"). If the candidate wants something longer, tell them the 800-character limit and offer to edit down to fit (or save a capped complete version). Do not silently clamp with a mid-sentence ellipsis.
get_assignment_details
ChatGPTOne booked shift, including office name, street address, entrance, and parking. Cancel stays in the WORKFORCE app — this tool explains the consequences and returns a link. It does not cancel.
get_booked_shift_cancel_link
ChatGPTGet a short-lived link to cancel one of the signed-in candidate’s own booked shifts in the WORKFORCE app. This tool does not cancel the shift and changes nothing; the candidate finishes the cancellation in the app. Late-cancellation rules apply there: cancelling removes Preferred status, lowers the reliability score, and reopens the shift to other candidates.
get_candidate_profile_schema
ChatGPTReturn the required fields for a complete WORKFORCE candidate profile, plus the full required + optional JurisdictionProfileRule checklist once profession and region are known (args or this token’s candidate). Present jurisdictionChecklist immediately — do not wait for missing gaps. Hygienist module:* options are the active Settings HYGIENIST_MODULE list (pick modules they are trained and comfortable doing). Other professions keep types of dentistry. Do not invent module options. Subject-scoped; no candidate search.
get_candidate_setup_pack
ChatGPTReturn the WORKFORCE candidate setup pack for this token subject, including status (percent, missing[]) and the scoped pack2 cell auto-scoped from the saved profile. If the profile is complete, do not restart signup. Otherwise ask only missing gaps in parallel. With no profession or region, this is pack1 only and does not include a jurisdiction × profession matrix. Pass profession and region to scope before they are saved. Do not call get_my_profile_status after every field. Subject-scoped; no candidate search.
get_job_details
ChatGPTDetails for one open shift this candidate can see. Same privacy as search: no office name or street address before you are assigned. Includes special requirements and, when Same Worker Required is on, every day.
get_my_application
ChatGPTOne application for this candidate. Office name and street stay hidden until the shift is assigned. No payment or banking fields.
get_my_availability_calendar
ChatGPTRead this candidate’s date windows and blocked dates between from and to (YYYY-MM-DD).
get_my_broadcast_status
ChatGPTRead this candidate’s current availability broadcast. Requires a complete and verified WORKFORCE profile. Does not list offices. suppressed true means the pin is saved but hidden from office maps, the recruiter ops map, and availability email blasts.
get_my_candidate_profile
ChatGPTRead this token’s WORKFORCE candidate profile only (subject Candidate.id). Never another candidate.
get_my_profile_status
ChatGPTFull checklist for this candidate’s profession + region only (not every jurisdiction): percent, missing required fields, verification, checklist.required and checklist.optional. When no Candidate row exists yet, returns 0 of N complete and the full required list — not a null status. Prefer the status summary on get_candidate_setup_pack, create_or_update_my_candidate_profile, and upload_my_candidate_document. Do not call this after every field or attachment. Tell the user percent, what is missing, and whether complete, verified, and ready. If complete, do not restart signup — offer the next unlocked steps. Collect only missing[] and checklist gaps. Present checklist.required and checklist.optional as soon as profession and region are set — optional certs and modules are included even when they do not block ready.
get_my_timesheet
ChatGPTOne timesheet for this candidate. Hours, break, status, and dispute reason. No payment instruments.
get_my_weekly_availability
ChatGPTRead this candidate’s recurring weekly availability. Requires a complete and verified WORKFORCE profile. Subject-scoped; no other candidates.
list_my_applications
ChatGPTList this candidate’s WORKFORCE applications. Office name and street stay hidden until the shift is assigned.
list_my_assignments
ChatGPTThis candidate’s booked shifts. Office name is included because the shift is already assigned.
list_my_timesheets
ChatGPTList this candidate’s timesheets. Hours and status only — no payment details, banking, or bill rate.
search_available_shifts
ChatGPTSearch open shifts for this candidate. Returns a general location and distance only — never the office name, street address, or exact coordinates. Temp is the default. Perm is included only when this profile is open to perm work.
set_my_availability_status
ChatGPTMark this candidate open or unavailable for temp shifts. Blocked when WORKFORCE has deactivated the profile. confirm false writes nothing.
set_my_commute
ChatGPTSet this candidate’s commute distance. Allowed during signup once the candidate row exists. Writes Candidate.commuteDistanceKm only — no email, text, push, or office outreach. Associate dentists can also pick serviceAreaMode: LOCAL (a commute distance from their town, up to 500 km), TRAVEL_LOCUM (on-site travel / locum work in the provinces or states they are licensed in; pass licensedRegions as codes like BC, AB or WA) or BOTH (commute area plus licensed provinces / states; pass licensedRegions and optionally commuteDistanceKm). Ask associates “Where do you want to work? Local, Travel / locum, or Both?”, then for travel: “Which provinces (or states in the US) are you licensed in and open to locum (travel) work?” Offices in those provinces / states see them. Distances are km in Canada and miles in the US.
set_my_date_availability
ChatGPTSet specific dates on or off for this candidate. Windows are a full day, the same as the WORKFORCE calendar. confirm false writes nothing.
set_my_weekly_availability
ChatGPTSet this candidate’s recurring weekly availability (CandidateWeeklyAvailability). dayOfWeek is 0=Sunday … 6=Saturday. Requires a complete and verified WORKFORCE profile. Do not call during signup: these rows make the candidate eligible for job-match email, text, and push. Collect availability intent only after verification.
stop_availability_broadcast
ChatGPTStop this candidate’s live availability broadcast. confirm false writes nothing. Does not notify offices when dry-broadcast mode is on.
upload_my_candidate_document
ChatGPTUpload one document to the signed-in candidate’s own WORKFORCE profile and attach it: profile photo, resume, dental licence, or course certificate. Pass the chat attachment as fileUrl or attachmentId (an https URL the server downloads), or the storagePath returned by create_my_candidate_upload_slot. It acts only on this candidate’s own profile and files; it never reads or changes anyone else’s. It adds the file and returns the updated profile status (percent complete and what is still missing) plus the stored file reference. It does not delete files or contact anyone. A resume upload may be summarised into a draft bio that the candidate reviews before anything is saved. Ask the candidate before uploading, and do not re-encode the file. ID verification is not done in this assistant; the candidate finishes it in the WORKFORCE app.
withdraw_my_application
ChatGPTWithdraw this candidate’s pending application. confirm false previews. An assigned shift is not cancelled here — the tool returns a link to finish that in the WORKFORCE app.