Refine Job Search

List jobs in your journey

Get details of a specific job

Add a new job to your journey

Update a job in your journey

Permanently delete a job and its application from the board. Confirm with the user first; it cannot be undone. To hide a job without recording a rejection or closure, use jobs.archive instead.

Queue a job posting to be re-scraped. The returned job may remain pending; use jobs.get later to inspect the refreshed state.

Mark a job as applied

Hide a job from the active board without recording a rejection or closing the application

Restore an archived job to the active board

Log an interview for a job

Update an existing interview

Permanently delete an interview from a job. Confirm with the user first; it cannot be undone.

Record a job offer with compensation details

Update the offer recorded for a job

Permanently delete the offer recorded for a job (the job stays). Use only to fix a mistake, and confirm with the user first; it cannot be undone.

Accept the offer for a job. This is a major state change that closes out the search for this role; confirm with the user before calling. It does not email the employer.

Decline the offer for a job, a major state change; confirm with the user first. It does not email the employer.

Log a negotiation event on an offer (counter-offer, update, etc.)

Remove a negotiation event from an offer

List companies you are tracking

Start tracking a company for new job openings

Update filters on a tracked company

Stop tracking a company and delete its signal. Confirm with the user first; they stop getting new openings from it. To stop notifications temporarily instead, use signals.pause.

Pause tracking for a company

Resume tracking for a company

Save a matched opening returned by signals.openings.list to your job journey

List jobs in your journey that came from a tracked company

List signal notifications (new openings at tracked companies)

Mark one opening notification returned by signals.openings.list as read

Mark every unread opening notification as read after the user confirms the bulk action

List email conversations Refine matched to your job search (applications, interviews, recruiter outreach)

Get one inbox item with its related job and application

Fetch the full email thread for an inbox item

Generate an AI reply draft for an inbox item. Returns HTML for review; it does not send anything.

Send an email reply through the user's Gmail. This emails a real person from the user's address. Only call after the user has seen the exact message body and explicitly approved sending it.

Apply an inbox item's suggested action, such as adding an application to the board or recording a rejection. Confirm the specific action with the user first.

Undo an auto-applied inbox action. This can delete a board record that the automatic action created, so confirm with the user first.

Clear an inbox item's unread-reply flag

Unsubscribe the user from this sender's mailing list via one-click list-unsubscribe. This changes the user's real email subscriptions; confirm with them before calling. Use it for unwanted bulk senders, not for a person you can simply decline.

Dismiss inbox items you are not acting on (also marks the mail read in Gmail)

Keep auto-applied inbox items as-is and finalize the automatic action. Confirm the specific items with the user first.

Queue decline replies to recruiter outreach. Depending on the user's preference this SENDS email from their address. Only call after the user explicitly approved declining these specific conversations.

Check Gmail for new mail now; returns per-account sync status

Per-account Gmail synchronization status, including current progress and last sync time

Get the user's persona: inferred job-search preferences and traits with an understanding score. Use it to tailor advice and searches.

List companies recommended from one company you track. Get signal_id from signals.list.

Get one recommended company with sources and persona fit

Start tracking a recommended company (converts it into a signal)

Dismiss a recommended company

Dismiss a recommended company and block it from future recommendations

Restore a dismissed or blocked recommendation

Record why a recommendation was or was not a fit; this sharpens future recommendations and the persona

Get upcoming interviews and action items

List connected Google accounts and their grant status. To connect a new account, use integrations.connect_google.

Get a link for the user to connect Gmail to Refine or approve a missing Gmail permission. Refine selects the permission needed for the connected account. The connection happens in the browser with no Refine sign-in required. Share the link only with the owner of this Refine account.