add_application_note
ChatGPTAdd a note to an application’s Activity, e.g. who referred them or what you found about the company.
cancel_run
ChatGPTStop a Romy run this app started, queued or running. Credits not yet spent come back. A finished draft stays for review. A run that already ended is left as it ended, and the answer shows how.
check_cv
ChatGPTRolebranch’s free quality checks of a master CV or an application’s tailored CV: the score by category and what would raise it, each pointing at the entry to improve. Fix what it names with propose_cv_changes. Never a prediction of hiring chances.
create_application
ChatGPTAdd a job to Rolebranch as an application, as New application does. Preferred: pass the postingDraftId from read_job_posting (optionally company, role, facts, notes, status, sourceMasterCvId) so the posting is saved as read. Or pass company and role, or the posting text (jobDescription) Rolebranch reads later, with the link, notes, facts, status and master CV. Call list_applications first to avoid adding the same job twice. It never applies or contacts the employer.
end_practice_session
ChatGPTEnd a practice session; the person reviews it in Rolebranch.
fetch
ChatGPTOne record from search, as text: an application (facts, the posting as read, notes, next step) or a master CV without contact details.
get_agenda
ChatGPTThe person’s job search at a glance, for a briefing or a scheduled check-in: interviews, deadlines and follow-ups in a window (the coming week by default), Romy’s drafts and proposals waiting for their review, runs under way, applications applied to a while ago with nothing heard, and credits. Every item carries its url.
get_application
ChatGPTRead one application: facts, status, notes, the posting as Rolebranch read it, the next step, and whether a tailored CV and cover letter exist or wait for review. Request tailoredCvSections (needs cv:read) or includeCoverLetter for their content.
get_credits
ChatGPTHow many Romy credits the person has, and how many this app may still use this month before asking Romy to tailor a CV or write a letter.
get_cv_look
ChatGPTHow a master CV or an application’s tailored CV looks: template, accent colour, fonts, text size, line spacing, space between sections, margins and paper, and how many pages its PDF prints on, with the body lines past the first page, counted on the PDF. Free; changes nothing.
get_document_link
ChatGPTA link to the PDF of a master CV, an application’s tailored CV or its cover letter, working for 15 minutes for the person only; or, with format text, the content to paste into a form or an email (the CV as Markdown without contact details, or the letter). Free.
get_interview_prep
ChatGPTThe preparation for an application (or by prepId): status, the gaps, questions to ask, and each question with its requirement, category, the person’s outline (situation, action, result, next time), whether it still needs their input, and its revision for update_interview_outline.
get_master_cv
ChatGPTRead one master CV by whole sections (work, education, skills, projects, …). Contact details are never included. Ask for fewer sections if the answer reports omittedSections.
get_posting_draft
ChatGPTA posting read_job_posting started reading: whether it is ready, the posting as read, and the master CVs’ coverage of it. Free.
get_practice_session
ChatGPTA practice session: its questions, how many attempts each has and Romy’s latest rating.
get_run
ChatGPTHow a Romy run is doing: queued (waiting its turn; the message says for what), running, completed (with its draft to review, accepted or discarded), failed or cancelled.
get_search_stats
ChatGPTNumbers for the last 30 days or all time: the funnel by stage, applications sent per week, how many heard back, the response rate, median days to a reply, rejections and how many still wait.
import_master_cv
ChatGPTCreate a new master CV from the person’s CV: pasted text, or a PDF or DOCX passed as base64 (up to 3 MB). Rolebranch reads it the way Import does; free. Use it when list_master_cvs is empty or the person wants another master CV. It never changes an existing master CV or which one is the default (the first one becomes it). Retrying with the same requestKey, or the same content and name, returns the master CV already made.
list_applications
ChatGPTList the person’s job applications in Rolebranch, optionally by status (saved, applied, interviewing, offer, rejected) or a search over company and role. Check here before adding a job, to avoid duplicates. Follow nextCursor for more.
list_master_cvs
ChatGPTList the person’s master CVs (the ones tailored CVs start from): name, headline, where they are based, which is the default. Use get_master_cv for the content.
match_job
ChatGPTCompare a posting (a saved application’s, or a postingDraftId from read_job_posting) with one master CV, or all of them: a score, and each requirement and keyword with whether and where the CV covers it. Free; it saves nothing.
prepare_interview
ChatGPTAsk Romy to build the interview preparation for an application: likely questions with the requirement each one tests, an answer outline per question from the person’s CV, the gaps to prepare for, and questions to ask. Say the interview’s kind, who will be there and notes. Uses credits within this app’s monthly limit; follow the run with get_run, then read it with get_interview_prep. Reuse requestKey to retry safely.
propose_cv_changes
ChatGPTSave a batch of proposed edits for the person to review in Rolebranch: to an application’s tailored CV (with applicationId), or to a master CV (leave applicationId out; cvId from list_master_cvs), for example when they tell you about new work, a project or a skill. For its look or fitting it to a page count, use propose_cv_look or propose_cv_fit; cuts that shorten it are proposed here. Use facts the person gave you only. Needs the CV’s current revision, and an identical requestKey to retry. Nothing changes until the person accepts each edit; it cannot accept a proposal or edit a CV directly.
propose_cv_fit
ChatGPTPropose fitting a master CV or an application’s tailored CV to 1 or 2 pages by its look alone: less space between sections, tighter lines, margins down to 10 mm, then text down to 9 pt, counted on its PDF. Its words never change. fitted: the least change that fits was proposed. short: even the tightest look leaves body lines over the target; that look was proposed when it changes anything, and linesOver says how many lines cuts must save (propose those with propose_cv_changes). fits: it already fits; nothing was proposed. Free; nothing changes until the person accepts in Rolebranch (reviewUrl). Reuse requestKey to retry safely.
propose_cv_look
ChatGPTPropose a new look for a master CV or an application’s tailored CV: any of template, accent colour (#rrggbb), font, heading font, text size, line spacing, space between sections, margins and paper. Its words never change. Free. It waits for the person to accept or reject in Rolebranch (reviewUrl); nothing changes until then. A newer look from this app replaces the one it proposed earlier that still waits. The result lists the settings proposed and the pages before and after, counted on the PDF. Reuse requestKey to retry safely.
read_job_posting
ChatGPTRead a job posting from its link (url) or its text, the way New application does, and compare it with the person’s master CVs: a score per CV and each requirement with whether the CV covers it. Saves no application; use it first when someone shares a job. Free. Pages behind a login cannot be read: the answer says needs_text, then call again with the text. If the answer says reading, follow with get_posting_draft. To save it, call create_application with the postingDraftId.
save_next_step
ChatGPTAdd or change an application’s next step: an interview (exact time), an offer deadline or a follow-up (time or date). Pass stepId to change an existing one.
search
ChatGPTSearch the person’s applications (company, role, notes) and master CVs (name, headline). Returns ids, titles and links; use fetch for a record’s content.
set_application_status
ChatGPTMove an application to saved, applied, interviewing, offer or rejected, with when it happened (not in the future), a reason for a rejection, a note, or the offer. Shows in Activity. A note goes with a stage change only: for a note alone, use add_application_note. Only use it for what the person actually did; it never applies for them.
start_practice_session
ChatGPTStart a practice session on a preparation: Rolebranch picks the questions (or the questionIds given) and Romy gives feedback after each answer. Ask the questions one at a time and send each answer with submit_practice_answer.
submit_practice_answer
ChatGPTSend the person’s answer to one practice question. Romy’s feedback (rating, strengths, improvements, a suggested answer) comes back through get_run on the returned run. Uses credits within this app’s monthly limit.
tailor_cv
ChatGPTAsk Romy for a fresh tailoring: a new CV for an application, written again from its master CV (or masterCvId), as a draft. To change the tailored CV the person already has (its words, look or length), propose_cv_changes, propose_cv_look and propose_cv_fit propose changes to it in place instead. Put what you know in context: what to lead with, what to leave out, tone. Romy never invents facts. It uses the person’s credits within this app’s monthly limit; the draft waits for their review in Rolebranch. While Romy is busy with this CV, an earlier draft waits for review, or this app has as many runs going as it may, the run is queued and starts by itself. Follow it with get_run. Reuse requestKey to retry safely.
update_application
ChatGPTChange an application’s fields (company, role, link, posting text, notes, facts such as salary or location, the master CV it fits). Only the fields in changes are touched. Changing the posting text makes Rolebranch read it again.
update_interview_outline
ChatGPTSave the person’s own outline for one question (their story, in their words: situation, action, result, next time), with the question’s current revision. Mark it ready once it is complete. Never invent facts for them.
write_cover_letter
ChatGPTAsk Romy to write the cover letter for an application from its tailored CV, the posting and its notes. Put what you know in context: about the company, tone, length. Uses credits within this app’s monthly limit; the draft waits for review. While this app has as many runs going as it may, the run is queued and starts by itself. Follow it with get_run.
add_application_note
Claudecancel_run
Claudecheck_cv
Claudecreate_application
Claudeend_practice_session
Claudefetch
Claudeget_agenda
Claudeget_application
Claudeget_credits
Claudeget_cv_look
Claudeget_document_link
Claudeget_interview_prep
Claudeget_master_cv
Claudeget_posting_draft
Claudeget_practice_session
Claudeget_run
Claudeget_search_stats
Claudeimport_master_cv
Claudelist_applications
Claudelist_master_cvs
Claudematch_job
Claudeprepare_interview
Claudepropose_cv_changes
Claudepropose_cv_fit
Claudepropose_cv_look
Clauderead_job_posting
Claudesave_next_step
Claudesearch
Claudeset_application_status
Claudestart_practice_session
Claudesubmit_practice_answer
Claudetailor_cv
Claudeupdate_application
Claudeupdate_interview_outline
Claudewrite_cover_letter
Claude