get_gotham_write_status
ChatGPTUse this after a prepare_ tool to check that change: waiting for approval, declined, expired, running, succeeded (with the new item's ID) or failed. Pass the workspace_id the prepare tool returned. For a started workflow, workflow_run contains its current execution state and bounded result summary; result is the immutable creation receipt and its initial status does not describe current progress. This tool cannot approve anything.
get_matter
ChatGPTUse this when the user wants the details of one Gotham matter: its status, court, case number, dates and current revision. Read it before renaming a matter. Gotham enforces the matter's access rules and ethical walls.
get_playbook
ChatGPTUse this when the user wants the rules in a Gotham playbook, for example to review a contract against it. Returns its versions and rules with their sources. Draft rules are shown only if Gotham permits access.
get_tabular_review
ChatGPTUse this when the user wants the answers in a Gotham tabular review. Returns its columns and up to 10 document rows with their cell answers. Pass pagination.next_cursor for the next page.
get_workflow
ChatGPTUse this when the user wants to see what a Gotham workflow does, or before running one. Returns its versions and the published version's steps and input fields; use that version for prepare_run_workflow.
list_documents
ChatGPTFind the user's accessible Gotham documents by filename or text query. Use this to resolve named files before preparing a tabular review or document-based workflow. Returns filenames, internal document handles and content availability metadata, not file contents. Keep IDs internal and clarify duplicate filenames using safe display details. Follow next_cursor for more matches; a pending upload without a committed document version may not appear yet.
list_matters
ChatGPTUse this when the user asks about their matters, cases, deals or files in Gotham, or what is due next. Lists matters the connected user can see, with status, reference and due date; matter access rules and ethical walls apply. Optional query filters by text. Use get_matter for one matter's details.
list_playbooks
ChatGPTUse this when the user asks about their Gotham playbooks, such as contract review or negotiation playbooks. Lists playbooks the connected user can see, with status, rule count and whether every rule has a source.
list_tabular_reviews
ChatGPTUse this when the user asks about their Gotham tabular reviews (document review grids used for due diligence and contract review). Lists reviews the connected user can see with status and document counts, not cell contents; use get_tabular_review for answers.
list_workflows
ChatGPTUse this when the user asks which Gotham workflows (saved multi-step legal tasks) they have, or wants to run one. Lists workflows the connected user can see with their published version. A listed workflow is not necessarily runnable; Gotham checks permission again when a run is prepared.
list_workspaces
ChatGPTFind the user's accessible, ChatGPT-enabled Gotham workspaces by name. Use this when a user names a workspace, or their home workspace's connector is disabled. Returns names and internal workspace handles only. Keep IDs internal; clarify multiple matches by name and never silently select an unrelated workspace. Follow next_cursor to continue discovery.
prepare_create_matter
ChatGPTUse this when the user asks to open a new matter, case or deal in Gotham. Needs a title, kind (case, deal, mandate or internal) and jurisdiction code; court and case number are optional. Nothing changes until the user approves it on the Gotham page at the returned approval_url; show them the summary and the link, then use get_gotham_write_status.
prepare_create_playbook
ChatGPTUse this when the user asks to create a new playbook in Gotham. Creates an empty draft; it does not publish the playbook or add rules. Nothing changes until the user approves it on the Gotham page at the returned approval_url; show them the summary and the link, then use get_gotham_write_status.
prepare_create_tabular_review
ChatGPTUse this when the user asks to set up a tabular review, for example for due diligence across Gotham documents. Takes the documents and one question per column. Creating it does not start the analysis. Nothing changes until the user approves it on the Gotham page at the returned approval_url; show them the summary and the link, then use get_gotham_write_status.
prepare_run_workflow
ChatGPTUse this when the user asks to run one of their Gotham workflows. Starts the current published version (drafts cannot be run from ChatGPT). A run uses workspace credits and may keep running after approval. Nothing changes until the user approves it on the Gotham page at the returned approval_url; show them the summary and the link, then use get_gotham_write_status.
prepare_save_search
ChatGPTUse this when the user asks to save a legal research search to their Gotham workspace. Nothing changes until the user approves it on the Gotham page at the returned approval_url; show them the summary and the link, then use get_gotham_write_status.
prepare_update_matter_title
ChatGPTUse this when the user asks to rename a Gotham matter. Read its current revision with get_matter first; Gotham refuses the rename if the matter changed since. Nothing changes until the user approves it on the Gotham page at the returned approval_url; show them the summary and the link, then use get_gotham_write_status.
search_legal_sources
ChatGPTUse this when the user asks a legal research question or wants judgments, case law, statutes, bare acts, sections or citations. Searches Indian law by default (Supreme Court, High Court and tribunal judgments, central and state acts); set jurisdiction to "US" or "UK" for those sources. Returns snippets with court, year, jurisdiction and a Gotham link to the full text; cite those links. Results say when coverage is degraded or incomplete. Do not claim an authority is good law from search alone. Do not use for the user's own matters or documents; use the matter, workflow, playbook or tabular review tools.