Agent Tools & Actions

Agents interact with SuiteOp through a set of tools. Each tool maps to a specific operation — listing tasks, adjusting a thermostat, creating a reservation, and so on. You control which tools an agent can use and whether each tool requires human approval.

Permission Modes

Every tool on an agent has one of three permission modes:

Mode	What Happens
Auto	The agent executes the action immediately. It is logged in the action log but does not require approval.
Ask	The agent proposes the action with its arguments. A human must approve or reject it from the Actions tab before it executes.
Disabled	The agent cannot use this tool. It will not appear in the agent’s available tools.

Note

Query tools (read-only operations like listing tasks or viewing a property) are safe to set to Auto. Mutation tools (actions that change data) should typically start in Ask mode until you are confident in the agent’s behavior, then selectively promote to Auto.

Available Tools

Search

Tool	Type	Description
search	Query	Fuzzy search across all entity types by name or keyword

Tasks

Tool	Type	Description
listDepartments	Query	List departments in the organization
listTasks	Query	List tasks with filters for status, priority, property, assignee, and due date
getTask	Query	Get full details for a single task
createTask	Mutation	Create a new task with a name, department, and property
updateTaskStatus	Mutation	Update a task’s status (pending, in progress, completed, or cancelled)
deleteTask	Mutation	Soft-delete a task

Properties

Tool	Type	Description
listProperties	Query	List properties with filters for status, name, group, and tags
getProperty	Query	Get full details for a property
updateProperty	Mutation	Update property fields (name, address, capacity, WiFi, codes, flags)
updatePropertyStatus	Mutation	Update a property status field (readiness, cleaning, inspection, or maintenance)
listPropertyGroups	Query	List property groups (portfolios/collections)
getPropertyGroup	Query	Get a property group by ID

Reservations

Tool	Type	Description
listReservations	Query	List reservations with filters for status, check-in state, property, and date range
getReservation	Query	Get full details for a reservation
createReservation	Mutation	Create a manual reservation
updateReservation	Mutation	Update reservation fields (dates, guest info, amounts)
cancelReservation	Mutation	Cancel a reservation
updateCheckInState	Mutation	Update a reservation’s check-in state

Devices

Tool	Type	Description
listDevices	Query	List smart devices with filters for type, provider, property, and status
getDevice	Query	Get full details for a device
lockDevice	Mutation	Lock a smart lock
unlockDevice	Mutation	Unlock a smart lock
setDeviceTemperature	Mutation	Set a thermostat’s target temperature
setDeviceMode	Mutation	Set a thermostat’s mode (heat, cool, heat_cool, off)
refreshDeviceStatus	Query	Poll a device for its current status

Access Codes

Tool	Type	Description
listCodes	Query	List access codes with filters for device, property, or status
getCode	Query	Get a single access code with full details
createCode	Mutation	Create a new access code on a device
updateCode	Mutation	Update an access code (PIN, slot name, or time window)
deleteCode	Mutation	Delete an access code

Team Members

Tool	Type	Description
listTeamMembers	Query	List team members with filters for role, status, name, department, and property group
getMember	Query	Get full details for a team member
inviteMember	Mutation	Invite a new team member by email
updateMemberRole	Mutation	Change a team member’s role
suspendMember	Mutation	Deactivate a team member

Organization

Tool	Type	Description
getOrganization	Query	Get the current organization’s settings
getMyProfile	Query	Get the agent’s own profile

Memory

Tool	Type	Description
save_memory	Mutation	Save a new memory at a given scope
recall_memories	Query	Recall memories relevant to the current context
update_memory	Mutation	Update an existing memory (creates a new version)
delete_memory	Mutation	Soft-delete a memory

Scheduling

Tool	Type	Description
schedule_follow_up	Query	Schedule a follow-up check after a delay (1 to 1,440 minutes)

Action Approval Workflow

When an agent uses a tool set to Ask mode:

1. The agent proposes the action with its arguments
2. The action appears in the Actions tab with a status of Pending
3. You can review the tool name, arguments, and the session context
4. Click Approve to execute the action, or Reject to discard it

Caution

Pending actions do not expire automatically. Review them regularly to avoid a backlog of unprocessed agent proposals.

Action Log

Every action taken by an agent is recorded in the action log, regardless of permission mode. Each entry includes:

• The tool name and arguments
• Whether it was auto-executed or required approval
• Who approved or rejected it (for “ask” mode actions)
• The tool’s result or error
• The timestamp of execution

You can filter the action log by agent, tool name, approval status, and date range.