Frondy

Move a document into a folder (העברת מסמך לתיקייה). Omit `folder_id` to take it out of any folder. Find the document with list_documents and the folder with list_folders. Moving it where it already is changes nothing.

move_document_to_folder

Move a folder, with everything in it, inside another folder (העברת תיקייה). Omit `parent_id` to move it to the top level. Find both ids with list_folders. Moving a folder into itself or one of its own subfolders, or next to a folder with the same name, is refused.

move_folder

Mark where people sign and set up a whole form: add signature boxes, form questions and other fields (date, name, phone, email, text, yes/no, checkbox, stamp/חותמת) to a document before sending it (שדות חתימה, איפה לחתום, טופס, שאלון, הצהרת בריאות, כן או לא). Coordinates are fractions of the page (0 to 1) from its top-left corner. Look at the page with `get_document_page_image` first and place by eye. Most Frondy documents are Hebrew/RTL: signature lines usually sit near the BOTTOM on the RIGHT, often on a line labeled 'חתימה' or 'חתימת הלקוח'. Set `allow_seal_upload` on a signature field when the user mentions a stamp (חותמת). SETTING UP A FORM. Go through every page and choose by what each line asks: * A question the signer answers yes or no (כן או לא, usually ending in "?"): `yes_no`, with the question as `recipient_label`. The signer must choose, so set `required` true unless the form makes it optional. * A question with an explanation ("אם כן, פרט/י", "פירוט", "מועד"): a `yes_no` with a `link_key` in `field_options`, plus a `long_text` (or `text` for one short line) on the details line, with `depends_on` set to that key and `show_when` "yes" (or "no" when the form asks for details on no). It appears only after that answer, and is left empty and not required otherwise, so `required` true on it means required only when it appears. * A statement the signer only ticks ("אני מאשר/ת", "קראתי והבנתי"): `checkbox`, with the statement as `recipient_label`. Set `required` true when it must be accepted. Each checkbox for the same signer needs its own label, or sending is refused. * A free answer: `text` for one line, `long_text` for several. * A date to pick, such as a date of birth: `date` with `date_mode` "signer". Without it, a date prints the signing day. * A form still needs a `signature` field where it is signed. Any field can depend on a `yes_no`, for example a guardian's block shown only when "are you a minor?" is answered yes. Give each `link_key` a short id that is unique in the document, such as "q1". `yes_no_mark` "check" prints a check mark on yes in a printed square; the default prints the word. Set `field_order` in reading order so the signer is walked through the form from the top. To fill in the form's answers, use `fill_form_fields` after placing it, or set `default_value` here on a field with `assignee_type` "sender". Send all of a form's fields in one call, questions and their dependents together. A dependent whose `depends_on` matches no yes/no question is reported under `problems` and not added. Safe to retry: a field identical to one already on the document is reported under `already_present_field_ids` instead of being added twice. To fix a misplaced field, remove it with `remove_signature_fields` and add it again.

add_signature_fields

Step 1 of reminding people who haven't signed yet (תזכורת, להזכיר לחתום). Returns who would be reminded and how (email, plus SMS when the account sends reminder texts). Nothing is sent. Pass `recipient_email` to nudge just one signer. This is the answer to "chase whoever hasn't signed" — never send the document again for that. Show the user who will be reminded, and call send_reminder with `preview_id` only after they confirm in this conversation. A preview is valid for 15 minutes.

preview_reminder

Step 1 of sending a document for signature — by email, SMS, WhatsApp or a signing link (שליחה לחתימה, לשלוח לחתימה). Checks the request and returns a summary to show the user. Nothing is sent. recipients: each needs a way to be reached — an email for email, a phone for SMS or WhatsApp. Several recipients each get their own link and sign in parallel: there is no signing order. 2+ recipients needs a paid plan. send_email: email each recipient their link (default). send_sms: also text the link (uses the plan's SMS allowance and a verified sender). With send_email false this is an SMS-only send: a phone alone is enough, don't ask for an email. send_whatsapp: the USER pastes the link into WhatsApp; Frondy sends nothing. One recipient only. All channels false: nothing is delivered; the user gets the links to pass on. email_subject / email_body: optional plain text, with placeholders {{filename}}, {{signing_url}}, {{recipient_name}}, {{sender_name}}. Omit to use the account's default invitation. Show the user the summary — the document, who gets it and how, the message and any warnings — and call send_for_signature with `preview_id` only after they confirm in this conversation. A preview is valid for 15 minutes.

preview_signature_request

Step 2: send the reminder exactly as previewed. Call only after the user has seen who will be reminded (from preview_reminder) and confirmed. Each pending signer is emailed again with their existing link, without changing it or their progress. Limited to one reminder per document every 10 minutes. Calling this again with the same preview_id returns the first result without reminding twice (`already_sent` is true).

send_reminder

Remove fields from a document that hasn't been sent yet — to fix a misplaced box before sending (הסרת שדה). Field ids come from get_document. A field that is already gone is reported under `not_found_field_ids`.

remove_signature_fields

Save a document as a reusable template: a copy of its file with every field already placed (שמירה כתבנית, תבנית חדשה). The document itself is not changed or sent. Use it when the user wants to reuse the same layout; start new documents from it with create_document_from_template. Needs a plan that includes templates.

save_as_template

Step 2: send the document exactly as previewed, so each signer receives their invitation (שליחה לחתימה). Call only after the user has seen the summary from preview_signature_request and confirmed. It can't be undone: signers are notified straight away. To change a recipient, a channel or the message, preview again. Calling this again with the same preview_id returns the first result without sending twice (`already_sent` is true). For a WhatsApp or link-only send, `signing_links` holds the links for the user to pass on; no other send returns them. To chase signers later, use preview_reminder, never a new send.

send_for_signature

Create a new draft document from a saved template, fields already in place (מסמך מתבנית). Nothing is sent: preview and send it like any other document. Optionally give it a name and put it in a folder.

create_document_from_template

Finish uploading the attached document so it is ready to sign. Step 3: call after PUTting the bytes to the `upload_url` from `begin_file_upload`. Checks the stored PDF and the storage quota, and attaches it.

finalize_file_upload

Upload a PDF the user attached — a contract, form or any document to sign (העלאת מסמך / קובץ לחתימה). Step 1 of 3 for a file attached in THIS chat; the file goes straight to storage, not through your context. 1. `begin_file_upload(filename)` → `document_id` and `upload_url`. 2. PUT the file's ORIGINAL bytes to `upload_url`: a plain HTTPS PUT with no headers and no auth (the URL is presigned). Never compress, rasterize, downscale or otherwise change the file. 3. `finalize_file_upload(document_id)`. PDF only. Pass `size_bytes` if known for an early storage check. If the PUT fails with a network/egress error, that is the client's firewall: relay `on_upload_blocked` to the user so they allow `upload_host` once, then retry. Never alter the file to get around it.

begin_file_upload

View a page of a document — read the contract, see its layout, find where to sign (תצוגה מקדימה, לראות את המסמך). Renders one page to a PNG so you can see it, place fields by eye and check them. `page` is 0-based; keep `dpi` between 100 and 150. The result also gives the page count.

get_document_page_image