v4_account_role_assignments_create
ChatGPTGive a team member an account role on a client account_role_id is a role from v4_account_roles_list, the person the actor_type and actor_id pair. Someone not yet on the client's team is put on it first; a role they already hold answers that row. Requires the account_role_assignments:modify scope.
v4_account_role_assignments_delete
ChatGPTTake an account role away from a team member - pass the role row id The id is the row's from v4_account_role_assignments_list. The person stays on the client's team with their other roles. Requires the account_role_assignments:modify scope.
v4_account_role_assignments_get
ChatGPTRead one account role assignment Requires the account_role_assignments:read scope.
v4_account_role_assignments_list
ChatGPTList account role assignments Requires the account_role_assignments:read scope.
v4_account_roles_get
ChatGPTRead one account role Requires the account_roles:read scope.
v4_account_roles_list
ChatGPTList the account roles of the firm Requires the account_roles:read scope.
v4_bills_get
ChatGPTShow a bill Requires the bills:read scope. How to call it: creator_type and creator_id are the person TaxDome shows as the invoice's Assignee (Team member); an invoice has no other assignee. v4_firm_members_list names them.
v4_bills_list
ChatGPTList bills Requires the bills:read scope. How to call it: Unpaid is filter[status][in] with posted, partially_paid, awaited and processing_deprecated. count=true on the first page gives meta.total_found; a sum of unpaid_amount needs every page. Overdue is filter[overdue]=true (true is the only value): the threshold is the firm's own setting, so never substitute a posted_at cut-off of your own. creator_type and creator_id are the person TaxDome shows as the invoice's Assignee (Team member); an invoice has no other assignee. v4_firm_members_list names them.
v4_bills_list_line_items
ChatGPTList a bill's line items Requires the bills:read scope.
v4_blobs_create
ChatGPTMint a presigned blob upload Requires the blobs:modify scope. How to call it: Only a caller that holds the file's bytes can finish an upload: checksum is the base64 MD5 of those exact bytes (no trailing newline) and byte_size their length, and the PUT to upload.url with upload.headers happens outside this API. signed_id is usable only after that PUT.
v4_blobs_get_upload_url
ChatGPTRe-sign the upload URL for a blob still awaiting its bytes Requires the blobs:modify scope.
v4_chat_threads_archive
ChatGPTArchive a chat thread Requires the chat_threads:modify scope.
v4_chat_threads_assign
ChatGPTAssign a chat thread to a firm member Requires the chat_threads:modify scope. How to call it: assignee_type and assignee_id name the firm member: Employee with an id from v4_employees_list (search by name), Owner with v4_owner_show's id, and v4_me_show's actor_type and actor_id for "assign to me". Ask the user only when the search finds nobody or several people, never guess an id.
v4_chat_threads_create
ChatGPTStart a chat thread with a client Requires the chat_threads:modify scope. How to call it: Look for an open thread first (v4_chat_threads_list filter[client_id], filter[archived]=false): answering in one is v4_chat_threads_send_message. A new thread's message is its first message and the client reads it in the portal like any other, so show the user the exact text before confirming.
v4_chat_threads_list
ChatGPTList chat threads Requires the chat_threads:read scope.
v4_chat_threads_send_message
ChatGPTPost a message into a chat thread Requires the chat_threads:destructive scope.
v4_chat_threads_unarchive
ChatGPTUnarchive a chat thread Requires the chat_threads:modify scope.
v4_chat_threads_unassign
ChatGPTClear the assignee of a chat thread Requires the chat_threads:modify scope.
v4_client_assignments_create
ChatGPTPut a team member on a client's team One person per call, as the actor_type and actor_id pair (v4_firm_members_list). They are subscribed to the client's notifications, as in TaxDome; someone already on the team answers their existing row. A role on the client is granted separately with v4_account_role_assignments_create. Requires the client_assignments:modify scope.
v4_client_assignments_delete
ChatGPTTake a team member off a client's team - pass the team row id The id is the row's from v4_client_assignments_list, never the person's actor_id. Every role the person holds on the client goes too, and adding them back does not restore the roles. Taking off the last member puts the firm's default team on the client first. Requires the client_assignments:destructive scope.
v4_client_assignments_get
ChatGPTRead one client assignment Requires the client_assignments:read scope.
v4_client_assignments_list
ChatGPTList client assignments Requires the client_assignments:read scope.
v4_client_custom_fields_create
ChatGPTCreate a client custom field Requires the client_custom_fields:modify scope.
v4_client_custom_fields_list
ChatGPTList client custom fields Requires the client_custom_fields:read scope.
v4_client_notes_create
ChatGPTCreate a note Requires the client_notes:modify scope.
v4_client_notes_delete
ChatGPTArchive a note Requires the client_notes:destructive scope. How to call it: Success comes back as {"ok":true,"status":204} and nothing else: the archived note is not returned. Read it first if the answer should say what was archived.
v4_client_notes_list
ChatGPTList client notes Requires the client_notes:read scope.
v4_client_notes_update
ChatGPTUpdate a note Requires the client_notes:modify scope.
v4_clients_assign_tag
ChatGPTAssign a tag to a client Requires the clients:modify scope. How to call it: Both ids must exist: the client from v4_clients_list search, the tag from v4_tags_list search. A tag that does not exist yet is created first with v4_tags_create, which needs a color value from v4_tags_colors.
v4_clients_create
ChatGPTCreate a client account (individual, company or other) account_name is required and unique in the firm, case-insensitively, so a repeat is refused; account_type is individual, company or other, and other when left out. tags are names of tags that already exist in the firm (v4_tags_create makes a new one) and tag_ids their ids. This creates the client record only: no contact, portal invite or message - the people behind the client are added with v4_contacts_create. Requires the clients:modify scope. How to call it: Search v4_clients_list for the name first: account_name is unique per firm, case-insensitively, and a repeat is refused. Send account_type (individual, company or other); left out, the client is created as other. tags by name must already exist - the whole create is refused with "Can't find tag with given name" otherwise, whatever the field says - so create a missing tag with v4_tags_create first; tag_ids are not checked. The people behind the client come next: v4_contacts_create with client_ids.
v4_clients_get
ChatGPTShow a client Requires the clients:read scope. How to call it: custom_fields holds one {id, value, actor_type, actor_id} per filled-in field: id is a field of v4_client_custom_fields_list (name, kind), value a string, actor_* the person of a user-kind field. Values only: fields=["id","custom_fields"]. Read-only.
v4_clients_list
ChatGPTList clients Requires the clients:read scope. How to call it: search: account_name, company_name, code. filter[tag_ids][in][] any tag, [all][] every one; the person responsible is filter[assignee_type] with filter[assignee_id], only together. Nothing filters clients by contact (v4_contact_links_list does). filter[current_sign_in_at] is the last portal sign-in: [null]=true never, [lt]=<date> not since. custom_fields holds one {id, value, actor_type, actor_id} per filled-in field: id is a field of v4_client_custom_fields_list (name, kind), value a string, actor_* the person of a user-kind field. Values only: fields=["id","custom_fields"]. Read-only.
v4_clients_unassign_tag
ChatGPTRemove a tag from a client Requires the clients:modify scope.
v4_clients_update
ChatGPTUpdate a client Requires the clients:modify scope. How to call it: tags and tag_ids here REPLACE the client's whole tag set, and an empty list clears it. To add or take off one tag, use v4_clients_assign_tag or v4_clients_unassign_tag instead. Send only the fields to change.
v4_contact_custom_fields_create
ChatGPTCreate a contact custom field Requires the contact_custom_fields:modify scope.
v4_contact_custom_fields_list
ChatGPTList contact custom fields Requires the contact_custom_fields:read scope.
v4_contact_links_create
ChatGPTLink a contact to a client Requires the contact_links:modify scope.
v4_contact_links_delete
ChatGPTRemove one link between a contact and a client Requires the contact_links:destructive scope.
v4_contact_links_list
ChatGPTList contact links Requires the contact_links:read scope.
v4_contacts_create
ChatGPTCreate a contact Requires the contacts:modify scope. How to call it: A contact belongs to a client through client_ids; company_name is card text and links nothing. Find the client with v4_clients_list search; a company or household that is not a client yet is made with v4_clients_create first and its id passed in client_ids - offer that if you must ask, never company_name as the link. Later: v4_contact_links_create adds an account, v4_contact_links_delete removes one. phone_number is stored digits only: report the value the response returns, not the one you sent.
v4_contacts_get
ChatGPTShow a contact Requires the contacts:read scope. How to call it: custom_fields holds one {id, value, actor_type, actor_id} per filled-in field: id is a field of v4_contact_custom_fields_list (name, kind), value a string, actor_* the person of a user-kind field. Values only: fields=["id","custom_fields"]. Read-only.
v4_contacts_list
ChatGPTList contacts Requires the contacts:read scope. How to call it: filter[client_id][eq] lists the contacts linked to one client; the record itself carries no links - a link's role and the accounts of one contact are on v4_contact_links_list (filter[contact_id][eq]). search finds a person, not their accounts. custom_fields holds one {id, value, actor_type, actor_id} per filled-in field: id is a field of v4_contact_custom_fields_list (name, kind), value a string, actor_* the person of a user-kind field. Values only: fields=["id","custom_fields"]. Read-only.
v4_contacts_update
ChatGPTUpdate a contact Requires the contacts:modify scope. How to call it: client_ids REPLACES every client the contact is linked to. To add or remove one account use v4_contact_links_create or v4_contact_links_delete instead; the current links are v4_contact_links_list filter[contact_id][eq]. Send client_ids only with the complete list. Send only the fields to change. phone_number is stored digits only: report the value the response returns, not the one you sent.
v4_directories_create
ChatGPTCreate a client folder Requires the directories:modify scope. How to call it: parent_id is the folder to nest under. A top-level folder goes under the client's tree root, the first id of any folder's path in v4_directories_list filter[client_id]; that root is never listed itself. Names are unique among siblings.
v4_directories_list
ChatGPTList client folders Requires the directories:read scope.
v4_directories_move
ChatGPTMove a folder into another folder Requires the directories:modify scope.
v4_directories_update
ChatGPTUpdate a client folder Requires the directories:destructive scope. How to call it: Sharing a folder with the client is client_access_right read or read_write on the client's top-level folder (a path of two ids), and it shares everything inside. An inner folder cannot be shared on its own: say so, and offer its top-level folder or a move under a shared one with v4_directories_move.
v4_document_checklist_items_list
ChatGPTList document checklist items Requires the document_checklist_items:read scope.
v4_document_checklists_get
ChatGPTShow a document checklist Requires the document_checklists:read scope.
v4_document_checklists_list
ChatGPTList document checklists Requires the document_checklists:read scope.
v4_documents_create
ChatGPTUpload a document Requires the documents:destructive scope. How to call it: Three steps: v4_blobs_create, PUT the bytes to upload.url with upload.headers, then this call with the blob's signed_id as blob_signed_id. directory_id is a folder from v4_directories_list filter[client_id], never the tree root (the first id of a path). The client sees the file, and any email about it, only if the folder's top-level folder gives them access (client_access_right read or read_write).
v4_documents_delete
ChatGPTMove a document to the trash Requires the documents:destructive scope.
v4_documents_delete_forever
ChatGPTPermanently delete a trashed document Requires the documents:destructive scope.
v4_documents_get
ChatGPTShow a document Requires the documents:read scope.
v4_documents_get_signature_request
ChatGPTShow a document signature request Requires the documents:read scope.
v4_documents_list
ChatGPTList documents Requires the documents:read scope. How to call it: filter[signature_states] takes in only (the labels overlap; eq is a 400): filter[signature_states][in][]= pending, partially_signed, signed, opted_out, kba_failed, kba_pending, created or voided. pending includes a partly signed request.
v4_documents_move
ChatGPTMove a document into a folder Requires the documents:modify scope.
v4_documents_notify_client
ChatGPTNotify the client about a document Requires the documents:destructive scope.
v4_documents_restore
ChatGPTRestore a trashed document Requires the documents:modify scope.
v4_documents_update
ChatGPTUpdate a document Requires the documents:destructive scope. How to call it: To ask the client to approve a document already uploaded, set need_approval true; to tell them about it with no approval, v4_documents_notify_client instead. Send only the fields to change.
v4_email_templates_get
ChatGPTRead one email template Requires the email_templates:read scope. How to call it: from_type and from_id are the sender as a firm-member pair (Owner or Employee), not a user id. To send as that sender, v4_mailbox_messages_create's from_user_id takes their user_id: v4_firm_members_list with type=from_type and ids=from_id.
v4_email_templates_list
ChatGPTList email templates Requires the email_templates:read scope.
v4_employees_get
ChatGPTRead one employee Requires the employees:read scope.
v4_employees_list
ChatGPTList the employee roster Requires the employees:read scope. How to call it: Any member of the firm may read the roster: search by name or email turns a colleague into an id. An employee's id is the actor_id (or assignee_id) to pair with Employee. filter[client_id] narrows it to the active employees who can see that client. The Owner is not on this roster: v4_owner_show, which every member may read.
v4_firm_members_list
ChatGPTResolve firm members Requires the firm_members:read scope. How to call it: Resolves a person pair you already hold into a name: type (Owner or Employee - the record's assignee_type, creator_type, actor_type) with ids of that type, one type per call; either half alone is a 400. A bare user id goes in user_ids instead. It does not browse or search: for a name, use v4_employees_list.
v4_job_assignments_create
ChatGPTAssign a team member to a job One person per call, as the actor_type and actor_id pair. The job's other assignees stay; someone already on the job answers their existing row. Requires the job_assignments:modify scope. How to call it: actor_type and actor_id name the firm member: Employee with an id from v4_employees_list (search by name), Owner with v4_owner_show's id, and v4_me_show's actor_type and actor_id for "me", never its user_id. One person per call; the other assignees stay, and someone already assigned answers their existing row.
v4_job_assignments_delete
ChatGPTRemove one assignee from a job - pass the assignment row id The id is the row's from v4_job_assignments_list, never the person's actor_id. The job and its other assignees stay. Requires the job_assignments:modify scope. How to call it: The id is the assignment ROW's id, from the matching list (v4_job_assignments_list, v4_task_assignments_list or v4_job_recurrence_assignments_list) filtered by the record and the person's pair - never the person's actor_id. Only that one person is removed.
v4_job_assignments_list
ChatGPTList job assignments Requires the job_assignments:read scope. How to call it: Who is on a job: filter[job_id] (filter[job_id][in] for a page of jobs), then resolve the actors with v4_firm_members_list: type (the row's actor_type) and ids, one type per call. What a person works on: filter[actor_type] and filter[actor_id] together - an id alone is a 400. Assigning is v4_job_assignments_create; unassigning is v4_job_assignments_delete with the id of the row read here.
v4_job_client_statuses_create
ChatGPTCreate a client status Requires the job_client_statuses:modify scope.
v4_job_client_statuses_delete
ChatGPTDelete a client status, with what uses it A status in use changes nothing on the first call and answers 422 need_confirmation with how many automations, jobs and templates it touches. Tell the user those counts; only they decide. Then repeat with job_client_status.confirmations.cascade = true. A status nothing uses goes at once. Requires the job_client_statuses:destructive scope.
v4_job_client_statuses_list
ChatGPTList client statuses Requires the job_client_statuses:read scope.
v4_job_client_statuses_update
ChatGPTUpdate a client status Requires the job_client_statuses:modify scope.
v4_job_recurrence_assignments_create
ChatGPTAssign a team member to the future jobs of a recurring job rule One person per call, as the actor_type and actor_id pair. Only jobs the rule creates from now on are affected; someone already on the rule answers their existing row. Requires the job_recurrence_assignments:modify scope. How to call it: actor_type and actor_id name the firm member: Employee with an id from v4_employees_list (search by name), Owner with v4_owner_show's id, and v4_me_show's actor_type and actor_id for "me", never its user_id. One person per call; the other assignees stay, and someone already assigned answers their existing row. Only the jobs the rule launches from now on are affected.
v4_job_recurrence_assignments_delete
ChatGPTRemove one assignee from a recurring job rule - pass the assignment row id The id is the row's from v4_job_recurrence_assignments_list, never the person's actor_id. Jobs the rule already created keep their assignees. Requires the job_recurrence_assignments:modify scope. How to call it: The id is the assignment ROW's id, from the matching list (v4_job_assignments_list, v4_task_assignments_list or v4_job_recurrence_assignments_list) filtered by the record and the person's pair - never the person's actor_id. Only that one person is removed.
v4_job_recurrence_assignments_list
ChatGPTList who the jobs of a recurring job rule go to Filter by job_recurrence_id or by the actor_type and actor_id pair together. The jobs a rule already created have their own assignees, in v4_job_assignments_list. Requires the job_recurrence_assignments:read scope. How to call it: Who the jobs of a recurring job rule go to: filter[job_recurrence_id] (rules from v4_job_recurrences_list). These are the rule's people, not those of the jobs it already launched (v4_job_assignments_list). The row's id is what v4_job_recurrence_assignments_delete takes.
v4_job_recurrences_create
ChatGPTSchedule recurring jobs for a client in a pipeline client_id and pipeline_id are fixed for the rule's life; job_template_id (v4_job_templates_list) is what each job starts as, and schedule_params with start_date say when. next_launch_at in the answer is the first launch. Assign people with v4_job_recurrence_assignments_create. Requires the job_recurrences:modify scope.
v4_job_recurrences_delete
ChatGPTStop a recurring job rule for good A hard delete: the rule and its assignees go, and no job is created from it again, a due launch included. Jobs it already created stay. Requires the job_recurrences:destructive scope.
v4_job_recurrences_list
ChatGPTList job recurrence rules Requires the job_recurrences:read scope.
v4_job_recurrences_update
ChatGPTChange a recurring job rule's template, schedule or dates What is left out stays; schedule_params replaces the schedule as a whole. The client and the pipeline cannot change - delete the rule and create another. Jobs already created are not touched. Requires the job_recurrences:modify scope.
v4_job_statuses_list
ChatGPTList job statuses Requires the job_statuses:read scope.
v4_job_templates_get
ChatGPTRead one job template Requires the job_templates:read scope.
v4_job_templates_list
ChatGPTList the firm's job templates - the job_template_id for jobs and recurring rules search matches the template name. A list entry has no description; v4_job_templates_get has it. Requires the job_templates:read scope.
v4_jobs_create
ChatGPTCreate a job for a client in a pipeline client_id and pipeline_id are required; pipeline_stage_id is a stage of that pipeline, its first when left out. The call creates the job and nothing else: the stage's automations - workflow rules the firm set up on that stage in TaxDome - are skipped unless the request lists them by id under automations with perform: true, which only the user decides. Requires the jobs:modify scope. How to call it: client_id (v4_clients_list) and pipeline_id (v4_pipelines_list) are required; pipeline_stage_id is a stage of THAT pipeline from v4_pipeline_stages_list filter[pipeline_id], the first stage when left out. With job_template_id only name and time_budget may be sent beside it. Leave automations out: the call then creates the job and nothing else. List an automation there only when the user named that automation and asked for it to run.
v4_jobs_create_link
ChatGPTLink an entity to a job Requires the jobs:modify scope. How to call it: trigger_kind automoved (the default) makes the record a requirement of the job; the job moves to the next stage by itself only when its stage has automove_jobs true (v4_pipeline_stages_list), its status is active or completed, and v4_jobs_list_unfinished_requirements is empty. With automove_jobs false a link moves nothing. autoactivated returns an on-hold job to active once its autoactivated links are complete.
v4_jobs_delete
ChatGPTDelete an archived job for good Only a job whose status is of the archived kind: archive it first with v4_jobs_update_status. Its comments, assignees and links go; its tasks stay, detached from the job, and so do the linked records. Requires the jobs:destructive scope.
v4_jobs_get
ChatGPTShow a job Requires the jobs:read scope.
v4_jobs_list
ChatGPTList jobs Requires the jobs:read scope. How to call it: There is no filter by name: find the client with v4_clients_list, then filter[client_id] and read name, pipeline_stage_id and due_date off each job. Someone's jobs are filter[assignee_type] with filter[assignee_id] (both halves); open ones filter[completed_at][null]=true; overdue filter[due_date][lt] today. Who is on a job is v4_job_assignments_list. count=true on the first page answers "how many".
v4_jobs_list_links
ChatGPTList entity links of a job Requires the jobs:read scope.
v4_jobs_list_unfinished_requirements
ChatGPTRead what still blocks a job Requires the jobs:read scope.
v4_jobs_move
ChatGPTMove a job to another stage of its pipeline stage_id is a stage of the job's own pipeline. When the new stage has automations - workflow rules the firm set up on that stage in TaxDome - or the job has unfinished requirements, the call moves nothing and answers 422 need_confirmation listing them. The job moves only when the same request is repeated with the listed items under confirmations, which only the user decides. Requires the jobs:modify scope. How to call it: stage_id is a stage from v4_pipeline_stages_list. A job does not carry its pipeline: look up its pipeline_stage_id (v4_pipeline_stages_list ids=) for pipeline_id, then list that pipeline's stages with filter[pipeline_id] and match the title the user said; a word that is no stage may be a status (v4_jobs_update_status). A 422 need_confirmation means the job did not move; it lists the stage's automations and the unfinished requirements. Show them to the user and repeat with move.confirmations only for the items they approve, never on your own.
v4_jobs_unlink
ChatGPTUnlink one record from a job - pass the row id and its entity_type The id and entity_type are the row's from v4_jobs_list_links, sent as link.entity_type: an id is unique only within its type. The record itself stays. Requires the jobs:modify scope.
v4_jobs_update
ChatGPTEdit a job's name, description, priority, dates or time budget Status is v4_jobs_update_status, the stage v4_jobs_move, people v4_job_assignments_create and v4_job_assignments_delete: any of them in this body is a 400. Requires the jobs:modify scope. How to call it: Send only the fields to change. Status is v4_jobs_update_status, the stage v4_jobs_move, people v4_job_assignments_create and v4_job_assignments_delete; any of them in this body is a 400. time_budget is minutes and needs the edit_time_budget right.
v4_jobs_update_status
ChatGPTChange a job's status (active, on hold, completed or archived) pipeline_job_status_id is a status of the job's own pipeline. When the change would run the stage's automations - workflow rules the firm set up on that stage in TaxDome - or leave requirements unfinished, the call changes nothing and answers 422 need_confirmation listing them. The status changes only when the same request is repeated with the listed items under confirmations, which only the user decides. Requires the jobs:modify scope. How to call it: pipeline_job_status_id must be a status of the job's own pipeline: get the pipeline through the job's stage (v4_pipeline_stages_list ids=pipeline_stage_id), then v4_job_statuses_list filter[pipeline_id]. Match on kind (active, on_hold, completed, archived), not on name - system names come back in the platform's language; a pipeline may have no completed status at all. A 422 need_confirmation means the status did not change; it lists the unfinished requirements and the automations. Show them to the user and repeat with status.confirmations only for the items they approve, never on your own.
v4_mailbox_messages_create
ChatGPTSend an email to a client Requires the mailbox_messages:destructive scope. How to call it: client_id is required (v4_clients_list). Without contact_id and emails the mail goes to the client's notification addresses. To write to one person send both: contact_id (a contact of that client) and emails - emails decide where it goes and are not checked against the contact. from_user_id is a USER id (v4_firm_members_list), the caller by default. Attachments are file_blob_ids from v4_blobs_create after the PUT; a document already in TaxDome cannot be attached.
v4_mailbox_threads_assign
ChatGPTAssign a mailbox thread to a firm member Requires the mailbox_threads:modify scope. How to call it: assignee_type and assignee_id name the firm member: Employee with an id from v4_employees_list (search by name), Owner with v4_owner_show's id, and v4_me_show's actor_type and actor_id for "assign to me". Ask the user only when the search finds nobody or several people, never guess an id.
v4_mailbox_threads_get
ChatGPTShow a mailbox thread Requires the mailbox_threads:read scope. How to call it: A thread is a preview: subject and snippet (the provider's short preview of the latest message). No message body is served; never present the snippet as what the email said.
v4_mailbox_threads_list
ChatGPTList mailbox threads Requires the mailbox_threads:read scope. How to call it: user_id is the mailbox OWNER (a USER id: v4_firm_members_list user_ids= names them); assignee_type and assignee_id are the colleague the thread is assigned to, who need not own the mailbox. Nothing filters by owner: for one person's mailbox page with fields=user_id and keep their rows, and say you narrowed it. A thread is a preview: subject and snippet (the provider's short preview of the latest message). No message body is served; never present the snippet as what the email said.
v4_mailbox_threads_unassign
ChatGPTClear the assignee of a mailbox thread Requires the mailbox_threads:modify scope.
v4_me_show
ChatGPTWho is calling Requires the me:read scope. How to call it: For "me" as an assignee or a filter, ask for fields actor_id and actor_type: that pair is the caller as a firm member (Owner or Employee). user_id is the login account's id and is never an actor_id; a pair built from it names nobody.
v4_message_templates_get
ChatGPTRead one chat message template Requires the message_templates:read scope.
v4_message_templates_list
ChatGPTList chat message templates Requires the message_templates:read scope.
v4_organizers_get
ChatGPTShow an organizer Requires the organizers:read scope.
v4_organizers_list
ChatGPTList organizers Requires the organizers:read scope.
v4_organizers_review_answer
ChatGPTMark one organizer answer reviewed answer.question_id from v4_organizers_get, with answer.section_copy_uuid inside a repeatable section. The organizer must be submitted. Returns the flag and the progress, not the organizer. Requires the organizers:modify scope.
v4_organizers_unreview_answer
ChatGPTTake back the review of one organizer answer Named like v4_organizers_review_answer. Returns the flag and the progress, not the organizer. Requires the organizers:modify scope.
v4_owner_show
ChatGPTRead the firm owner Requires the owner:read scope. How to call it: The firm owner as a firm member: id is the id records carry with type Owner (assignee_type=Owner, actor_type=Owner). Takes no arguments but fields. Every member may read it, unlike v4_employees_list, which does not list the Owner.
v4_payments_get
ChatGPTShow a payment Requires the payments:read scope.
v4_payments_list
ChatGPTList payments Requires the payments:read scope.
v4_pipeline_stages_list
ChatGPTList pipeline stages Requires the pipeline_stages:read scope. How to call it: Stages come back newest first, not in board order, and order is not sortable: list a pipeline's stages with filter[pipeline_id] and sort them by order yourself before showing them. ids= the job's pipeline_stage_id gives its pipeline_id.
v4_pipelines_clone
ChatGPTClone a pipeline Requires the pipelines:modify scope. How to call it: Nothing here edits or deletes a pipeline or its stages afterwards; a wrong title or stage list is fixed by hand in TaxDome. Read the title and every stage back to the user before confirming.
v4_pipelines_create
ChatGPTCreate a pipeline Requires the pipelines:modify scope. How to call it: Nothing here edits or deletes a pipeline or its stages afterwards; a wrong title or stage list is fixed by hand in TaxDome. Read the title and every stage back to the user before confirming.
v4_pipelines_get
ChatGPTShow a pipeline Requires the pipelines:read scope.
v4_pipelines_list
ChatGPTList pipelines Requires the pipelines:read scope.
v4_proposals_get
ChatGPTRead one proposal Requires the proposals:read scope.
v4_proposals_list
ChatGPTList proposals Requires the proposals:read scope.
v4_proposals_list_line_items
ChatGPTList the services, quantities and prices a proposal sells Returned by id, not in display order: sort by order. package_id says which package a packaged line belongs to; a discount line has a negative rate. Requires the proposals:read scope. How to call it: The proposal id comes from v4_proposals_list (filter[client_id]). Lines come back by id, not in display order: sort by order. package_id groups a packaged proposal's lines (v4_proposals_list_packages says which package was selected); a discount line has a negative rate, and amounts are pre-tax and do not sum to the package total.
v4_proposals_list_packages
ChatGPTList a proposal's packages Requires the proposals:read scope.
v4_sms_templates_get
ChatGPTRead one SMS template Requires the sms_templates:read scope.
v4_sms_templates_list
ChatGPTList SMS templates Requires the sms_templates:read scope.
v4_sms_threads_list
ChatGPTList the firm's SMS conversations with clients One thread per phone number (value), with the account_ids and contact_ids it belongs to, its assignee, unread count and the time of the last message. It returns the threads, not the text of their messages. Filters are assignee and created or updated time; there is no filter by client. Requires the sms_threads:read scope. How to call it: There is no filter by client and nothing here starts a new SMS thread. A thread carries account_ids and contact_ids: page with fields=value,account_ids,contact_ids and keep the ones that hold the client's id.
v4_sms_threads_resend_message
ChatGPTResend a failed SMS Requires the sms_threads:destructive scope.
v4_sms_threads_send_message
ChatGPTSend an SMS Requires the sms_threads:destructive scope.
v4_tags_colors
ChatGPTThe tag colour palette. Every value tag.color accepts, with the name and hex each one renders as. value is what the API takes; name, family and hex are for choosing — filter by family to answer "make it green". Answered by the gateway: the origin validates against these values and publishes no name or swatch for them.
v4_tags_create
ChatGPTCreate a tag Requires the tags:modify scope. How to call it: Search v4_tags_list for the name first: there is no merge and no delete, and a name is unique only per color, so the same name in another color is a second tag. color is required whatever the schema says, and it is a value from v4_tags_colors, never a hex code.
v4_tags_delete
ChatGPTDelete a tag from the firm for good The first call changes nothing and answers 422 need_confirmation with how many pipelines, accounts and contacts it touches. Tell the user those counts; only they decide. Then repeat with tag.confirmations.cascade = true. Requires the tags:destructive scope.
v4_tags_get
ChatGPTShow a tag Requires the tags:read scope.
v4_tags_list
ChatGPTList tags Requires the tags:read scope.
v4_tags_update
ChatGPTUpdate a tag Requires the tags:modify scope.
v4_task_assignments_create
ChatGPTAssign a team member to a task (they are notified) One person per call, as the actor_type and actor_id pair. The task's other assignees stay; someone already on the task answers their existing row. The person gets the task-assigned notification. Requires the task_assignments:modify scope. How to call it: actor_type and actor_id name the firm member: Employee with an id from v4_employees_list (search by name), Owner with v4_owner_show's id, and v4_me_show's actor_type and actor_id for "me", never its user_id. One person per call; the other assignees stay, and someone already assigned answers their existing row. On a series' template task (v4_tasks_get is_template) it reaches every task the series creates from now on; on an earlier task, that task alone. Say which.
v4_task_assignments_delete
ChatGPTRemove one assignee from a task - pass the assignment row id The id is the row's from v4_task_assignments_list, never the person's actor_id. The task and its other assignees stay. Requires the task_assignments:modify scope. How to call it: The id is the assignment ROW's id, from the matching list (v4_job_assignments_list, v4_task_assignments_list or v4_job_recurrence_assignments_list) filtered by the record and the person's pair - never the person's actor_id. Only that one person is removed. On a series' template task (v4_tasks_get is_template) it reaches every task the series creates from now on; on an earlier task, that task alone. Say which.
v4_task_assignments_list
ChatGPTList who is assigned to which task Filter by task_id (in for a page of tasks) or by the actor_type and actor_id pair together. Requires the task_assignments:read scope. How to call it: Who is on a task: filter[task_id] (filter[task_id][in] for a page of tasks), then names through v4_firm_members_list type and ids (one type per call). What a person is on: filter[actor_type] and filter[actor_id] together. The row's id is what v4_task_assignments_delete takes.
v4_tasks_add_checklist_item
ChatGPTAdd an item to the end of a task's checklist The other items stay as they are. A text already on the checklist is a 422: tick that item with v4_tasks_update_checklist_item instead. Requires the tasks:modify scope.
v4_tasks_assign_tag
ChatGPTAssign a tag to a task (its other tags stay) One tag per call, by its id from v4_tags_list; a tag already on the task changes nothing. An id that names no tag is a 404 and nothing is written. Requires the tasks:modify scope. How to call it: Both ids must exist: the task from v4_tasks_list, the tag from v4_tags_list search. A tag that does not exist yet is created first with v4_tags_create.
v4_tasks_create
ChatGPTCreate a task Requires the tasks:modify scope. How to call it: status is required (no_status when the user named none). client_id comes from v4_clients_list, pipeline_stage_client_id is a job id from v4_jobs_list. assignees are {actor_type, actor_id} pairs: Employee with an id from v4_employees_list, Owner with the Owner's id, and v4_me_show for the caller (later: v4_task_assignments_create). due_date and start_date are YYYY-MM-DD in the firm's timezone. A client, job or person the user named but you could not find is a question for the user, not a guess.
v4_tasks_create_note
ChatGPTCreate a task note Requires the tasks:modify scope.
v4_tasks_delete
ChatGPTDelete a task Requires the tasks:destructive scope.
v4_tasks_delete_note
ChatGPTDelete a task note Requires the tasks:destructive scope.
v4_tasks_get
ChatGPTRead a task Requires the tasks:read scope.
v4_tasks_list
ChatGPTList tasks Requires the tasks:read scope. How to call it: "My" tasks are filter[assignee_type] and filter[assignee_id] with v4_me_show's actor pair (both halves, one alone is a 400). Open work is filter[status][in] with the open statuses, not completed_at (a reopened task keeps it); overdue adds filter[due_date][lt] today from v4_me_show's now. A task record carries no assignees: who is on a task is v4_task_assignments_list filter[task_id]. count=true on the first page answers "how many".
v4_tasks_list_notes
ChatGPTList task notes Requires the tasks:read scope.
v4_tasks_remove_checklist_item
ChatGPTRemove one item from a task's checklist position is the item's number in the task's checklist, from 1; item is its current text, which must still be at that position - otherwise a 409 shows the list as it is now and nothing is removed. The items after it move up one place. Requires the tasks:modify scope. How to call it: position is the item's number in the task's checklist from v4_tasks_get, counting from 1, and item is its current text, exactly as read. A 409 means the list changed: read the task again and use the position and text it shows now.
v4_tasks_unassign_tag
ChatGPTRemove a tag from a task (the tag itself stays) One tag per call; the task's other tags stay, and a tag the task does not have changes nothing. The task is not deleted: assign the tag again to undo. Requires the tasks:modify scope.
v4_tasks_update
ChatGPTUpdate a task Assignees are not changed here (a 400): v4_task_assignments_create and v4_task_assignments_delete. tag_ids and checklist here REPLACE the whole list, and a tag or item left out is gone: to put on or take off one tag use v4_tasks_assign_tag and v4_tasks_unassign_tag, to change one checklist item v4_tasks_add_checklist_item, v4_tasks_update_checklist_item and v4_tasks_remove_checklist_item. Requires the tasks:modify scope. How to call it: Send only the fields to change. checklist and tag_ids each REPLACE the whole list; for one tag use v4_tasks_assign_tag / v4_tasks_unassign_tag, for one checklist item v4_tasks_add_checklist_item, v4_tasks_update_checklist_item or v4_tasks_remove_checklist_item. Completing a task is status completed. schedule null stops the repeat for the whole series. assignees are a 400 here: v4_task_assignments_create and v4_task_assignments_delete.
v4_tasks_update_checklist_item
ChatGPTTick, untick or rename one item of a task's checklist position is the item's number in the task's checklist, from 1; item is its current text, which must still be at that position - if the list changed since you read it the answer is a 409 showing the list as it is now, and nothing is changed. Send checked, rename or both. Requires the tasks:modify scope. How to call it: position is the item's number in the task's checklist from v4_tasks_get, counting from 1, and item is its current text, exactly as read. A 409 means the list changed: read the task again and use the position and text it shows now.
v4_tasks_update_note
ChatGPTUpdate a task note Requires the tasks:modify scope.
v4_tax_return_templates_list
ChatGPTList the firm's tax return delivery templates - the template_id to apply to a draft return search matches the template name. The intro body and the email message are not listed. Requires the tax_return_templates:read scope.
v4_tax_returns_create
ChatGPTStart a draft tax return on an uploaded document document_id is a document of the client (v4_documents_list); the return is that client's, and one document carries at most one return. Nothing is sent and nobody is mailed: fill the package with v4_tax_returns_apply_template and v4_tax_returns_update_intro, then send it with v4_tax_returns_update. Requires the tax_returns:modify scope.
v4_tax_returns_delete
ChatGPTDelete a tax return The return, with its intro, financial summary, planned payments and signature request, is destroyed. Its document goes to the client's trash, and v4_documents_restore brings the document back without the return. Requires the tax_returns:destructive scope.
v4_tax_returns_get
ChatGPTShow a tax return Requires the tax_returns:read scope. How to call it: preparation_state is the return's delivery to the client: created (not sent), sent_to_client (waiting on the client), approved (the client approved it, approved_at), rejected. It is not an e-signature status - the record carries no signer or signature field - so never report it as signed or awaiting signature.
v4_tax_returns_get_intro
ChatGPTRead the intro of a tax return Requires the tax_returns:read scope.
v4_tax_returns_list
ChatGPTList tax returns Requires the tax_returns:read scope. How to call it: preparation_state is the return's delivery to the client: created (not sent), sent_to_client (waiting on the client), approved (the client approved it, approved_at), rejected. It is not an e-signature status - the record carries no signer or signature field - so never report it as signed or awaiting signature.
v4_tax_returns_list_categories
ChatGPTList page categories of a tax return Requires the tax_returns:read scope.
v4_tax_returns_lock_document
ChatGPTLock the tax return document behind a bill Requires the tax_returns:modify scope.
v4_tax_returns_unlock_document
ChatGPTUnlock the tax return document Requires the tax_returns:destructive scope.
v4_tax_returns_update
ChatGPTUpdate a tax return - send a draft to the client, or turn its payment reminder on or off preparation_state takes only sent_to_client: it sends a draft (created) return to the client and emails them, and any other state is refused, so nothing goes out twice. planned_payments_reminder_enabled turns the planned payments reminder on or off. Requires the tax_returns:destructive scope.
v4_tax_returns_update_intro
ChatGPTWrite the intro of a tax return Requires the tax_returns:modify scope.
v4_team_channels_create
ChatGPTCreate a team chat channel Requires the team_channels:modify scope.
v4_team_channels_create_message
ChatGPTCreate a team channel message Requires the team_channels:modify scope.
v4_team_channels_get
ChatGPTShow a team chat channel Requires the team_channels:read scope.
v4_team_channels_get_message
ChatGPTShow a team channel message Requires the team_channels:read scope.
v4_team_channels_list
ChatGPTList team chat channels Requires the team_channels:read scope.
v4_team_channels_list_messages
ChatGPTList team channel messages Requires the team_channels:read scope.
v4_time_entries_finish
ChatGPTStop a timer for good Requires the time_entries:modify scope. How to call it: The id is a time entry's. For "my timer", v4_me_show gives actor_type and actor_id; then v4_time_entries_list with filter[assignee_type], filter[assignee_id] and filter[state] (active or paused). Nothing here starts a timer or logs time.
v4_time_entries_list
ChatGPTList tracked time entries Requires the time_entries:read scope. How to call it: The assignee filter is the pair filter[assignee_type] and filter[assignee_id], never one alone; v4_me_show gives the caller's pair. duration is in seconds. invoice_status and rate come back null to a user without the billing rights, so null does not mean unbilled. count=true on the first page answers "how many".
v4_time_entries_pause
ChatGPTPause a running timer Requires the time_entries:modify scope. How to call it: The id is a time entry's. For "my timer", v4_me_show gives actor_type and actor_id; then v4_time_entries_list with filter[assignee_type], filter[assignee_id] and filter[state] (active or paused). Nothing here starts a timer or logs time.
v4_time_entries_resume
ChatGPTResume a paused timer Requires the time_entries:modify scope. How to call it: The id is a time entry's. For "my timer", v4_me_show gives actor_type and actor_id; then v4_time_entries_list with filter[assignee_type], filter[assignee_id] and filter[state] (active or paused). Nothing here starts a timer or logs time.
v4_account_role_assignments_create
Claudev4_account_role_assignments_delete
Claudev4_account_role_assignments_get
Claudev4_account_role_assignments_list
Claudev4_account_roles_get
Claudev4_account_roles_list
Claudev4_bills_get
Claudev4_bills_list
Claudev4_bills_list_line_items
Claudev4_blobs_create
Claudev4_blobs_get_upload_url
Claudev4_chat_threads_archive
Claudev4_chat_threads_assign
Claudev4_chat_threads_create
Claudev4_chat_threads_list
Claudev4_chat_threads_send_message
Claudev4_chat_threads_unarchive
Claudev4_chat_threads_unassign
Claudev4_client_assignments_create
Claudev4_client_assignments_delete
Claudev4_client_assignments_get
Claudev4_client_assignments_list
Claudev4_client_custom_fields_create
Claudev4_client_custom_fields_list
Claudev4_client_notes_create
Claudev4_client_notes_delete
Claudev4_client_notes_list
Claudev4_client_notes_update
Claudev4_clients_assign_tag
Claudev4_clients_create
Claudev4_clients_get
Claudev4_clients_list
Claudev4_clients_unassign_tag
Claudev4_clients_update
Claudev4_contact_custom_fields_create
Claudev4_contact_custom_fields_list
Claudev4_contact_links_create
Claudev4_contact_links_delete
Claudev4_contact_links_list
Claudev4_contacts_create
Claudev4_contacts_get
Claudev4_contacts_list
Claudev4_contacts_update
Claudev4_directories_create
Claudev4_directories_list
Claudev4_directories_move
Claudev4_directories_update
Claudev4_document_checklist_items_list
Claudev4_document_checklists_get
Claudev4_document_checklists_list
Claudev4_documents_create
Claudev4_documents_delete
Claudev4_documents_delete_forever
Claudev4_documents_get
Claudev4_documents_get_signature_request
Claudev4_documents_list
Claudev4_documents_move
Claudev4_documents_notify_client
Claudev4_documents_restore
Claudev4_documents_update
Claudev4_email_templates_get
Claudev4_email_templates_list
Claudev4_employees_get
Claudev4_employees_list
Claudev4_firm_members_list
Claudev4_job_assignments_create
Claudev4_job_assignments_delete
Claudev4_job_assignments_list
Claudev4_job_client_statuses_create
Claudev4_job_client_statuses_list
Claudev4_job_client_statuses_update
Claudev4_job_recurrence_assignments_create
Claudev4_job_recurrence_assignments_delete
Claudev4_job_recurrence_assignments_list
Claudev4_job_recurrences_create
Claudev4_job_recurrences_delete
Claudev4_job_recurrences_list
Claudev4_job_recurrences_update
Claudev4_job_statuses_list
Claudev4_job_templates_get
Claudev4_job_templates_list
Claudev4_jobs_create
Claudev4_jobs_create_link
Claudev4_jobs_get
Claudev4_jobs_list
Claudev4_jobs_list_links
Claudev4_jobs_list_unfinished_requirements
Claudev4_jobs_move
Claudev4_jobs_update
Claudev4_jobs_update_status
Claudev4_mailbox_messages_create
Claudev4_mailbox_threads_assign
Claudev4_mailbox_threads_get
Claudev4_mailbox_threads_list
Claudev4_mailbox_threads_unassign
Claudev4_me_show
Claudev4_message_templates_get
Claudev4_message_templates_list
Claudev4_organizers_get
Claudev4_organizers_list
Claudev4_owner_show
Claudev4_payments_get
Claudev4_payments_list
Claudev4_pipeline_stages_list
Claudev4_pipelines_clone
Claudev4_pipelines_create
Claudev4_pipelines_get
Claudev4_pipelines_list
Claudev4_proposals_get
Claudev4_proposals_list
Claudev4_proposals_list_line_items
Claudev4_proposals_list_packages
Claudev4_sms_templates_get
Claudev4_sms_templates_list
Claudev4_sms_threads_list
Claudev4_sms_threads_resend_message
Claudev4_sms_threads_send_message
Claudev4_tags_colors
Claudev4_tags_create
Claudev4_tags_get
Claudev4_tags_list
Claudev4_tags_update
Claudev4_task_assignments_create
Claudev4_task_assignments_delete
Claudev4_task_assignments_list
Claudev4_tasks_add_checklist_item
Claudev4_tasks_assign_tag
Claudev4_tasks_create
Claudev4_tasks_create_note
Claudev4_tasks_delete
Claudev4_tasks_delete_note
Claudev4_tasks_get
Claudev4_tasks_list
Claudev4_tasks_list_notes
Claudev4_tasks_remove_checklist_item
Claudev4_tasks_unassign_tag
Claudev4_tasks_update
Claudev4_tasks_update_checklist_item
Claudev4_tasks_update_note
Claudev4_tax_return_templates_list
Claudev4_tax_returns_apply_template
Claudev4_tax_returns_create
Claudev4_tax_returns_delete
Claudev4_tax_returns_get
Claudev4_tax_returns_get_intro
Claudev4_tax_returns_list
Claudev4_tax_returns_list_categories
Claudev4_tax_returns_lock_document
Claudev4_tax_returns_unlock_document
Claudev4_tax_returns_update
Claudev4_tax_returns_update_intro
Claudev4_team_channels_create
Claudev4_team_channels_create_message
Claudev4_team_channels_get
Claudev4_team_channels_get_message
Claudev4_team_channels_list
Claudev4_team_channels_list_messages
Claudev4_time_entries_finish
Claudev4_time_entries_list
Claudev4_time_entries_pause
Claudev4_time_entries_resume
Claude