Tools: Users

listUsers

🔍 Read-only

List all users for the organization.

Parameters: {
  "organization_id": "org_xxx",
  "size": 50,
  "cursor": "optional_cursor"
}

Supports: Pagination, filtering Returns: Array of users with roles and contact information, next_cursor for pagination

Example:
AI: "List all team members in my organization"
    [Uses listUsers tool]

getUser

🔍 Read-only

Get a user by ID (profile ID).

Parameters: {
  "organization_id": "org_xxx",
  "user_id": "user_xxx"
}

Returns: Full user details including role, department, and access permissions

Example:
AI: "Get details for user user_abc123"
    [Uses getUser tool]

createUser

✏️ Write

Create a new user in the organization.

Parameters: {
  "organization_id": "org_xxx",
  "email": "user@example.com",
  "full_name": "John Doe"
}

Returns: Created user object with generated ID

Example:
AI: "Create user john.doe@example.com in the organization"
    [Uses createUser tool]

inviteUser

✏️ Write

Invite a user (profile) to the organization.

Parameters: {
  "organization_id": "org_xxx",
  "email": "user@example.com"
}

Returns: Invitation object

Example:
AI: "Invite john.doe@example.com to the organization"
    [Uses inviteUser tool]

updateUser

✏️ Write

Update an existing user (profile).

Parameters: {
  "organization_id": "org_xxx",
  "user_id": "user_xxx",
  "full_name": "John Doe Updated"
}

Returns: Updated user object

Example:
AI: "Update user user_abc123 full name"
    [Uses updateUser tool]

updateMembership

✏️ Write

Update a membership role.

Parameters: {
  "organization_id": "org_xxx",
  "user_id": "user_xxx",
  "role": "ADMIN"
}

Returns: Updated membership object

Example:
AI: "Set user user_abc123 role to ADMIN"
    [Uses updateMembership tool]

removeUser

✏️ Write

Remove a user from the organization.

Parameters: {
  "organization_id": "org_xxx",
  "user_id": "user_xxx"
}

Returns: Confirmation of removal

Example:
AI: "Remove user user_abc123 from the organization"
    [Uses removeUser tool]