Admin Tools
6 tools for managing workspace users, roles, permissions, and compliance audit logs.
Admin Scope Required
All admin tools require the
admin:write scope. Only workspace owners and users with the Admin role can access these tools.frontdesk_list_users
List all users in the workspace with their roles and status.
POST
tools/frontdesk_list_users| Parameter | Type | Description |
|---|---|---|
role | string | Filter by role: owner, admin, staff, viewer. |
status | string | Filter by status: active, invited, deactivated.Default: active |
Response
200 OK
{
"users": [
{
"id": "user_01",
"name": "Dr. Sarah Johnson",
"email": "sarah@riverside-dental.com",
"role": "owner",
"status": "active",
"last_active": "2025-01-15T16:30:00Z"
},
{
"id": "user_02",
"name": "Michael Chen",
"email": "michael@riverside-dental.com",
"role": "staff",
"status": "active",
"last_active": "2025-01-15T15:45:00Z"
}
],
"total": 2
}frontdesk_invite_user
Invite a new user to the workspace. An invitation email is sent with a link to set up their account.
POST
tools/frontdesk_invite_user| Parameter | Type | Description |
|---|---|---|
emailrequired | string | Email address to invite. |
namerequired | string | Name of the user. |
rolerequired | string | Role to assign: admin, staff, viewer. |
frontdesk_audit_log
Access the workspace audit log for compliance tracking. Records all significant actions including configuration changes, user management, and data access.
POST
tools/frontdesk_audit_log| Parameter | Type | Description |
|---|---|---|
date_from | string | Start of date range. |
date_to | string | End of date range. |
actor_id | string | Filter by user who performed the action. |
action_type | string | Filter by action type: config_change, user_management, data_access. |
limit | number | Max results.Default: 50 |
Response
200 OK
{
"events": [
{
"id": "evt_01",
"action": "config_change",
"actor": { "id": "user_01", "name": "Dr. Sarah Johnson" },
"details": "Updated business hours for Saturday",
"timestamp": "2025-01-15T10:00:00Z",
"ip_address": "198.51.100.42"
},
{
"id": "evt_02",
"action": "user_management",
"actor": { "id": "user_01", "name": "Dr. Sarah Johnson" },
"details": "Invited michael@riverside-dental.com with role: staff",
"timestamp": "2025-01-14T09:30:00Z",
"ip_address": "198.51.100.42"
}
],
"total": 2,
"has_more": false
}frontdesk_update_user_role
Change a user's role or deactivate their account. Role changes take effect immediately.
POST
tools/frontdesk_update_user_role| Parameter | Type | Description |
|---|---|---|
user_idrequired | string | The user to update. |
role | string | New role: admin, staff, viewer. |
status | string | New status: active, deactivated. |