View as Markdown
On this page

Admin tools

Only owners and admins get these tools. Members do not see them. For how to use them, see Manage Ototo from your assistant.

Tool What it does Changes data
ototo_list_organizations List the organizations that you manage as owner or admin. No
ototo_list_people List the people, their roles, the access level of each person on each company, and the pending invitations. No
ototo_list_companies List the connected companies, their status, and if writes and deletes are allowed. No
ototo_activity Get an activity report: tool use by person and company, and the changes that people made. No
ototo_billing_status Show the trial or subscription status and the monthly charges. No
ototo_payment_link Get a Stripe link to add or manage a payment method. No. Changes occur on the Stripe page only.
ototo_invite_person Invite a person by email, with a role and an access level. Yes, after you confirm
ototo_set_access Set the access level of a person on one company or on all companies. Yes, after you confirm
ototo_set_role Make a person an admin or a member. Yes, after you confirm
ototo_remove_person Remove a person from the organization. Their access stops immediately. Yes, after you confirm

Parameters#

All tools have the parameter organization: the name or ID of the organization. You must give it only if you manage more than one organization.

The tools that change data also have the parameter confirmation. The assistant leaves it empty to get a preview. Then it sends the code from the preview.

ototo_invite_person#

  • email: the email address of the person.
  • role: member or admin. The default is member.
  • access: none, read, bookkeeper or full. The default is the starting access of the organization.

ototo_set_access#

  • person: the email address (best) or the name of the person.
  • access: none, read, bookkeeper or full.
  • company: the name or ID of a company, or all.

The level replaces the custom settings of the person on those companies.

ototo_set_role#

  • person: the email address (best) or the name of the person.
  • role: admin or member.

ototo_remove_person#

  • person: the email address (best) or the name of the person.

You cannot remove yourself with this tool. To leave an organization, use the web app.

ototo_activity#

This tool only reads. It never returns tool arguments, tool results or accounting data.

  • person: an email address or a name. The report shows the activity of the person and the changes made to them.
  • company: the name or ID of a company.
  • kind: all, tools, changes or sign_ins. The default is all.
    • tools: tool use from assistants.
    • changes: changes to access, roles, names, invitations, companies and company policy.
    • sign_ins: sign-ins to the web app and connections from assistants.
  • since: the start date, for example 2026-11-01. The default is 30 days before today.
  • until: the end date. The report does not include this date. The default is now.
  • failed_only: if true, the report shows only the events that failed.
  • view: summary or events. The default is summary. A summary gives counts. events gives the list of events, with the newest first.
  • limit: the number of events for events. The default is 50. The maximum is 200.

Access levels in the tools#

Value Level
none No access
read Read only
bookkeeper Bookkeeper
full Full access