po_analytics_financial_overdue_get
ChatGPTUse this when the user asks which invoices are overdue. Lists documents whose extracted due date has passed, most overdue first, with amount and currency; totals per currency, never mixed. Payment status is not checked.
po_analytics_financial_summary_get
ChatGPTUse this when the user asks for totals or a summary of invoice amounts across documents, e.g. by currency. Sums extracted amounts of all documents (not only invoices) per currency, never mixing currencies.
po_currency_convert
ChatGPTUse this when the user asks to convert an amount to another currency. Uses the latest available rate (rate date returned); no historical rates.
po_dataripper_office2pdf
ChatGPTUse this when the user wants to convert a Word, Excel or PowerPoint file to PDF. Pass a public file_url, or omit it to get an upload page, then pass the upload_id shown there. po_job_get returns the PDF link.
po_documents_audit_trail_get
ChatGPTUse this when the user asks what changed in a document or workspace, or for an audit trail or change log. Only revision-secure documents log changes; returns the latest entries with action, field, old and new value.
po_documents_copy
ChatGPTUse this when the user wants to copy or duplicate a document into a workspace. Each call creates a new copy with its own pofid; a target workspace with automatic AI processing processes it, which costs credits.
po_documents_create_from_content
ChatGPTUse this when the user asks to create or write a PDF or document (notes, letter, report). Pass Markdown: PaperOffice renders and stores the PDF, returns its pofid. Costs credits. Own template: po_documents_creator_agents_list.
po_documents_creator_agent_preview
ChatGPTUse this when the user asks a Creator Agent to draft a document, e.g. a quote. Fills the agent's template from the request, its knowledge bases and contacts; stores nothing, costs credits. Returns values, questions, preview_token.
po_documents_creator_agent_run
ChatGPTUse this when the user approved a Creator Agent preview and wants the document. Pass preview_token, confirm=true and answers in variables. Stores the PDF in the workspace (costs credits); a repeat returns the same document.
po_documents_creator_agents_list
ChatGPTUse this when the user wants a quote, letter or certificate on their own template, or asks which Creator Agents exist. Lists active agents (agent_id, name, template); then use po_documents_creator_agent_preview.
po_documents_delete
ChatGPTUse this when the user wants to delete a document and all its versions (not a tag or folder entry). It goes to the recycle bin and can be restored; permanent deletion only in the PaperOffice app. Retention or legal hold blocks it.
po_documents_download
ChatGPTUse this when the user wants to download or save a document's file, e.g. the PDF. Returns a temporary link to the stored file, valid for about 10 minutes.
po_documents_folders_create
ChatGPTUse this when the user wants to bundle or staple related documents, e.g. an invoice and its delivery note, into one new document folder; the files stay separate. A document can be in only one folder.
po_documents_folders_list
ChatGPTUse this when the user asks for document folders, i.e. bundles of related documents, in a workspace. Lists folders only; po_documents_search lists documents.
po_documents_get
ChatGPTUse this when the user wants details of one document: type, sender, amounts, dates, summary, processing status. Stored data only; to extract invoice data use po_extraction_invoice.
po_documents_move
ChatGPTUse this when the user wants to move a document to another workspace. All its versions move along and keep their pofids. Documents under retention or legal hold cannot be moved.
po_documents_process
ChatGPTUse this when a stored document needs OCR and AI analysis, e.g. it has no text yet. Runs in the background, costs credits; track via po_documents_get. Re-processing replaces the old analysis.
po_documents_rename
ChatGPTUse this when the user wants to rename a document. Changes the name shown in PaperOffice and the file name; the extension (e.g. .pdf) is kept. If display_name_updated is false, the shown name stayed: tell the user the _warning.
po_documents_restore
ChatGPTUse this when the user wants to restore or undelete a document from the recycle bin. Puts it back with its versions into its original workspace (a fallback one if that was deleted) or target_workspace_id.
po_documents_search
ChatGPTUse this when the user wants to find or list documents by number, name, keyword, type or date. Returns pofid, sender, amount. Knowledge base: po_knowledge_search; sums by currency: po_analytics_financial_summary_get.
po_documents_tags_create
ChatGPTUse this when the user wants to tag or label a document. Adds one tag per call; a tag the document already has is rejected.
po_documents_tags_list
ChatGPTUse this when the user asks which tags or labels a document has. Returns tag names and colors.
po_documents_text_get
ChatGPTUse this when the user needs the full text or exact wording of a document. Returns its OCR text (only after processing); emails, phone and ID numbers are masked where detected.
po_documents_trash_list
ChatGPTUse this when the user asks what is in the recycle bin or trash, or looks for a deleted document. Returns deleted documents (newest first, 50 per page) with pofid and days left before permanent deletion.
po_documents_update_index
ChatGPTUse this when the user wants to set or correct document metadata (index fields), e.g. document_type, sender_name, invoice_number, due_date, total_amount or currency. Only the given fields are overwritten.
po_documents_upload
ChatGPTUse this when the user gives a public file URL to store, or wants a browser upload page (omit file_url). Stores a new document; workspace auto-processing may apply. Chat attachments: po_documents_upload_files.
po_documents_upload_files
ChatGPTUse this when the user wants to store files they attached in this chat. One result per file; retries never store twice; workspace auto-processing may apply. To create a PDF from text use po_documents_create_from_content. If ChatGPT cannot pass an attachment to this tool (for example BLOCKED_FILE_REFERENCE), call it with files: [] to receive upload_url.
po_documents_versions_list
ChatGPTUse this when the user asks for earlier versions or the version history of a document. Returns its versions with number, pofid, date, comment and which is current.
po_job_get
ChatGPTUse this when an extraction or PDF tool returned a job_id. Returns status and, once completed, the result. Poll until completed; stop if it failed.
po_knowledge_add_article
ChatGPTUse this when the user asks to add or write a new knowledge base article. Saves it and indexes it for search; in a public knowledge base it is published at once.
po_knowledge_categories
ChatGPTUse this when the user asks which categories their knowledge base articles are sorted into. Returns each category's ID, name and article count.
po_knowledge_create_base
ChatGPTUse this when the user asks to create a new knowledge base for help articles. By default it is internal (team only) with primary language en; visibility public puts its articles on the help center.
po_knowledge_delete_article
ChatGPTUse this when the user asks to delete a knowledge base article. Permanently removes it in all languages, also from search and the help center; cannot be undone.
po_knowledge_get_article
ChatGPTUse this when the user wants to read one knowledge base article in full, e.g. after a search hit. Returns its title, text and summary in each language.
po_knowledge_get_base
ChatGPTUse this when the user asks about one knowledge base's settings, visibility or languages. Returns its details with article and category counts.
po_knowledge_graph_ask
ChatGPTUse this when a question spans many documents, e.g. which contracts have a termination clause. Best effort; not for knowledge base articles (po_knowledge_search) or totals (po_analytics_financial_summary_get).
po_knowledge_list_articles
ChatGPTUse this when the user wants to browse or list the articles of a knowledge base instead of searching. Returns articles (50 per page) with IDs, titles, status and content.
po_knowledge_list_bases
ChatGPTUse this when the user asks which knowledge bases they have or a knowledge base ID is needed. Returns ID, name, visibility and languages of each active knowledge base.
po_knowledge_search
ChatGPTUse this when the user asks to search their knowledge base or help articles, or asks about their own policies, FAQs or how-tos. Returns matching articles with excerpts; for stored documents use po_documents_search.
po_knowledge_translate
ChatGPTUse this when the user asks to translate a knowledge base article. AI translates it and saves that language version, replacing an existing one; in a public knowledge base it goes live. Costs credits.
po_knowledge_update_article
ChatGPTUse this when the user asks to edit or rewrite a knowledge base article. Replaces the title and/or text of one language version and clears its summary and tags; public articles change at once.
po_knowledge_update_base
ChatGPTUse this when the user asks to rename a knowledge base, change its description or make it public or internal. Overwrites the given fields; public puts its published articles online, internal takes them offline.
po_pdfstudio_compress
ChatGPTUse this when the user wants to compress a PDF or reduce its file size. Starts a job; po_job_get returns the download link.
po_pdfstudio_merge
ChatGPTUse this when the user wants to merge or combine two or more PDF documents into one file. Starts a job; po_job_get returns the download link.
po_pdfstudio_split
ChatGPTUse this when the user wants to split a PDF into single pages or page ranges. Starts a job; po_job_get returns the download link(s).
po_tasks_claim_task
ChatGPTUse this when the user explicitly wants to claim an open task. Locks it to them for 15 minutes and may notify the assignee. Optional; if claimed, pass claim_session_id to po_tasks_complete_task or po_tasks_reject_task.
po_tasks_complete_task
ChatGPTUse this when the user approves a task or marks it done. For approvals pass result {"decision":"approve"}. Final, cannot be undone; reject with po_tasks_reject_task. hitl_review tasks are done in the app.
po_tasks_get_task_details
ChatGPTUse this when the user asks what a specific task or approval is about. Returns description, status, due date, history and whether completing needs an approve decision.
po_tasks_list_my_tasks
ChatGPTUse this when the user asks about their tasks or pending approvals. Lists tasks assigned to them, their role or group (default: open) with ID, status, priority and due date.
po_tasks_reject_task
ChatGPTUse this when the user rejects or declines a task or approval. Records the reason; a waiting workflow continues without the requested action. Final, cannot be undone. hitl_review tasks are done in the app.
po_vat_validate
ChatGPTUse this when the user wants to check if a company's EU VAT ID is valid. Checks EU VIES or a recent cached result (check date returned); returns validity and, if disclosed, company name and address.
po_workspaces_list
ChatGPTUse this when the user names a workspace or asks which workspaces exist, or a workspace_id is needed. Lists ID, name and document count. Locked workspaces are unlocked only in the PaperOffice app.