Tool reference

Identify the authenticated user, tenant, and granted scopes.

List forms in the tenant with status, slug, and last-modified date.

Fetch a single form by slug including pages, fields, logicRules, and buildContext (the form's AI Context documents).

Parameters: slug (string)

Create a new form with one or more pages and field definitions.

Parameters: name (string), pages[] (Page), logicRules[] (Rule)

Apply a granular field-level operation (add/update/rename/move/delete). rename_field cascades every reference to the old name; delete_field warns when references are orphaned. compact:true returns a summary instead of the full document.

Parameters: id (string), op (AddField | UpdateField | RenameField | MoveField | DeleteField), compact (boolean, optional)

Batch variant: apply a sequence of ops atomically in one request with a single revision bump and a compact response. All-or-nothing — the first failing op aborts with nothing written.

Parameters: slug (string), calls (op[]), compact (boolean, default true)

Read a form's translations for one locale with a coverage report: translated, untranslated (with source text), stale (source reworded since), and untranslatable (fields with no id). Call before set_form_translations.

Parameters: slug (string), locale (string, BCP-47)

Write an overlay of translations for one locale — title, page titles, labels, placeholders, option labels, signup notes, workflow status labels — keyed by field id, option value and status label. The source text is never changed; untranslated keys fall back to it. propose:true queues it for admin review.

Parameters: slug (string), locale (string), translations (Overlay), replace (boolean, optional), propose (boolean, optional)

Mark a form as published. Generates a public /share/<slug> URL.

Parameters: id (string)

Move a form to the archive. Reversible via the admin UI.

Parameters: id (string)

Clone a form along with its pages, fields, and settings.

Parameters: id (string), name (string, optional)

Append a new page to a form.

Parameters: id (string), title (string), position (number, optional)

Update a page's title, description, or logicRules.

Parameters: id (string), pageId (string), patch (object)

Remove a page from a form. Snapshotted before removal.

Parameters: id (string), pageId (string)

Reorder pages by supplying the new pageId sequence.

Parameters: id (string), pageIds (string[])

Update form-level settings (theming, submit message, redirect, …).

Parameters: id (string), patch (object)

Attach a workflow template to a form so submissions get routed.

Parameters: id (string), workflowTemplateId (string)

Submission counts, completion rate, and field-level analytics.

Parameters: id (string), since (ISO date, optional)

Enumerate every supported field type with its JSON Schema.

Enumerate the form design surface: animation scenes (renderSettings.animation) and the custom design-layer schema (renderSettings.designLayers).

List submissions for a form with optional status / date filters.

Parameters: formId (string), status (enum, optional)

Fetch a single submission with all field answers, comments, and reviewContext (the form's AI Context review guidance).

Parameters: id (string)

Write an advisory aiReview — never changes workflow status.

Parameters: id (string), suggestedAction (approve|reject|needs-info), concerns[], highlights[]

Apply soft-approval to many submissions. > 25 requires HMAC confirm.

Parameters: filter (object), recommendation (object), confirm (token, when bulk)

Remove an existing aiReview from a submission.

Parameters: id (string)

Move a submission to a new status. Always requires HMAC confirm.

Parameters: id (string), toStatus (enum), confirm (token)

List job applications, best match first: applicant, company, role, stage (the Resume Tracker status), how the job was sourced and verified, its match score, and whether a tailored resume exists.

Parameters: formSlug (string, optional), stage (Triage|Planning|Applied|Interviewing|Offer|Rejected|Withdrawn, optional), includeDrafts (boolean, optional), limit (number, optional)

Read the signed-in applicant's whole resume library: jobs with every bullet and its id, skill groups, education, and each version (by id and as text).

Parameters:

Write the applicant's whole library, replacing theirs (or creating it on the Resume Library form). Versions that pick ids missing from the library are refused.

Parameters: library ({ header, experience[], skills[], education[], versions[] }), formSlug (string, optional)

Create an application for a job you found, in Triage: the applicant sees its source, verification and match score, then approves it (Planning) or passes (Withdrawn). Same postingUrl twice returns the first.

Parameters: company (string), role (string), postingUrl, careersPageUrl, companyLinkedInUrl (string, optional), sourceType, verificationStatus (enum, optional), matchScore (0–100, optional), tags (string[], optional), description, companyNotes, angles (string, optional), stage (Triage|Planning|Applied, optional), formSlug, sourceVersionId, appliedOn (string, optional)

Read one application for tailoring: the job and pasted posting, its stage, the source version, the applicant's whole resume library, the current tailored copy, and the tailoring rules.

Parameters: submissionId (string)

Save a tailored resume on an application, frozen as sent (the library and job are never changed). Shown in the Tailored tab, printable to PDF.

Parameters: submissionId (string), tailored ({ header?, experience[], skills?, education?, notes })

List the tenant's AI Context documents — markdown guidance (review guides, form purposes, build guides, field glossaries) shown to reviewers and read by agents.

Parameters: formSlug (string | "tenant", optional), kind (review_guide | form_purpose | field_glossary | design_guide | general, optional)

Fetch one context document with its full body.

Parameters: id (string)

Create a context document — link it to a form via formSlug, or omit for tenant-wide guidance. Refuses same-kind same-scope near-duplicates unless allow_duplicate is set; fold additions into the existing doc instead.

Parameters: title (string), body (markdown), kind (enum, optional), formSlug (string, optional), allow_duplicate (boolean, optional)

Patch a context document's title, body, or kind. Bumps its revision.

Parameters: id (string), title / body / kind (optional)

Permanently delete a context document.

Parameters: id (string)

List workflow templates available in the tenant.

Fetch a workflow template with its steps and routing.

Parameters: id (string)

Create a new workflow template.

Parameters: name (string), steps[] (Step)

Patch an existing workflow template.

Parameters: id (string), patch (object)

List calendar templates (recurring availability blocks).

Fetch a calendar template by id.

Parameters: id (string)

Create a calendar template.

Parameters: name (string), schedule (object)

Patch a calendar template.

Parameters: id (string), patch (object)

List reusable Schedule Grid v2 templates.

Fetch a Schedule Grid v2 template by id (config + events).

Parameters: id (string)

Create a reusable Schedule Grid v2 template.

Parameters: name (string), config (object), events (array)

Patch a Schedule Grid v2 template.

Parameters: id (string), config (object), events (array)

Delete a Schedule Grid v2 template by id.

Parameters: id (string)

Upload an image to the media library (R2-backed).

Parameters: base64 (string), filename (string)

List items in the media library with thumbnails.

Delete a media item. Removes from R2 + DB.

Parameters: id (string)

List tenant variables (key/value pairs used in templates).

Fetch a variable by key.

Parameters: key (string)

Set or update a tenant variable.

Parameters: key (string), value (string)

Fetch tenant branding (logo, colors) and feature flags.

Update logo, primary color, or wordmark.

Parameters: patch (object)

Page through the tenant audit log filtered by date / actor / action.

Parameters: filter (object, optional)