Browse the manual

Tool reference

Every agent tool by app, with its HTTP route, grant and the permission the delegated person needs.

On this page

This page lists every tool of the Agent API, grouped by app. The list is made from the installation's own tool registry, so it shows the same tools as GET /api/v1/tools and MCP tools/list for a connection that holds every grant. AI is optional; Pepper needs no AI account.

A connection sees only the tools of the apps that are on and the grants it holds. The delegated person also needs one of the permissions in the last column, and record access applies to every call. MCP uses the names in the first column. HTTP uses the route; a write needs an Idempotency-Key header. Each tool's input and output schema comes from GET /api/v1/tools or tools/list.

A tool with the grant …:execute either asks for the delegated person's approval (its name ends in _prepare) or runs a change that the person approved. See Approve sensitive steps. Steps without a tool are on Steps that stay with people.

Invoices

Tool What it does HTTP Grant Permission
invoices_receivables Explain overdue balances GET /api/v1/invoices/receivables invoices:finance-summary financial_summary.view
tax_rates_list List tax rates GET /api/v1/tax-rates invoices:read invoices.view or invoices.view_own or invoices.manage
online-payments_get Read online payments GET /api/v1/documents/{id}/online-payments invoices:read invoices.view or invoices.view_own
online-payments_prepare Prepare an online payment POST /api/v1/online-payments/prepare invoices:prepare invoices.manage
documents_list List documents GET /api/v1/documents invoices:read invoices.view or invoices.view_own
documents_get Read a document GET /api/v1/documents/{id} invoices:read invoices.view or invoices.view_own
documents_preview Preview exact totals POST /api/v1/documents/preview invoices:read invoices.manage
drafts_create Prepare a document draft POST /api/v1/drafts invoices:prepare invoices.manage
drafts_update Change a document draft PUT /api/v1/drafts/{id} invoices:prepare invoices.manage
documents_issue_prepare Ask to issue an invoice POST /api/v1/documents/{id}/issue-approvals invoices:execute invoices.finalize
approvals_get Read an approval GET /api/v1/approvals/{id} invoices:read Any connection
approvals_cancel Cancel an approval request POST /api/v1/approvals/{id}/cancel invoices:prepare Any connection
documents_issue Issue an approved invoice POST /api/v1/approvals/{id}/execute invoices:execute invoices.finalize
views_document View documents GET /api/v1/views/document invoices:read invoices.view or invoices.view_own
drafts_credit_note Start a credit-note draft POST /api/v1/documents/{id}/credit-notes invoices:prepare invoices.manage
documents_duplicate Duplicate a document POST /api/v1/documents/{id}/duplicate invoices:prepare invoices.manage
documents_pdf Download a document PDF GET /api/v1/documents/{id}/pdf invoices:read invoices.view or invoices.view_own
documents_pdf_copy Download a document copy GET /api/v1/documents/{id}/pdf-copy invoices:read invoices.view or invoices.view_own
documents_xml Download the e-invoice XML GET /api/v1/documents/{id}/xml invoices:read invoices.view or invoices.view_own
documents_messages Read a document’s messages GET /api/v1/documents/{id}/messages invoices:read invoices.view or invoices.view_own
documents_email_draft Read the email options GET /api/v1/documents/{id}/email invoices:read invoices.manage
documents_email_preview Preview an email POST /api/v1/documents/{id}/email/preview invoices:read invoices.manage
documents_note Add an internal note POST /api/v1/documents/{id}/notes invoices:prepare invoices.manage
recurring_list List recurring schedules GET /api/v1/recurring invoices:read invoices.manage
recurring_get Read a recurring schedule GET /api/v1/recurring/{id} invoices:read invoices.manage
payments_settings Read online payment settings GET /api/v1/payments/settings invoices:read invoices.manage
documents_review_preview Preview an AI invoice review POST /api/v1/documents/{id}/review/preview invoices:read invoices.view or invoices.view_own
documents_review Run an AI invoice review POST /api/v1/documents/{id}/review invoices:prepare invoices.view or invoices.view_own
documents_review_feedback Mark an AI review answer POST /api/v1/review-decisions/{id}/feedback invoices:prepare invoices.view or invoices.view_own
documents_delete_draft_prepare Request approval: Delete a draft POST /api/v1/approvals/documents-delete-draft/{id} invoices:execute invoices.manage
documents_delete_draft Delete a draft POST /api/v1/approvals/{id}/documents-delete-draft invoices:execute invoices.manage
documents_cancel_prepare Request approval: Cancel an issued document POST /api/v1/approvals/documents-cancel/{id} invoices:execute invoices.manage
documents_cancel Cancel an issued document POST /api/v1/approvals/{id}/documents-cancel invoices:execute invoices.manage
payments_record_prepare Request approval: Record a payment POST /api/v1/approvals/payments-record/{id} invoices:execute invoices.manage
payments_record Record a payment POST /api/v1/approvals/{id}/payments-record invoices:execute invoices.manage
payments_reverse_prepare Request approval: Reverse a payment POST /api/v1/approvals/payments-reverse/{id} invoices:execute invoices.manage
payments_reverse Reverse a payment POST /api/v1/approvals/{id}/payments-reverse invoices:execute invoices.manage
refunds_record_prepare Request approval: Record a refund POST /api/v1/approvals/refunds-record/{id} invoices:execute invoices.manage
refunds_record Record a refund POST /api/v1/approvals/{id}/refunds-record invoices:execute invoices.manage
refunds_reverse_prepare Request approval: Reverse a refund POST /api/v1/approvals/refunds-reverse/{id} invoices:execute invoices.manage
refunds_reverse Reverse a refund POST /api/v1/approvals/{id}/refunds-reverse invoices:execute invoices.manage
quotes_accept_prepare Request approval: Record that a quote was accepted POST /api/v1/approvals/quotes-accept/{id} invoices:execute invoices.manage
quotes_accept Record that a quote was accepted POST /api/v1/approvals/{id}/quotes-accept invoices:execute invoices.manage
quotes_decline_prepare Request approval: Record that a quote was declined POST /api/v1/approvals/quotes-decline/{id} invoices:execute invoices.manage
quotes_decline Record that a quote was declined POST /api/v1/approvals/{id}/quotes-decline invoices:execute invoices.manage
quotes_convert_prepare Request approval: Turn a quote into an invoice draft POST /api/v1/approvals/quotes-convert/{id} invoices:execute invoices.manage
quotes_convert Turn a quote into an invoice draft POST /api/v1/approvals/{id}/quotes-convert invoices:execute invoices.manage
proformas_convert_prepare Request approval: Turn a pro forma into an invoice draft POST /api/v1/approvals/proformas-convert/{id} invoices:execute invoices.manage
proformas_convert Turn a pro forma into an invoice draft POST /api/v1/approvals/{id}/proformas-convert invoices:execute invoices.manage
documents_send_prepare Request approval: Send a document by email POST /api/v1/approvals/documents-send/{id} invoices:execute invoices.manage
documents_send Send a document by email POST /api/v1/approvals/{id}/documents-send invoices:execute invoices.manage
documents_remind_prepare Request approval: Send a payment reminder POST /api/v1/approvals/documents-remind/{id} invoices:execute invoices.manage
documents_remind Send a payment reminder POST /api/v1/approvals/{id}/documents-remind invoices:execute invoices.manage
documents_reminders_pause_prepare Request approval: Pause or resume reminders POST /api/v1/approvals/documents-reminders-pause/{id} invoices:execute invoices.manage
documents_reminders_pause Pause or resume reminders POST /api/v1/approvals/{id}/documents-reminders-pause invoices:execute invoices.manage
documents_record_delivery_prepare Request approval: Record a delivery outside Pepper POST /api/v1/approvals/documents-record-delivery/{id} invoices:execute invoices.manage
documents_record_delivery Record a delivery outside Pepper POST /api/v1/approvals/{id}/documents-record-delivery invoices:execute invoices.manage
recurring_save_prepare Request approval: Save a recurring schedule POST /api/v1/approvals/recurring-save invoices:execute invoices.manage
recurring_save Save a recurring schedule POST /api/v1/approvals/{id}/recurring-save invoices:execute invoices.manage
recurring_run_prepare Request approval: Create the next recurring invoice POST /api/v1/approvals/recurring-run/{id} invoices:execute invoices.manage
recurring_run Create the next recurring invoice POST /api/v1/approvals/{id}/recurring-run invoices:execute invoices.manage
recurring_change_prepare Request approval: Pause, resume or delete a schedule POST /api/v1/approvals/recurring-change/{id} invoices:execute invoices.manage
recurring_change Pause, resume or delete a schedule POST /api/v1/approvals/{id}/recurring-change invoices:execute invoices.manage
payments_online_enable_prepare Request approval: Switch online payments on or off POST /api/v1/approvals/payments-online-enable invoices:execute invoices.manage
payments_online_enable Switch online payments on or off POST /api/v1/approvals/{id}/payments-online-enable invoices:execute invoices.manage
payments_online_refund_prepare Request approval: Send an online refund POST /api/v1/approvals/payments-online-refund/{id} invoices:execute invoices.manage
payments_online_refund Send an online refund POST /api/v1/approvals/{id}/payments-online-refund invoices:execute invoices.manage
payments_online_check_prepare Request approval: Check an online payment with Stripe POST /api/v1/approvals/payments-online-check/{id} invoices:execute invoices.manage
payments_online_check Check an online payment with Stripe POST /api/v1/approvals/{id}/payments-online-check invoices:execute invoices.manage
payments_online_recover_prepare Request approval: Link an online payment to its Stripe record POST /api/v1/approvals/payments-online-recover/{id} invoices:execute invoices.manage
payments_online_recover Link an online payment to its Stripe record POST /api/v1/approvals/{id}/payments-online-recover invoices:execute invoices.manage

Customers

Tool What it does HTTP Grant Permission
customers_context Show customer context GET /api/v1/customers/{id}/context customers:read customers.view
customers_workspace Read a customer workspace GET /api/v1/customers/{id}/workspace customers:read customers.view
customers_search Search customers GET /api/v1/customers customers:read customers.view
views_customer View customers GET /api/v1/views/customer customers:read customers.view
customers_create_prepare Request approval: Add a customer POST /api/v1/approvals/customers-create customers:execute customers.manage
customers_create Add a customer POST /api/v1/approvals/{id}/customers-create customers:execute customers.manage
customers_update_prepare Request approval: Change a customer POST /api/v1/approvals/customers-update/{id} customers:execute customers.manage
customers_update Change a customer POST /api/v1/approvals/{id}/customers-update customers:execute customers.manage
customers_delete_prepare Request approval: Delete a customer POST /api/v1/approvals/customers-delete/{id} customers:execute customers.manage
customers_delete Delete a customer POST /api/v1/approvals/{id}/customers-delete customers:execute customers.manage
customers_contact_save_prepare Request approval: Save a customer contact POST /api/v1/approvals/customers-contact-save/{id} customers:execute customers.manage
customers_contact_save Save a customer contact POST /api/v1/approvals/{id}/customers-contact-save customers:execute customers.manage
customers_contact_delete_prepare Request approval: Delete a customer contact POST /api/v1/approvals/customers-contact-delete/{id} customers:execute customers.manage
customers_contact_delete Delete a customer contact POST /api/v1/approvals/{id}/customers-contact-delete customers:execute customers.manage
customers_contact_reorder_prepare Request approval: Reorder customer contacts POST /api/v1/approvals/customers-contact-reorder/{id} customers:execute customers.manage
customers_contact_reorder Reorder customer contacts POST /api/v1/approvals/{id}/customers-contact-reorder customers:execute customers.manage
customers_import_prepare Request approval: Import customers POST /api/v1/approvals/customers-import customers:execute customers.manage
customers_import Import customers POST /api/v1/approvals/{id}/customers-import customers:execute customers.manage
customers_export_prepare Request approval: Export customers POST /api/v1/approvals/customers-export customers:execute customers.view
customers_export Export customers POST /api/v1/approvals/{id}/customers-export customers:execute customers.view
customers_workspace_provision_prepare Request approval: Open a hosted workspace POST /api/v1/approvals/customers-workspace-provision/{id} customers:execute customers.manage
customers_workspace_provision Open a hosted workspace POST /api/v1/approvals/{id}/customers-workspace-provision customers:execute customers.manage
customers_workspace_plan_prepare Request approval: Put a workspace on a plan POST /api/v1/approvals/customers-workspace-plan/{id} customers:execute customers.manage
customers_workspace_plan Put a workspace on a plan POST /api/v1/approvals/{id}/customers-workspace-plan customers:execute customers.manage
customers_workspace_state_prepare Request approval: Change a workspace state POST /api/v1/approvals/customers-workspace-state/{id} customers:execute customers.manage
customers_workspace_state Change a workspace state POST /api/v1/approvals/{id}/customers-workspace-state customers:execute customers.manage
customers_workspace_resend_prepare Request approval: Resend a workspace invitation POST /api/v1/approvals/customers-workspace-resend/{id} customers:execute customers.manage
customers_workspace_resend Resend a workspace invitation POST /api/v1/approvals/{id}/customers-workspace-resend customers:execute customers.manage

Sales

Tool What it does HTTP Grant Permission
leads_list List leads GET /api/v1/leads crm:read crm.use or crm.manage
leads_get Read a lead GET /api/v1/leads/{id} crm:read crm.use or crm.manage
leads_create Add a lead POST /api/v1/leads crm:prepare crm.use or crm.manage
leads_qualify Qualify a lead into a customer and a deal POST /api/v1/leads/{id}/qualify crm:prepare crm.use or crm.manage
deals_list List deals GET /api/v1/deals crm:read crm.use or crm.manage
deals_get Read a deal GET /api/v1/deals/{id} crm:read crm.use or crm.manage
deals_create Add a deal POST /api/v1/deals crm:prepare crm.use or crm.manage
deals_move Move a deal to a stage POST /api/v1/deals/{id}/move crm:prepare crm.use or crm.manage
deals_outcome Record a deal as won or lost POST /api/v1/deals/{id}/outcome crm:prepare crm.use or crm.manage
deals_prepare_quote Prepare a quote draft for a deal POST /api/v1/deals/{id}/quote crm:prepare invoices.manage
sales_overview Read the sales overview GET /api/v1/sales/overview crm:read crm.use or crm.manage
sales_stages List the pipeline stages GET /api/v1/sales/stages crm:read crm.use or crm.manage
leads_matches Find matches for a lead GET /api/v1/leads/{id}/matches crm:read crm.use or crm.manage
deals_timeline Read a deal’s history GET /api/v1/deals/{id}/timeline crm:read crm.use or crm.manage
leads_update Change a lead PUT /api/v1/leads/{id} crm:prepare crm.use or crm.manage
leads_next_step Set a lead’s next step POST /api/v1/leads/{id}/next-step crm:prepare crm.use or crm.manage
leads_assign Assign a lead POST /api/v1/leads/{id}/assignee crm:prepare crm.use or crm.manage
leads_contacted Mark a lead as contacted POST /api/v1/leads/{id}/contacted crm:prepare crm.use or crm.manage
leads_unqualify Close a lead as unqualified POST /api/v1/leads/{id}/unqualify crm:prepare crm.use or crm.manage
leads_reopen Reopen a lead POST /api/v1/leads/{id}/reopen crm:prepare crm.use or crm.manage
leads_archive Archive or restore a lead POST /api/v1/leads/{id}/archive crm:prepare crm.use or crm.manage
leads_tag Tag a lead POST /api/v1/leads/{id}/tags crm:prepare crm.use or crm.manage
deals_update Change a deal PUT /api/v1/deals/{id} crm:prepare crm.use or crm.manage
deals_next_step Set a deal’s next step POST /api/v1/deals/{id}/next-step crm:prepare crm.use or crm.manage
deals_assign Assign a deal POST /api/v1/deals/{id}/assignee crm:prepare crm.use or crm.manage
deals_reopen Reopen a deal POST /api/v1/deals/{id}/reopen crm:prepare crm.use or crm.manage
deals_archive Archive or restore a deal POST /api/v1/deals/{id}/archive crm:prepare crm.use or crm.manage
deals_tag Tag a deal POST /api/v1/deals/{id}/tags crm:prepare crm.use or crm.manage
deals_open_project Open the project of a won deal POST /api/v1/deals/{id}/project crm:prepare crm.use or crm.manage
sales_next_step_task Turn a next step into a task POST /api/v1/sales/{id}/task crm:prepare crm.use or crm.manage
views_lead View leads GET /api/v1/views/lead crm:read crm.use or crm.manage
views_deal View deals GET /api/v1/views/deal crm:read crm.use or crm.manage
views_lead_bulk Change many leads POST /api/v1/views/lead/bulk crm:prepare crm.use or crm.manage
views_deal_bulk Change many deals POST /api/v1/views/deal/bulk crm:prepare crm.use or crm.manage
views_deal_move Move a deal on the board POST /api/v1/views/deal/move/{id} crm:prepare crm.use or crm.manage
pipeline_stage_create_prepare Request approval: Add a pipeline stage POST /api/v1/approvals/pipeline-stage-create crm:execute crm.manage
pipeline_stage_create Add a pipeline stage POST /api/v1/approvals/{id}/pipeline-stage-create crm:execute crm.manage
pipeline_stage_update_prepare Request approval: Change a pipeline stage POST /api/v1/approvals/pipeline-stage-update/{id} crm:execute crm.manage
pipeline_stage_update Change a pipeline stage POST /api/v1/approvals/{id}/pipeline-stage-update crm:execute crm.manage
pipeline_stage_reorder_prepare Request approval: Reorder pipeline stages POST /api/v1/approvals/pipeline-stage-reorder crm:execute crm.manage
pipeline_stage_reorder Reorder pipeline stages POST /api/v1/approvals/{id}/pipeline-stage-reorder crm:execute crm.manage
pipeline_stage_archive_prepare Request approval: Archive a pipeline stage POST /api/v1/approvals/pipeline-stage-archive/{id} crm:execute crm.manage
pipeline_stage_archive Archive a pipeline stage POST /api/v1/approvals/{id}/pipeline-stage-archive crm:execute crm.manage
pipeline_reason_create_prepare Request approval: Add a lost reason POST /api/v1/approvals/pipeline-reason-create crm:execute crm.manage
pipeline_reason_create Add a lost reason POST /api/v1/approvals/{id}/pipeline-reason-create crm:execute crm.manage
pipeline_reason_update_prepare Request approval: Rename a lost reason POST /api/v1/approvals/pipeline-reason-update/{id} crm:execute crm.manage
pipeline_reason_update Rename a lost reason POST /api/v1/approvals/{id}/pipeline-reason-update crm:execute crm.manage
pipeline_reason_archive_prepare Request approval: Archive a lost reason POST /api/v1/approvals/pipeline-reason-archive/{id} crm:execute crm.manage
pipeline_reason_archive Archive a lost reason POST /api/v1/approvals/{id}/pipeline-reason-archive crm:execute crm.manage
leads_import_prepare Request approval: Import leads POST /api/v1/approvals/leads-import crm:execute crm.manage
leads_import Import leads POST /api/v1/approvals/{id}/leads-import crm:execute crm.manage
sales_overview_export_prepare Request approval: Export the Sales overview POST /api/v1/approvals/sales-overview-export crm:execute crm.manage
sales_overview_export Export the Sales overview POST /api/v1/approvals/{id}/sales-overview-export crm:execute crm.manage
leads_privacy_report_prepare Request approval: Make a lead’s personal-data report POST /api/v1/approvals/leads-privacy-report/{id} crm:execute crm.manage
leads_privacy_report Make a lead’s personal-data report POST /api/v1/approvals/{id}/leads-privacy-report crm:execute crm.manage

Projects

Tool What it does HTTP Grant Permission
assignees_search Find assignees GET /api/v1/assignees engagements:read projects.use or projects.manage
decisions_list List customer decisions GET /api/v1/decisions engagements:read projects.use or projects.manage
decisions_get Read a customer decision GET /api/v1/decisions/{id} engagements:read projects.use or projects.manage
decisions_prepare Prepare a proof or job page POST /api/v1/decisions/prepare engagements:prepare projects.use or projects.manage
decisions_options Find records for a customer page GET /api/v1/decisions/options engagements:read projects.use or projects.manage
engagements_list List projects GET /api/v1/engagements engagements:read customers.view or projects.use or projects.manage
engagements_get Read a project GET /api/v1/engagements/{id} engagements:read customers.view or projects.use or projects.manage
engagements_create Add a project POST /api/v1/engagements engagements:prepare invoices.manage
engagements_milestone Plan a milestone POST /api/v1/engagements/{id}/milestones engagements:prepare invoices.manage
engagements_close Close or reopen a project POST /api/v1/engagements/{id}/state engagements:prepare invoices.manage
engagements_preview_invoice Preview a project invoice POST /api/v1/engagements/{id}/invoice-preview engagements:read invoices.manage
engagements_prepare_invoice Prepare a project invoice draft POST /api/v1/engagements/{id}/invoice-draft engagements:prepare invoices.manage
tasks_list List tasks within the current person’s scope GET /api/v1/tasks engagements:read projects.use or projects.manage
tasks_get Read one task, its current status and version GET /api/v1/tasks/{id} engagements:read projects.use or projects.manage
tasks_create Create a task with a stable request key POST /api/v1/tasks engagements:prepare projects.use or projects.manage
tasks_update Edit a task at its current version POST /api/v1/tasks/{id} engagements:prepare projects.use or projects.manage
tasks_complete Complete a task through its completed status POST /api/v1/tasks/{id}/complete engagements:prepare projects.use or projects.manage
time_list List permitted time entries GET /api/v1/time engagements:read projects.use or projects.manage
time_log Log exact minutes for the permitted person and work POST /api/v1/time engagements:prepare projects.use or projects.manage
time_start Start the person’s timer, stopping their previous timer POST /api/v1/time/start engagements:prepare projects.use or projects.manage
time_stop Stop the person’s running timer POST /api/v1/time/stop engagements:prepare projects.use or projects.manage
projects_unbilled Read unbilled project time and exact values per currency GET /api/v1/projects/unbilled engagements:read financial_summary.view
projects_margin Read project margin from issued net invoices, purchases and costed time GET /api/v1/projects/margin engagements:read financial_summary.view
projects_workload Read planned, logged and available time for a week GET /api/v1/projects/workload engagements:read projects.manage
work_mine Read My work GET /api/v1/work/mine engagements:read projects.use or projects.manage
work_settings Read the work settings GET /api/v1/work/settings engagements:read projects.use or projects.manage
time_defaults Read time entry defaults GET /api/v1/time/defaults engagements:read projects.use or projects.manage
time_timesheet Read a weekly timesheet GET /api/v1/time/week engagements:read projects.use or projects.manage
time_timer Read the running timer GET /api/v1/time/timer engagements:read projects.use or projects.manage
tasks_statuses Read task statuses GET /api/v1/tasks/statuses engagements:read projects.use or projects.manage
engagements_scope Record a project scope POST /api/v1/engagements/{id}/scope engagements:prepare projects.manage
engagements_milestone_state Change a milestone state POST /api/v1/engagements/{id}/milestones/state engagements:prepare projects.manage
engagements_settings Change project settings POST /api/v1/engagements/{id}/settings engagements:prepare projects.manage
engagements_import_quote_lines Copy quote lines into a project POST /api/v1/engagements/{id}/quote-lines engagements:prepare projects.manage
tasks_statuses_save Change task statuses POST /api/v1/tasks/statuses engagements:prepare projects.manage
tasks_move Move a task to a status POST /api/v1/tasks/{id}/status engagements:prepare projects.use or projects.manage
tasks_reopen Reopen a task POST /api/v1/tasks/{id}/reopen engagements:prepare projects.use or projects.manage
tasks_assign Assign a task POST /api/v1/tasks/{id}/assignee engagements:prepare projects.use or projects.manage
tasks_reschedule Change a task’s dates POST /api/v1/tasks/{id}/dates engagements:prepare projects.use or projects.manage
tasks_watch Watch a task POST /api/v1/tasks/{id}/watch engagements:prepare projects.use or projects.manage
tasks_link Set a task’s blockers POST /api/v1/tasks/{id}/links engagements:prepare projects.use or projects.manage
tasks_archive Archive or restore a task POST /api/v1/tasks/{id}/archive engagements:prepare projects.use or projects.manage
tasks_tag Tag a task POST /api/v1/tasks/{id}/tags engagements:prepare projects.use or projects.manage
tasks_attach_project Move a task into a project POST /api/v1/tasks/{id}/project engagements:prepare projects.use or projects.manage
tasks_from_card Turn a card into a task POST /api/v1/cards/{id}/task engagements:prepare projects.use or projects.manage
time_update Correct a time entry PUT /api/v1/time/{id} engagements:prepare projects.use or projects.manage
time_delete Delete a time entry POST /api/v1/time/{id}/delete engagements:prepare projects.use or projects.manage
time_cell Set a timesheet cell POST /api/v1/time/cell engagements:prepare projects.use or projects.manage
views_engagement View projects GET /api/v1/views/engagement engagements:read projects.use or projects.manage or customers.view
views_task View tasks GET /api/v1/views/task engagements:read projects.use or projects.manage
views_time_entry View time entries GET /api/v1/views/time_entry engagements:read projects.use or projects.manage
views_task_bulk Change many tasks POST /api/v1/views/task/bulk engagements:prepare projects.use or projects.manage
views_task_move Move a task on the board POST /api/v1/views/task/move/{id} engagements:prepare projects.use or projects.manage
decisions_job_move_prepare Request approval: Move a job to another stage POST /api/v1/approvals/decisions-job-move/{id} engagements:execute projects.manage
decisions_job_move Move a job to another stage POST /api/v1/approvals/{id}/decisions-job-move engagements:execute projects.manage
decisions_job_close_prepare Request approval: Close or reopen a job page POST /api/v1/approvals/decisions-job-close/{id} engagements:execute projects.manage
decisions_job_close Close or reopen a job page POST /api/v1/approvals/{id}/decisions-job-close engagements:execute projects.manage
decisions_question_ask_prepare Request approval: Ask a customer a question POST /api/v1/approvals/decisions-question-ask/{id} engagements:execute projects.manage
decisions_question_ask Ask a customer a question POST /api/v1/approvals/{id}/decisions-question-ask engagements:execute projects.manage
decisions_question_reopen_prepare Request approval: Ask a question again POST /api/v1/approvals/decisions-question-reopen/{id} engagements:execute projects.manage
decisions_question_reopen Ask a question again POST /api/v1/approvals/{id}/decisions-question-reopen engagements:execute projects.manage
decisions_remind_prepare Request approval: Remind a customer about open questions POST /api/v1/approvals/decisions-remind/{id} engagements:execute projects.manage
decisions_remind Remind a customer about open questions POST /api/v1/approvals/{id}/decisions-remind engagements:execute projects.manage
decisions_notice_retry_prepare Request approval: Send a customer page email again POST /api/v1/approvals/decisions-notice-retry/{id} engagements:execute projects.manage
decisions_notice_retry Send a customer page email again POST /api/v1/approvals/{id}/decisions-notice-retry engagements:execute projects.manage
projects_work_settings_prepare Request approval: Change work settings POST /api/v1/approvals/projects-work-settings engagements:execute projects.manage
projects_work_settings Change work settings POST /api/v1/approvals/{id}/projects-work-settings engagements:execute projects.manage
projects_report_export_prepare Request approval: Export a project report POST /api/v1/approvals/projects-report-export engagements:execute projects.use
projects_report_export Export a project report POST /api/v1/approvals/{id}/projects-report-export engagements:execute projects.use
projects_time_export_prepare Request approval: Export tracked time POST /api/v1/approvals/projects-time-export engagements:execute projects.use
projects_time_export Export tracked time POST /api/v1/approvals/{id}/projects-time-export engagements:execute projects.use
projects_workload_export_prepare Request approval: Export the workload POST /api/v1/approvals/projects-workload-export engagements:execute projects.manage
projects_workload_export Export the workload POST /api/v1/approvals/{id}/projects-workload-export engagements:execute projects.manage

Boards

Tool What it does HTTP Grant Permission
boards_list Find boards GET /api/v1/boards boards:read boards.use
boards_get Read a board GET /api/v1/boards/{id} boards:read boards.use
cards_list Read a list’s cards GET /api/v1/board-lists/{id}/cards boards:read boards.use
cards_get Read a card GET /api/v1/board-cards/{id} boards:read boards.use
boards_prepare Prepare a board or card change POST /api/v1/boards/prepare boards:prepare boards.use
cards_mine Read my cards GET /api/v1/cards/mine boards:read boards.use
boards_backlinks Find cards that link a record GET /api/v1/boards/backlinks boards:read boards.use
boards_source_url Resolve a record link GET /api/v1/boards/source boards:read boards.use
boards_directory List every board GET /api/v1/boards/directory boards:read boards.use
boards_update Change board settings POST /api/v1/boards/{id}/settings boards:prepare boards.use
boards_label Add or change a board label POST /api/v1/boards/{id}/labels boards:prepare boards.use
boards_copy Copy a board POST /api/v1/boards/{id}/copy boards:prepare boards.use
boards_remove_examples Remove sample cards POST /api/v1/boards/{id}/examples/remove boards:prepare boards.use
boards_upload_prepare Start a board upload POST /api/v1/boards/uploads boards:prepare boards.use
boards_background Set a board background POST /api/v1/boards/{id}/background boards:prepare boards.use
boards_import_preview Check a Trello export POST /api/v1/boards/import/preview boards:prepare boards.use
boards_import Import a Trello board POST /api/v1/boards/import boards:prepare boards.use
cards_update Change a card POST /api/v1/board-cards/{id} boards:prepare boards.use
cards_participate Join, watch or react to a card POST /api/v1/board-cards/{id}/participate boards:prepare boards.use
cards_copy Copy a card POST /api/v1/board-cards/{id}/copy boards:prepare boards.use
cards_undo Undo a card change POST /api/v1/board-undo/{id} boards:prepare boards.use
cards_attach_files Attach files to a card POST /api/v1/board-cards/{id}/files boards:prepare boards.use
cards_drop_file Add a card for a file POST /api/v1/boards/{id}/drop boards:prepare boards.use
lists_create Add a list POST /api/v1/boards/{id}/lists boards:prepare boards.use
lists_update Change a list POST /api/v1/board-lists/{id} boards:prepare boards.use
lists_copy Copy a list POST /api/v1/board-lists/{id}/copy boards:prepare boards.use
lists_move_all Move all cards of a list POST /api/v1/board-lists/{id}/move-all boards:prepare boards.use
boards_audience_prepare Request approval: Change who can open a board POST /api/v1/approvals/boards-audience/{id} boards:execute boards.use
boards_audience Change who can open a board POST /api/v1/approvals/{id}/boards-audience boards:execute boards.use
boards_member_role_prepare Request approval: Change a board member POST /api/v1/approvals/boards-member-role/{id} boards:execute boards.use
boards_member_role Change a board member POST /api/v1/approvals/{id}/boards-member-role boards:execute boards.use
boards_join_admin_prepare Request approval: Join a board as admin POST /api/v1/approvals/boards-join-admin/{id} boards:execute boards.manage
boards_join_admin Join a board as admin POST /api/v1/approvals/{id}/boards-join-admin boards:execute boards.manage
boards_export_prepare Request approval: Export a board POST /api/v1/approvals/boards-export/{id} boards:execute boards.use
boards_export Export a board POST /api/v1/approvals/{id}/boards-export boards:execute boards.use
boards_delete_prepare Request approval: Delete a board POST /api/v1/approvals/boards-delete/{id} boards:execute boards.use
boards_delete Delete a board POST /api/v1/approvals/{id}/boards-delete boards:execute boards.use

Purchases

Tool What it does HTTP Grant Permission
purchase_categories_list List purchase categories GET /api/v1/purchase-categories purchases:read purchases.view or purchases.view_own or purchases.manage
suppliers_list List suppliers GET /api/v1/suppliers purchases:read purchases.manage or purchases.view
purchases_list List purchases GET /api/v1/purchases purchases:read purchases.view or purchases.view_own
purchases_get Read a purchase GET /api/v1/purchases/{id} purchases:read purchases.view or purchases.view_own
purchases_create Record a purchase POST /api/v1/purchases purchases:prepare purchases.manage
purchases_update Change a purchase PUT /api/v1/purchases/{id} purchases:prepare purchases.manage
purchases_receipt_prepare Start a receipt upload POST /api/v1/purchases/receipts purchases:prepare purchases.manage
purchases_attach_files Attach receipts to a purchase POST /api/v1/purchases/{id}/files purchases:prepare purchases.manage
purchases_replace_file Replace a receipt POST /api/v1/purchases/{id}/files/replace purchases:prepare purchases.manage
purchases_file Download a receipt GET /api/v1/purchases/{id}/file purchases:read purchases.view or purchases.view_own
periods_get Read a tax period GET /api/v1/periods purchases:read financial_summary.view
views_purchase View purchases GET /api/v1/views/purchase purchases:read purchases.view or purchases.view_own
purchases_payment_prepare Request approval: Record that a purchase was paid POST /api/v1/approvals/purchases-payment/{id} purchases:execute purchases.manage
purchases_payment Record that a purchase was paid POST /api/v1/approvals/{id}/purchases-payment purchases:execute purchases.manage
purchases_void_prepare Request approval: Void a purchase POST /api/v1/approvals/purchases-void/{id} purchases:execute purchases.manage
purchases_void Void a purchase POST /api/v1/approvals/{id}/purchases-void purchases:execute purchases.manage
purchases_category_create_prepare Request approval: Add a purchase category POST /api/v1/approvals/purchases-category-create purchases:execute purchases.manage
purchases_category_create Add a purchase category POST /api/v1/approvals/{id}/purchases-category-create purchases:execute purchases.manage
purchases_category_update_prepare Request approval: Change a purchase category POST /api/v1/approvals/purchases-category-update/{id} purchases:execute purchases.manage
purchases_category_update Change a purchase category POST /api/v1/approvals/{id}/purchases-category-update purchases:execute purchases.manage
purchases_period_export_prepare Request approval: Export a tax period POST /api/v1/approvals/purchases-period-export purchases:execute purchases.manage
purchases_period_export Export a tax period POST /api/v1/approvals/{id}/purchases-period-export purchases:execute purchases.manage

Items

Tool What it does HTTP Grant Permission
item_categories_list List item categories GET /api/v1/item-categories items:read items.view or items.manage
menu-items_get Read menu item details GET /api/v1/menu-items/{id} items:read items.manage
menu-items_prepare Prepare menu item details POST /api/v1/menu-items/prepare items:prepare items.manage
items_list List catalogue items GET /api/v1/items items:read items.view
items_get Read an item GET /api/v1/items/{id} items:read items.manage
items_create Add an item POST /api/v1/items items:prepare items.manage
items_update Change an item PUT /api/v1/items/{id} items:prepare items.manage
views_item View items GET /api/v1/views/item items:read items.view
views_item_bulk Change many items POST /api/v1/views/item/bulk items:prepare items.manage
views_item_move Move an item on the board POST /api/v1/views/item/move/{id} items:prepare items.manage
items_delete_prepare Request approval: Delete an item POST /api/v1/approvals/items-delete/{id} items:execute items.manage
items_delete Delete an item POST /api/v1/approvals/{id}/items-delete items:execute items.manage
items_import_prepare Request approval: Import items POST /api/v1/approvals/items-import items:execute items.manage
items_import Import items POST /api/v1/approvals/{id}/items-import items:execute items.manage
items_export_prepare Request approval: Export items POST /api/v1/approvals/items-export items:execute items.view
items_export Export items POST /api/v1/approvals/{id}/items-export items:execute items.view

Offers

Tool What it does HTTP Grant Permission
offers_list List offer records GET /api/v1/offers offers:read offers.manage
offers_counter_check Check a counter code POST /api/v1/offers/counter/check offers:read offers.redeem
offers_counter_recent Read recent counter activity GET /api/v1/offers/counter/recent offers:read offers.redeem
offers_claims_get Read an offer claim GET /api/v1/offers/claims/{id} offers:read offers.manage
offers_cards_get Read a stamp card GET /api/v1/offers/cards/{id} offers:read offers.manage
offers_events_get Read a counter event GET /api/v1/offers/events/{id} offers:read offers.manage
offers_counter_confirm_prepare Request approval: Stamp or redeem at the counter POST /api/v1/approvals/offers-counter-confirm offers:execute offers.redeem
offers_counter_confirm Stamp or redeem at the counter POST /api/v1/approvals/{id}/offers-counter-confirm offers:execute offers.redeem
offers_counter_correct_prepare Request approval: Correct a counter visit POST /api/v1/approvals/offers-counter-correct offers:execute offers.redeem
offers_counter_correct Correct a counter visit POST /api/v1/approvals/{id}/offers-counter-correct offers:execute offers.redeem

Listings

Tool What it does HTTP Grant Permission
listings_availability Set listing availability POST /api/v1/listings/{id}/status listings:prepare listings.manage
listings_request_file Download a listing request file GET /api/v1/listings/requests/{id}/files/{file_id} listings:read listings.manage
listings_get Read a listing GET /api/v1/listings/{id} listings:read listings.manage or crm.use
listings_requests_get Read listing requests GET /api/v1/listing-requests/{id} listings:read listings.manage or crm.use
listings_prepare Prepare a listing POST /api/v1/listings/prepare listings:prepare listings.manage
views_listing View listings GET /api/v1/views/listing listings:read listings.manage or crm.use
views_listing_request View listing requests GET /api/v1/views/listing_request listings:read listings.manage or crm.use
listings_publish_prepare Request approval: Publish or withdraw a listing POST /api/v1/approvals/listings-publish/{id} listings:execute listings.manage
listings_publish Publish or withdraw a listing POST /api/v1/approvals/{id}/listings-publish listings:execute listings.manage
listings_follow_up_prepare Request approval: Follow up a listing enquiry POST /api/v1/approvals/listings-follow-up/{id} listings:execute listings.manage
listings_follow_up Follow up a listing enquiry POST /api/v1/approvals/{id}/listings-follow-up listings:execute listings.manage
listings_alert_privacy_lookup_prepare Request approval: Find a listing-alert subscriber POST /api/v1/approvals/listings-alert-privacy-lookup listings:execute listings.manage
listings_alert_privacy_lookup Find a listing-alert subscriber POST /api/v1/approvals/{id}/listings-alert-privacy-lookup listings:execute listings.manage
listings_alert_privacy_report_prepare Request approval: Report a listing-alert subscriber’s data POST /api/v1/approvals/listings-alert-privacy-report listings:execute listings.manage
listings_alert_privacy_report Report a listing-alert subscriber’s data POST /api/v1/approvals/{id}/listings-alert-privacy-report listings:execute listings.manage
listings_alert_privacy_erase_prepare Request approval: Erase a listing-alert subscriber’s data POST /api/v1/approvals/listings-alert-privacy-erase listings:execute listings.manage
listings_alert_privacy_erase Erase a listing-alert subscriber’s data POST /api/v1/approvals/{id}/listings-alert-privacy-erase listings:execute listings.manage

Bookings

Tool What it does HTTP Grant Permission
booking-definitions_list List booking definitions GET /api/v1/booking-definitions bookings:read bookings.manage
bookings_get Read a booking GET /api/v1/bookings/{id} bookings:read bookings.manage or bookings.use
bookings_prepare Prepare a booking for human review POST /api/v1/bookings/prepare bookings:prepare bookings.manage
booking-definitions_prepare Prepare a booking service for human review POST /api/v1/booking-definitions/prepare bookings:prepare bookings.manage
views_booking View bookings GET /api/v1/views/booking bookings:read bookings.manage or bookings.use
bookings_settings Read booking settings GET /api/v1/bookings/settings bookings:read bookings.manage
bookings_schedule_save Save a booking schedule POST /api/v1/bookings/schedules bookings:prepare bookings.manage
bookings_block Block booking dates POST /api/v1/bookings/blocks bookings:prepare bookings.manage
bookings_unblock Open blocked dates POST /api/v1/bookings/blocks/{id}/remove bookings:prepare bookings.manage
bookings_feed_update Change a calendar feed POST /api/v1/bookings/feeds/{id} bookings:prepare bookings.manage
bookings_feed_remove Remove a calendar feed POST /api/v1/bookings/feeds/{id}/remove bookings:prepare bookings.manage
bookings_feed_refresh Check a calendar feed again POST /api/v1/bookings/feeds/{id}/refresh bookings:prepare bookings.manage
bookings_change_quote Price a booking change GET /api/v1/bookings/{id}/quote bookings:read bookings.manage or bookings.use
bookings_invoice_draft Draft an invoice for a booking POST /api/v1/bookings/{id}/invoice bookings:prepare bookings.manage or bookings.use
bookings_file Download a booking file GET /api/v1/bookings/{id}/files/{file_id} bookings:read bookings.manage or bookings.use
bookings_change_prepare Request approval: Change a booking POST /api/v1/approvals/bookings-change/{id} bookings:execute bookings.manage
bookings_change Change a booking POST /api/v1/approvals/{id}/bookings-change bookings:execute bookings.manage
bookings_mail_retry_prepare Request approval: Send a booking email again POST /api/v1/approvals/bookings-mail-retry bookings:execute bookings.manage
bookings_mail_retry Send a booking email again POST /api/v1/approvals/{id}/bookings-mail-retry bookings:execute bookings.manage

Content

Tool What it does HTTP Grant Permission
content_report Read content records GET /api/v1/content/{id}/report content:read content.manage
content_request_prepare Prepare a recipient request POST /api/v1/content-requests/prepare content:prepare content.manage
content_request_revoke Revoke a content request POST /api/v1/widgets/{id}/content-requests/{invitation_id}/revoke content:prepare content.manage
content_media Download content media GET /api/v1/content-media/{file_id}/{version_id} content:read content.manage
content_request_send_prepare Request approval: Send a content request POST /api/v1/approvals/content-request-send/{id} content:execute content.manage
content_request_send Send a content request POST /api/v1/approvals/{id}/content-request-send content:execute content.manage
content_subscriber_privacy_lookup_prepare Request approval: Find a content subscriber POST /api/v1/approvals/content-subscriber-privacy-lookup content:execute content.manage
content_subscriber_privacy_lookup Find a content subscriber POST /api/v1/approvals/{id}/content-subscriber-privacy-lookup content:execute content.manage
content_subscriber_privacy_report_prepare Request approval: Report a content subscriber’s data POST /api/v1/approvals/content-subscriber-privacy-report content:execute content.manage
content_subscriber_privacy_report Report a content subscriber’s data POST /api/v1/approvals/{id}/content-subscriber-privacy-report content:execute content.manage
content_subscriber_privacy_erase_prepare Request approval: Erase a content subscriber’s data POST /api/v1/approvals/content-subscriber-privacy-erase content:execute content.manage
content_subscriber_privacy_erase Erase a content subscriber’s data POST /api/v1/approvals/{id}/content-subscriber-privacy-erase content:execute content.manage

Analytics

Tool What it does HTTP Grant Permission
analytics_read Read widget analytics GET /api/v1/analytics analytics:read analytics.view
analytics_prepare Prepare analytics settings or a target POST /api/v1/analytics/prepare analytics:prepare analytics.manage
analytics_records List analytics records GET /api/v1/analytics/records analytics:read analytics.view
analytics_live Read live analytics GET /api/v1/analytics/live analytics:read analytics.view
analytics_configuration Read analytics goals and views GET /api/v1/analytics/configuration analytics:read analytics.view
analytics_settings Read analytics settings GET /api/v1/analytics/settings analytics:read analytics.manage
analytics_goal_archive Archive an analytics goal POST /api/v1/analytics/goals/{id}/archive analytics:prepare analytics.manage
analytics_target_delete Delete an analytics target POST /api/v1/analytics/targets/{id}/delete analytics:prepare analytics.manage
analytics_view_save Save an analytics view POST /api/v1/analytics/views analytics:prepare analytics.view
analytics_view_delete Delete an analytics view POST /api/v1/analytics/views/{id}/delete analytics:prepare analytics.view
analytics_website_prepare Request approval: Add an analytics website POST /api/v1/approvals/analytics-website analytics:execute analytics.manage
analytics_website Add an analytics website POST /api/v1/approvals/{id}/analytics-website analytics:execute analytics.manage
analytics_page_prepare Request approval: Approve an analytics page POST /api/v1/approvals/analytics-page analytics:execute analytics.manage
analytics_page Approve an analytics page POST /api/v1/approvals/{id}/analytics-page analytics:execute analytics.manage
analytics_campaign_prepare Request approval: Add an analytics campaign POST /api/v1/approvals/analytics-campaign analytics:execute analytics.manage
analytics_campaign Add an analytics campaign POST /api/v1/approvals/{id}/analytics-campaign analytics:execute analytics.manage
analytics_export_prepare Request approval: Export analytics POST /api/v1/approvals/analytics-export analytics:execute analytics.view
analytics_export Export analytics POST /api/v1/approvals/{id}/analytics-export analytics:execute analytics.view

Reports

Tool What it does HTTP Grant Permission
reports_money Read the money overview GET /api/v1/reports/money reports:read financial_summary.view
reports_aging Read the aging report GET /api/v1/reports/aging reports:read data.export
reports_tax Read the tax report GET /api/v1/reports/tax reports:read data.export
reports_customer_statement Read a customer statement GET /api/v1/reports/customer-statement reports:read data.export
reports_overview Read the reports overview GET /api/v1/reports/overview reports:read data.export
reports_business Read the business view GET /api/v1/reports/business reports:read financial_summary.view
reports_tax_export_prepare Request approval: Export the tax report POST /api/v1/approvals/reports-tax-export reports:execute data.export
reports_tax_export Export the tax report POST /api/v1/approvals/{id}/reports-tax-export reports:execute data.export
reports_aging_export_prepare Request approval: Export the aging report POST /api/v1/approvals/reports-aging-export reports:execute data.export
reports_aging_export Export the aging report POST /api/v1/approvals/{id}/reports-aging-export reports:execute data.export
reports_statement_export_prepare Request approval: Export a customer statement POST /api/v1/approvals/reports-statement-export reports:execute data.export
reports_statement_export Export a customer statement POST /api/v1/approvals/{id}/reports-statement-export reports:execute data.export
reports_invoices_export_prepare Request approval: Export invoices POST /api/v1/approvals/reports-invoices-export reports:execute data.export
reports_invoices_export Export invoices POST /api/v1/approvals/{id}/reports-invoices-export reports:execute data.export
reports_money_export_prepare Request approval: Export the Money overview POST /api/v1/approvals/reports-money-export reports:execute data.export
reports_money_export Export the Money overview POST /api/v1/approvals/{id}/reports-money-export reports:execute data.export

Files

Tool What it does HTTP Grant Permission
files_list List files and folders GET /api/v1/files files:read files.view
files_get Read a file’s details GET /api/v1/files/{id} files:read files.view
files_read_text Read a text file GET /api/v1/files/{id}/text files:read files.view
files_prepare_text_version Prepare a new text version POST /api/v1/files/{id}/text/prepare files:prepare files.manage
files_download Download a file GET /api/v1/files/{id}/download files:read files.view
files_thumbnail Get a file preview image GET /api/v1/files/{id}/thumbnail files:read files.view
files_share_preview Read a share link GET /api/v1/files/shares/preview files:read files.view
files_proposal Read a text proposal GET /api/v1/files/{id}/proposal files:read files.view
files_upload_prepare Start a file upload POST /api/v1/files/uploads files:prepare files.manage
files_upload Create a file from an upload POST /api/v1/files files:prepare files.manage
files_add_version Add a file version POST /api/v1/files/{id}/versions files:prepare files.manage
files_rename Rename a file POST /api/v1/files/{id}/name files:prepare files.manage
files_move Move a file POST /api/v1/files/{id}/folder files:prepare files.manage
files_delete Delete a file POST /api/v1/files/{id}/delete files:prepare files.manage
files_restore Restore a file POST /api/v1/files/{id}/restore files:prepare files.manage
files_restore_version Restore a file version POST /api/v1/files/{id}/versions/restore files:prepare files.manage
files_attach Attach a file to a record POST /api/v1/files/{id}/attachments files:prepare files.manage
files_detach Remove a file from a record POST /api/v1/files/{id}/attachments/remove files:prepare files.manage
files_selection Change several files at once POST /api/v1/files/selection files:prepare files.manage
files_revoke_share Turn off a share link POST /api/v1/files/{id}/shares/revoke files:prepare files.share
folders_create Create a folder POST /api/v1/folders files:prepare files.manage
folders_rename Rename a folder POST /api/v1/folders/{id}/name files:prepare files.manage
folders_move Move a folder POST /api/v1/folders/{id}/parent files:prepare files.manage
folders_delete Delete a folder POST /api/v1/folders/{id}/delete files:prepare files.manage
folders_restore Restore a folder POST /api/v1/folders/{id}/restore files:prepare files.manage
files_share_prepare Request approval: Make a share link POST /api/v1/approvals/files-share/{id} files:execute files.share
files_share Make a share link POST /api/v1/approvals/{id}/files-share files:execute files.share

People

Tool What it does HTTP Grant Permission
people_list List colleagues GET /api/v1/people people:read people.view
people_get Read a colleague GET /api/v1/people/{id} people:read people.view
teams_list List teams GET /api/v1/teams people:read people.view
people_update Change a person’s details POST /api/v1/people/{id} people:prepare people.view
people_photo_prepare Start a profile photo upload POST /api/v1/people/photos people:prepare people.view
people_photo Set a profile photo POST /api/v1/people/{id}/photo people:prepare people.view
people_photo_read Download a profile photo GET /api/v1/people/{id}/photo people:read people.view
people_account Read a person’s account GET /api/v1/people/{id}/account people:read people.manage
people_offboard_preview Preview an offboarding GET /api/v1/people/{id}/offboard people:read people.manage
profile_get Read your profile GET /api/v1/profile people:read Any connection
profile_update Change your display name POST /api/v1/profile people:prepare Any connection
desks_list Choose a desk GET /api/v1/desks people:read people.view
desks_start_set Start in :desk next time POST /api/v1/desks/start people:prepare people.view
people_invite_prepare Request approval: Invite a person POST /api/v1/approvals/people-invite people:execute people.manage
people_invite Invite a person POST /api/v1/approvals/{id}/people-invite people:execute people.manage
people_invitation_resend_prepare Request approval: Resend an invitation POST /api/v1/approvals/people-invitation-resend/{id} people:execute people.manage
people_invitation_resend Resend an invitation POST /api/v1/approvals/{id}/people-invitation-resend people:execute people.manage
people_invitation_revoke_prepare Request approval: Revoke an invitation POST /api/v1/approvals/people-invitation-revoke/{id} people:execute people.manage
people_invitation_revoke Revoke an invitation POST /api/v1/approvals/{id}/people-invitation-revoke people:execute people.manage
people_role_prepare Request approval: Change a person’s role POST /api/v1/approvals/people-role/{id} people:execute people.manage
people_role Change a person’s role POST /api/v1/approvals/{id}/people-role people:execute people.manage
people_guest_scope_prepare Request approval: Change a guest’s access POST /api/v1/approvals/people-guest-scope/{id} people:execute people.manage
people_guest_scope Change a guest’s access POST /api/v1/approvals/{id}/people-guest-scope people:execute people.manage
people_deactivate_prepare Request approval: Deactivate a person POST /api/v1/approvals/people-deactivate/{id} people:execute people.manage
people_deactivate Deactivate a person POST /api/v1/approvals/{id}/people-deactivate people:execute people.manage
people_reactivate_prepare Request approval: Reactivate a person POST /api/v1/approvals/people-reactivate/{id} people:execute people.manage
people_reactivate Reactivate a person POST /api/v1/approvals/{id}/people-reactivate people:execute people.manage
people_offboard_prepare Request approval: Offboard a person POST /api/v1/approvals/people-offboard/{id} people:execute people.manage
people_offboard Offboard a person POST /api/v1/approvals/{id}/people-offboard people:execute people.manage
people_delete_prepare Request approval: Delete a person POST /api/v1/approvals/people-delete/{id} people:execute people.manage
people_delete Delete a person POST /api/v1/approvals/{id}/people-delete people:execute people.manage
teams_save_prepare Request approval: Save a team POST /api/v1/approvals/teams-save people:execute people.manage
teams_save Save a team POST /api/v1/approvals/{id}/teams-save people:execute people.manage
teams_archive_prepare Request approval: Archive or restore a team POST /api/v1/approvals/teams-archive/{id} people:execute people.manage
teams_archive Archive or restore a team POST /api/v1/approvals/{id}/teams-archive people:execute people.manage
people_rate_prepare Request approval: Set a person’s rate POST /api/v1/approvals/people-rate/{id} people:execute people.manage
people_rate Set a person’s rate POST /api/v1/approvals/{id}/people-rate people:execute people.manage
people_time_off_prepare Request approval: Record time off POST /api/v1/approvals/people-time-off/{id} people:execute people.manage
people_time_off Record time off POST /api/v1/approvals/{id}/people-time-off people:execute people.manage
people_time_off_remove_prepare Request approval: Remove time off POST /api/v1/approvals/people-time-off-remove/{id} people:execute people.manage
people_time_off_remove Remove time off POST /api/v1/approvals/{id}/people-time-off-remove people:execute people.manage
people_desks_prepare Request approval: Assign a person’s desks POST /api/v1/approvals/people-desks/{id} people:execute people.manage
people_desks Assign a person’s desks POST /api/v1/approvals/{id}/people-desks people:execute people.manage

Collaboration

Tool What it does HTTP Grant Permission
comments_list Read the comments of a record GET /api/v1/comments collaboration:read collaboration.use
notifications_list Read the inbox GET /api/v1/notifications collaboration:read collaboration.use
comments_create Write a comment POST /api/v1/comments collaboration:prepare collaboration.use
comments_edit Edit a comment POST /api/v1/comments/{id} collaboration:prepare collaboration.use
comments_remove Remove a comment POST /api/v1/comments/{id}/remove collaboration:prepare collaboration.use
notifications_unread Count unread notifications GET /api/v1/notifications/unread collaboration:read collaboration.use
notifications_mark Mark a notification read or unread POST /api/v1/notifications/{id}/read collaboration:prepare collaboration.use
notifications_mark_all Mark all notifications read POST /api/v1/notifications/read-all collaboration:prepare collaboration.use
notifications_preferences Read notification choices GET /api/v1/notifications/preferences collaboration:read collaboration.use
notifications_preferences_set Change notification choices POST /api/v1/notifications/preferences collaboration:prepare collaboration.use
activity_list Read record activity GET /api/v1/activity collaboration:read collaboration.use
presence_settings Set online status choices POST /api/v1/presence/settings collaboration:prepare collaboration.use

Forms

Tool What it does HTTP Grant Permission
forms_get Read a form GET /api/v1/forms/{id} forms:read forms.use
fields_schema Read custom field definitions GET /api/v1/custom-fields forms:read forms.use
fields_get Read a record’s custom fields GET /api/v1/custom-fields/{id} forms:read forms.use
fields_merge Fill merge fields POST /api/v1/custom-fields/{id}/merge forms:read forms.use
forms_prepare Prepare form input POST /api/v1/forms/prepare forms:prepare forms.use
forms_submit Submit a form POST /api/v1/forms/{id}/submit forms:prepare forms.use
fields_definitions List custom fields to edit GET /api/v1/custom-fields/definitions forms:read forms.manage
fields_define Save a custom field POST /api/v1/custom-fields/define forms:prepare forms.manage
fields_retire Retire a custom field POST /api/v1/custom-fields/{id}/retire forms:prepare forms.manage
fields_set Set custom field values POST /api/v1/custom-fields/{id}/values forms:prepare forms.use
widgets_preview Preview a widget definition POST /api/v1/widgets/preview forms:read forms.manage
widgets_preview_links Read widget links GET /api/v1/widgets/{id}/links forms:read customers.manage or forms.manage
widgets_preview_read Read a widget preview GET /api/v1/widgets/{id}/preview forms:read customers.manage or forms.manage
widgets_sample Read the widget sample page GET /api/v1/widgets/sample forms:read forms.manage
widgets_placement_print Download a placement QR code GET /api/v1/widgets/{id}/placements/{placement_id}/print forms:read customers.manage or forms.manage
widgets_response_file Download a response file GET /api/v1/widgets/{id}/responses/{response_id}/files/{file_id} forms:read customers.manage or forms.manage
widgets_invitation_revoke Revoke a response request POST /api/v1/widgets/{id}/invitations/{invitation_id}/revoke forms:prepare customers.manage or forms.manage
widgets_get Read a widget configuration GET /api/v1/widgets/{id} forms:read forms.manage or people.view or people.manage or items.manage or offers.manage or listings.manage or settings.manage or customers.manage or files.manage or content.manage
widgets_prepare Prepare a widget configuration POST /api/v1/widgets/prepare forms:prepare forms.manage or people.view or people.manage or items.manage or offers.manage or listings.manage or settings.manage or customers.manage or files.manage or content.manage
widgets_placements_get Read a widget placement GET /api/v1/widget-placements/{id} forms:read forms.manage or people.view or people.manage or items.manage or offers.manage or listings.manage or settings.manage or customers.manage or files.manage or content.manage
widgets_placements_prepare Prepare a widget placement POST /api/v1/widget-placements/prepare forms:prepare forms.manage or people.view or people.manage or items.manage or offers.manage or listings.manage or settings.manage or customers.manage or files.manage or content.manage
widgets_requests_get Read an assigned widget request GET /api/v1/widget-requests/{id} forms:read crm.use or crm.manage or people.view or items.manage or listings.manage or content.manage
widgets_list List widgets GET /api/v1/widgets forms:read forms.manage or people.view or people.manage or items.manage or offers.manage or listings.manage or settings.manage or customers.manage or files.manage or content.manage
widgets_requests_list List widget requests GET /api/v1/widget-requests forms:read crm.use or crm.manage or people.view or items.manage or listings.manage or content.manage
locations_get Read business locations GET /api/v1/locations forms:read settings.manage
locations_prepare Prepare a location POST /api/v1/locations/prepare forms:prepare settings.manage
widgets_responses_get Read a customer answer GET /api/v1/widget-responses/{id} forms:read customers.manage or forms.manage
widgets_responses_report Read response report GET /api/v1/widgets/{id}/responses forms:read customers.manage or forms.manage
widgets_invitations_prepare Prepare a customer request POST /api/v1/widget-invitations/prepare forms:prepare customers.manage or forms.manage
views_widget_response View widget responses GET /api/v1/views/widget_response forms:read forms.use
views_form View forms GET /api/v1/views/form forms:read forms.use
views_form_record View form records GET /api/v1/views/form_record forms:read forms.use
views_form_submission View form submissions GET /api/v1/views/form_submission forms:read forms.use
views_form_submission_bulk Change many form submissions POST /api/v1/views/form_submission/bulk forms:prepare forms.use
widgets_publish_prepare Request approval: Publish or withdraw a widget POST /api/v1/approvals/widgets-publish/{id} forms:execute forms.manage
widgets_publish Publish or withdraw a widget POST /api/v1/approvals/{id}/widgets-publish forms:execute forms.manage
widgets_placement_close_prepare Request approval: Close a placement POST /api/v1/approvals/widgets-placement-close/{id} forms:execute forms.manage
widgets_placement_close Close a placement POST /api/v1/approvals/{id}/widgets-placement-close forms:execute forms.manage
forms_publish_prepare Request approval: Publish or withdraw a form POST /api/v1/approvals/forms-publish/{id} forms:execute forms.manage
forms_publish Publish or withdraw a form POST /api/v1/approvals/{id}/forms-publish forms:execute forms.manage
widgets_request_send_prepare Request approval: Send a response request POST /api/v1/approvals/widgets-request-send/{id} forms:execute forms.manage
widgets_request_send Send a response request POST /api/v1/approvals/{id}/widgets-request-send forms:execute forms.manage
widgets_testimonial_moderate_prepare Request approval: Show or hide a testimonial POST /api/v1/approvals/widgets-testimonial-moderate/{id} forms:execute forms.manage
widgets_testimonial_moderate Show or hide a testimonial POST /api/v1/approvals/{id}/widgets-testimonial-moderate forms:execute forms.manage
forms_submissions_export_prepare Request approval: Export form submissions POST /api/v1/approvals/forms-submissions-export forms:execute forms.manage
forms_submissions_export Export form submissions POST /api/v1/approvals/{id}/forms-submissions-export forms:execute forms.manage

Settings

Tool What it does HTTP Grant Permission
desks_settings Desks GET /api/v1/desks/settings settings:read settings.manage
context_get Read your context GET /api/v1/context settings:read Any connection
records_search Search records GET /api/v1/records/search settings:read Any connection
tags_list List tags GET /api/v1/tags settings:read Any connection
settings_read Read company settings GET /api/v1/settings/safe settings:read settings.manage
audit_retention Read the audit retention GET /api/v1/audit/retention settings:read audit_log.view
audit_verify Verify the audit chain GET /api/v1/audit/verify settings:read audit_log.view
installation_health_refresh Check installation health again GET /api/v1/installation/health/refresh settings:read settings.manage
installation_update Read the update status GET /api/v1/installation/update settings:read settings.manage
backups_list List backups GET /api/v1/backups settings:read settings.manage
modules_list List modules GET /api/v1/modules settings:read settings.manage
settings_email_templates Read email templates GET /api/v1/settings/email-templates settings:read settings.manage
settings_bank_accounts Read bank accounts GET /api/v1/settings/bank-accounts settings:read settings.manage
settings_roles Read roles GET /api/v1/settings/roles settings:read users.manage
settings_intelligence Read intelligence settings GET /api/v1/settings/intelligence settings:read settings.manage
workspaces_plans List workspace plans GET /api/v1/workspaces/plans settings:read settings.manage
workspaces_plan Read a workspace plan GET /api/v1/workspaces/plans/{id} settings:read settings.manage
workspaces_plan_choices Find workspace plans GET /api/v1/workspaces/plan-choices settings:read settings.manage
records_recent Read recent records GET /api/v1/records/recent settings:read Any connection
records_tab_counts Count records per tab GET /api/v1/records/tab-counts settings:read Any connection
pins_list List pinned records GET /api/v1/pins settings:read Any connection
pins_toggle Pin or unpin a record POST /api/v1/pins settings:prepare Any connection
pins_remove Remove a pin POST /api/v1/pins/{id}/remove settings:prepare Any connection
views_saved_list List saved views GET /api/v1/views/saved settings:read Any connection
views_saved_save Save a view POST /api/v1/views/saved settings:prepare Any connection
views_saved_update Change a saved view POST /api/v1/views/saved/{id} settings:prepare Any connection
views_saved_delete Delete a saved view POST /api/v1/views/saved/{id}/delete settings:prepare Any connection
audit_list List audit events GET /api/v1/audit/events settings:read audit_log.view or audit_log.view_own
audit_get Read an audit event GET /api/v1/audit/events/{id} settings:read audit_log.view or audit_log.view_own
audit_integrity Check audit history integrity GET /api/v1/audit/integrity settings:read audit_log.view
installation_health Read installation health GET /api/v1/installation/health settings:read settings.manage
settings_save_prepare Request approval: Change settings POST /api/v1/approvals/settings-save settings:execute settings.manage
settings_save Change settings POST /api/v1/approvals/{id}/settings-save settings:execute settings.manage
settings_reset_prepare Request approval: Reset a settings section POST /api/v1/approvals/settings-reset settings:execute settings.manage
settings_reset Reset a settings section POST /api/v1/approvals/{id}/settings-reset settings:execute settings.manage
settings_number_sequence_prepare Request approval: Change a number sequence POST /api/v1/approvals/settings-number-sequence/{id} settings:execute settings.manage
settings_number_sequence Change a number sequence POST /api/v1/approvals/{id}/settings-number-sequence settings:execute settings.manage
settings_role_save_prepare Request approval: Save a role POST /api/v1/approvals/settings-role-save settings:execute users.manage
settings_role_save Save a role POST /api/v1/approvals/{id}/settings-role-save settings:execute users.manage
settings_role_delete_prepare Request approval: Delete a role POST /api/v1/approvals/settings-role-delete/{id} settings:execute users.manage
settings_role_delete Delete a role POST /api/v1/approvals/{id}/settings-role-delete settings:execute users.manage
settings_tax_create_prepare Request approval: Add a tax rate POST /api/v1/approvals/settings-tax-create settings:execute settings.manage
settings_tax_create Add a tax rate POST /api/v1/approvals/{id}/settings-tax-create settings:execute settings.manage
settings_tax_update_prepare Request approval: Change a tax rate POST /api/v1/approvals/settings-tax-update/{id} settings:execute settings.manage
settings_tax_update Change a tax rate POST /api/v1/approvals/{id}/settings-tax-update settings:execute settings.manage
settings_tax_reorder_prepare Request approval: Move a tax rate POST /api/v1/approvals/settings-tax-reorder/{id} settings:execute settings.manage
settings_tax_reorder Move a tax rate POST /api/v1/approvals/{id}/settings-tax-reorder settings:execute settings.manage
settings_tax_delete_prepare Request approval: Delete a tax rate POST /api/v1/approvals/settings-tax-delete/{id} settings:execute settings.manage
settings_tax_delete Delete a tax rate POST /api/v1/approvals/{id}/settings-tax-delete settings:execute settings.manage
settings_item_category_create_prepare Request approval: Add an item category POST /api/v1/approvals/settings-item-category-create settings:execute settings.manage
settings_item_category_create Add an item category POST /api/v1/approvals/{id}/settings-item-category-create settings:execute settings.manage
settings_item_category_update_prepare Request approval: Change an item category POST /api/v1/approvals/settings-item-category-update/{id} settings:execute settings.manage
settings_item_category_update Change an item category POST /api/v1/approvals/{id}/settings-item-category-update settings:execute settings.manage
settings_email_template_prepare Request approval: Change an email template POST /api/v1/approvals/settings-email-template/{id} settings:execute settings.manage
settings_email_template Change an email template POST /api/v1/approvals/{id}/settings-email-template settings:execute settings.manage
settings_email_template_reset_prepare Request approval: Reset an email template POST /api/v1/approvals/settings-email-template-reset/{id} settings:execute settings.manage
settings_email_template_reset Reset an email template POST /api/v1/approvals/{id}/settings-email-template-reset settings:execute settings.manage
settings_bank_create_prepare Request approval: Add a bank account POST /api/v1/approvals/settings-bank-create settings:execute settings.manage
settings_bank_create Add a bank account POST /api/v1/approvals/{id}/settings-bank-create settings:execute settings.manage
settings_bank_update_prepare Request approval: Change a bank account POST /api/v1/approvals/settings-bank-update/{id} settings:execute settings.manage
settings_bank_update Change a bank account POST /api/v1/approvals/{id}/settings-bank-update settings:execute settings.manage
backups_create_prepare Request approval: Make a backup POST /api/v1/approvals/backups-create settings:execute settings.manage
backups_create Make a backup POST /api/v1/approvals/{id}/backups-create settings:execute settings.manage
backups_delete_prepare Request approval: Delete a backup POST /api/v1/approvals/backups-delete settings:execute settings.manage
backups_delete Delete a backup POST /api/v1/approvals/{id}/backups-delete settings:execute settings.manage
backups_schedule_prepare Request approval: Set the backup schedule POST /api/v1/approvals/backups-schedule settings:execute settings.manage
backups_schedule Set the backup schedule POST /api/v1/approvals/{id}/backups-schedule settings:execute settings.manage
intelligence_save_prepare Request approval: Change the AI suggestion settings POST /api/v1/approvals/intelligence-save settings:execute settings.manage
intelligence_save Change the AI suggestion settings POST /api/v1/approvals/{id}/intelligence-save settings:execute settings.manage
intelligence_test_prepare Request approval: Test the AI provider connection POST /api/v1/approvals/intelligence-test settings:execute settings.manage
intelligence_test Test the AI provider connection POST /api/v1/approvals/{id}/intelligence-test settings:execute settings.manage
workspaces_plan_save_prepare Request approval: Save a workspace plan POST /api/v1/approvals/workspaces-plan-save settings:execute settings.manage
workspaces_plan_save Save a workspace plan POST /api/v1/approvals/{id}/workspaces-plan-save settings:execute settings.manage
audit_export_prepare Request approval: Export the audit trail POST /api/v1/approvals/audit-export settings:execute settings.manage
audit_export Export the audit trail POST /api/v1/approvals/{id}/audit-export settings:execute settings.manage
audit_retention_save_prepare Request approval: Change the audit retention POST /api/v1/approvals/audit-retention-save settings:execute settings.manage
audit_retention_save Change the audit retention POST /api/v1/approvals/{id}/audit-retention-save settings:execute settings.manage
audit_prune_prepare Request approval: Remove expired audit events POST /api/v1/approvals/audit-prune settings:execute settings.manage
audit_prune Remove expired audit events POST /api/v1/approvals/{id}/audit-prune settings:execute settings.manage
audit_subject_report_prepare Request approval: Make a personal-data report POST /api/v1/approvals/audit-subject-report settings:execute settings.manage
audit_subject_report Make a personal-data report POST /api/v1/approvals/{id}/audit-subject-report settings:execute settings.manage
audit_subject_erase_prepare Request approval: Erase personal data POST /api/v1/approvals/audit-subject-erase settings:execute settings.manage
audit_subject_erase Erase personal data POST /api/v1/approvals/{id}/audit-subject-erase settings:execute settings.manage
desks_update_prepare Request approval: Arrange a desk POST /api/v1/approvals/desks-update/{id} settings:execute settings.manage
desks_update Arrange a desk POST /api/v1/approvals/{id}/desks-update settings:execute settings.manage

Need help with the product?

Contact support