# Egnyte

Egnyte is a cloud-based content collaboration platform that enables secure file sharing, storage, and governance for businesses.

- **Category:** file management & storage
- **Auth:** OAUTH2
- **Composio Managed App Available?** No
- **Tools:** 60
- **Triggers:** 0
- **Slug:** `EGNYTE`
- **Version:** 20260312_00

## Tools

### Create Permissions Audit Report

**Slug:** `EGNYTE_CREATE_AUDIT_PERMISSIONS`

Tool to generate a permissions audit report for specified date range and filters. Use when you need to create an audit report for permissions changes and retrieve a report ID for async retrieval.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `format` | string ("json" | "csv") | Yes | Output format. Must be either 'json' or 'csv'. |
| `folders` | array | No | Folder paths to include in the report. |
| `date_end` | string | Yes | Final day the report should cover. Format: YYYY-MM-DD. |
| `assigners` | array | No | Users who assigned permissions to include in the report. |
| `date_start` | string | Yes | Initial day the report should cover. Format: YYYY-MM-DD. |
| `assignee_users` | array | No | Individual users to include in the report. |
| `assignee_groups` | array | No | Groups to include in the report. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create user audit report

**Slug:** `EGNYTE_CREATE_AUDIT_USERS`

Tool to create a user audit report in Egnyte. Use when you need to generate an audit report of user-related actions within a specific date range. The report is generated asynchronously - use the returned job ID to poll for completion.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `format` | string ("json" | "csv") | No | Enum for audit report format. |
| `subject` | array | No | Array of user email addresses to filter the audit report. Only actions related to these users will be included. If not specified, all users are included. |
| `date_end` | string | No | End date for the audit report in ISO 8601 format (YYYY-MM-DD). Example: '2026-02-12'. If not specified, the report will include data up to the current date. |
| `date_start` | string | No | Start date for the audit report in ISO 8601 format (YYYY-MM-DD). Example: '2026-01-01'. If not specified, the report will include all available historical data. |
| `action_type` | array | No | Array of user action types to filter the audit report. Supported actions include CREATE, PASSWORD_RESET, PASSWORD_CHANGE, UPDATE, DELETE, DISABLE, ENABLE, LOGIN, LOGOUT. If not specified, all action types are included. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Bookmark

**Slug:** `EGNYTE_CREATE_BOOKMARK`

Tool to create a bookmark on a folder using either path or folder_id. Use when you need to add a folder to user bookmarks for quick access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `path` | string | No | Full path to the folder to bookmark. Must start with '/' and reference an existing folder. Use this OR folder_id, not both. |
| `folder_id` | string | No | UUID of the folder to bookmark. Use this OR path, not both. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Comment

**Slug:** `EGNYTE_CREATE_COMMENT`

Tool to create a new comment/note on a file in Egnyte. Use when you need to add comments, notes, or feedback to a specific file.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | string | Yes | The comment text content to add to the file. Plain text or formatted content. |
| `path` | string | Yes | Full path to the file in Egnyte file system (e.g., '/Shared/Documents/test.txt'). Must include leading slash. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create File Audit Report

**Slug:** `EGNYTE_CREATE_FILE_AUDIT_REPORT`

Tool to generate a file activity audit report for specified date range and filters. Use when you need to track file operations like downloads, uploads, moves, deletes within a date range. Returns a job ID for async retrieval - poll the job status to check when report is ready.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `users` | array | No | Filter by specific usernames. Only file activities by these users will be included. If not specified, all users are included. |
| `format` | string ("json" | "csv") | Yes | Output format for the report. Must be either 'json' or 'csv'. |
| `folders` | array | No | Filter by specific folder paths. Only file activities in these folders will be included. Paths should be relative to the root. |
| `date_end` | string | Yes | End date for the report in YYYY-MM-DD format. The report will include file activities up to and including this date. |
| `date_start` | string | Yes | Start date for the report in YYYY-MM-DD format. The report will include file activities from this date onwards. |
| `transaction_type` | array | No | Filter by specific transaction types (download, preview, upload, delete, move, copy, rename). If not specified, all transaction types are included. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Group

**Slug:** `EGNYTE_CREATE_GROUP`

Tool to create a new group with display name and members. Use when you need to add a new group to the Egnyte domain. SCIM-compliant.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `members` | array | Yes | Array of member objects with user IDs. Each member is specified by their user ID. This is a required field. |
| `displayName` | string | Yes | Display name for the new group. This is a required field. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Shared Link

**Slug:** `EGNYTE_CREATE_LINK`

Tool to create a shared link for a file or folder with accessibility and expiration settings. Use when you need to share content with specific users, set password protection, configure expiration dates, or enable upload capabilities for recipients.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `path` | string | Yes | Absolute path to the file or folder to share (e.g., '/Shared/Documents/file.txt'). |
| `type` | string ("file" | "folder" | "upload") | Yes | Type of the link to create: 'file' for file links, 'folder' for folder links, or 'upload' for upload links that allow recipients to upload files. |
| `notify` | boolean | No | If true, sends email notifications to the creator when the link is accessed. |
| `copy_me` | boolean | No | If true, sends a copy of the notification email to the link creator. |
| `message` | string | No | Custom message to include in the email notification sent to recipients. |
| `recipients` | array | No | List of email addresses to share the link with. Required when accessibility is 'recipients'. |
| `send_email` | boolean | No | Whether to send email notifications to recipients when the link is created. Only applicable when recipients are specified. |
| `expiry_date` | string | No | Expiration date for the link in YYYY-MM-DD format (e.g., '2024-12-31'). After this date, the link will no longer be accessible. |
| `accessibility` | string ("anyone" | "password" | "domain" | "recipients") | Yes | Access level for the link: 'anyone' = public access, 'password' = password-protected, 'domain' = restricted to domain users, 'recipients' = restricted to specific email recipients. |
| `add_file_name` | boolean | No | If true, appends the filename to the download when the link is accessed. Useful for providing context to recipients. |
| `expiry_clicks` | integer | No | Maximum number of times the link can be accessed before it expires. Once the limit is reached, the link becomes inactive. |
| `link_to_current` | boolean | No | If true, the link always points to the current version of the file. If false, it points to the version at the time of link creation. Only applicable for file links. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Login Audit Report

**Slug:** `EGNYTE_CREATE_LOGIN_AUDIT_REPORT`

Tool to generate a login audit report for specified date range and filters. Use when you need to create an audit report for login activity and retrieve a report ID for async retrieval.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `users` | array | No | Filter by usernames. If not specified, all users are included. |
| `events` | array | No | Filter by event types (e.g., 'logins', 'failed_attempts'). If not specified, all event types are included. |
| `format` | string ("json" | "csv") | Yes | Output format. Must be either 'json' or 'csv'. |
| `date_end` | string | Yes | Final day the report should cover. Format: YYYY-MM-DD. |
| `date_start` | string | Yes | Initial day the report should cover. Format: YYYY-MM-DD. |
| `access_points` | array | No | Filter by access points (e.g., 'web', 'ftp', 'mobile'). If not specified, all access points are included. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create User

**Slug:** `EGNYTE_CREATE_USER`

Tool to create a new user in the Egnyte domain. Use when you need to add a new user account with specified authentication type and user type. SCIM-compliant endpoint.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | object | Yes | User's name information including first name and last name. |
| `role` | string | No | User's role in the organization. Optional. |
| `email` | string | Yes | Email address for the user. Must be a valid email format. |
| `active` | boolean | Yes | Whether the user account should be active (true) or inactive (false). |
| `authType` | string ("egnyte" | "sso" | "ad") | Yes | Authentication method: 'egnyte' (Egnyte native authentication), 'sso' (Single Sign-On), or 'ad' (Active Directory). |
| `userName` | string | Yes | Username for the new user. Must be unique within the domain. |
| `userType` | string ("admin" | "power" | "standard") | Yes | Type of user account: 'admin' (full administrative access), 'power' (advanced user with additional permissions), or 'standard' (regular user). |
| `externalId` | string | No | External identifier for the user (e.g., from Active Directory or another system). Optional. |
| `sendInvite` | boolean | No | Whether to send an invitation email to the user. Optional. Defaults to false if not specified. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Audit Report

**Slug:** `EGNYTE_DELETE_AUDIT_REPORT`

Tool to delete an audit report from Egnyte. Use when you need to remove a specific audit report by its type and ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique ID of the audit report to delete. |
| `type` | string ("logins" | "files" | "permissions" | "users" | "groups" | "workgroup-settings") | Yes | Type of audit report to delete. Must be one of: logins, files, permissions, users, groups, workgroup-settings. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Bookmark

**Slug:** `EGNYTE_DELETE_BOOKMARK`

Tool to delete a bookmark from the user's bookmarks. Use when you need to remove a specific bookmark by its ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `bookmark_id` | string | Yes | The unique identifier of the bookmark to delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete File By ID

**Slug:** `EGNYTE_DELETE_FILE_BY_ID`

Delete a file using persistent file ID. Can specify entry_id to delete specific version. Use when you need to delete a file by its persistent identifier (Group ID) rather than path.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `entry_id` | string | No | Optional entry ID to delete a specific version of the file. If not provided, the entire file is deleted. |
| `group_id` | string | Yes | Persistent file identifier (Group ID) of the file to delete. This is the unique identifier that persists across file moves and renames. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete file or folder

**Slug:** `EGNYTE_DELETE_FILE_OR_FOLDER`

Tool to delete a file or folder at the specified path. Items are moved to trash, not permanently deleted. Use when you need to remove a file or folder from the Egnyte file system.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `path` | string | Yes | Full path to the file or folder to delete (e.g., 'Shared/Documents/file.txt'). Each path element will be URL encoded automatically. |
| `entry_id` | string | No | Optional entry ID to delete a specific version of the file |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Group

**Slug:** `EGNYTE_DELETE_GROUP`

Tool to delete a group from the Egnyte domain. Use when you need to permanently remove a group. SCIM-compliant.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `group_id` | string | Yes | The unique identifier (UUID) of the group to delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Shared Link

**Slug:** `EGNYTE_DELETE_LINK`

Tool to delete a shared link by its ID. Use when you need to permanently remove a link. Once deleted, the link cannot be reactivated.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the link to delete. WARNING: Once deleted, the link cannot be reactivated. This action is permanent. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Metadata Key

**Slug:** `EGNYTE_DELETE_METADATA_KEY`

Tool to delete a metadata key from a namespace. Use force_delete=true to remove keys that are currently in use.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `key_name` | string | Yes | Name of the metadata key to delete from the namespace |
| `force_delete` | boolean | No | Set to true to force delete the key even if it is in use. If false and key is in use, deletion will fail. |
| `namespace_name` | string | Yes | Namespace identifier containing the metadata key to delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Metadata Namespace

**Slug:** `EGNYTE_DELETE_METADATA_NAMESPACE`

Tool to delete a metadata namespace. Use when you need to remove an unused namespace after confirming its name. Returns 403 error if the namespace is currently in use and cannot be deleted.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `namespace_name` | string | Yes | Namespace identifier to delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Note

**Slug:** `EGNYTE_DELETE_NOTE`

Tool to delete a note/comment in Egnyte by its UUID. Use when you need to remove a comment from a file or folder.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `uuid` | string | Yes | The unique identifier (UUID) of the note/comment to delete. Example: '2b42508b-5c8b-41ad-8f23-0d48ea97cbfd' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete User

**Slug:** `EGNYTE_DELETE_USER`

Tool to delete a user from the Egnyte domain using the SCIM-compliant endpoint. Use when you need to permanently remove a user from the system. This action is destructive and cannot be undone.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | string | Yes | The unique identifier of the user to delete from the Egnyte domain |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Download File

**Slug:** `EGNYTE_DOWNLOAD_FILE`

Tool to download file content from a specified path in Egnyte. Use when you need to retrieve the contents of a file stored in the Egnyte file system. Supports downloading specific versions via entry_id and partial content via Range header.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `path` | string | Yes | Full path to the file in Egnyte file system (e.g., 'Shared/Documents/test.txt'). Path should NOT start with a leading slash. |
| `entry_id` | string | No | Optional entry ID to download a specific version of the file. If not provided, downloads the latest version. |
| `range_header` | string | No | Optional HTTP Range header value for partial content download (e.g., 'bytes=0-1023' to download first 1024 bytes). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Download File By ID

**Slug:** `EGNYTE_DOWNLOAD_FILE_BY_ID`

Tool to download file content using persistent file ID from Egnyte. Use when you need to retrieve file content by its unique group_id. Optionally specify entry_id to download a specific version of the file.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `entry_id` | string | No | Specific version identifier. If provided, downloads a specific version of the file instead of the latest version. |
| `group_id` | string | Yes | Persistent file identifier (group_id) used to uniquely identify the file in Egnyte. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Audit Report

**Slug:** `EGNYTE_GET_AUDIT`

Tool to retrieve an audit report by type and ID. Audit reports are generated asynchronously - first create a report using POST /pubapi/v1/audit/{type}, then use this action to retrieve the completed report data. Returns audit events in JSON format.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Report ID obtained from creating an audit report via POST request. This is the unique identifier returned when the report was generated. |
| `type` | string ("logins" | "files" | "permissions" | "users" | "groups" | "workgroup-settings") | Yes | Type of audit report. Valid values: logins, files, permissions, users, groups, workgroup-settings. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get audit job status

**Slug:** `EGNYTE_GET_AUDIT_JOB`

Tool to check the status of an audit report generation job. Use when you need to poll the status of a previously created audit report to determine if it's ready for download.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The job ID returned from creating an audit report (e.g., from POST /pubapi/v1/audit/files). This ID is used to check the status of the audit report generation job. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Audit Stream

**Slug:** `EGNYTE_GET_AUDIT_STREAM`

Tool to stream audit events starting from a specific date. Returns up to 5,000 events for at most 30-minute spans. Use when you need to retrieve audit logs for the last 7 days. For pagination, use the nextCursor value from the response in subsequent requests.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Cursor for pagination. Use the nextCursor value from a previous response to get the next set of events. |
| `format` | string ("json" | "csv") | No | Format for audit stream response. |
| `startDate` | string | No | Start date for audit events in ISO 8601 format (e.g., '2026-02-10T00:00:00Z'). If not provided, returns events from the current time. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Bookmark

**Slug:** `EGNYTE_GET_BOOKMARK`

Tool to retrieve details for a specific bookmark by its ID. Use when you need to get the path, folder_id, or creation date of a bookmarked folder.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `bookmark_id` | string | Yes | The unique identifier of the bookmark to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Events Cursor

**Slug:** `EGNYTE_GET_EVENTS_CURSOR`

Tool to get the latest event cursor position for starting event polling. Use this to obtain the current cursor before beginning to poll for events.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Events V2

**Slug:** `EGNYTE_GET_EVENTS_V2`

Tool to poll for events (v2) including permission_change event type in addition to file_system and note types. Use when you need to retrieve events after a specific cursor ID. Returns a 204 status if no events exist after the provided cursor.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Cursor ID to get events after. Use the latest_id from a previous response or get the current cursor from /pubapi/v1/events/cursor endpoint |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get File Metadata by ID

**Slug:** `EGNYTE_GET_FILE_BY_ID`

Tool to retrieve file metadata using persistent file ID (group_id) instead of path. Use when you need to access file details regardless of the file's current location or name changes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `group_id` | string | Yes | Persistent file identifier (UUID format). This ID remains constant across file versions and can be used to reference the file regardless of its path. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get file or folder metadata

**Slug:** `EGNYTE_GET_FILE_METADATA`

Tool to get file or folder metadata from Egnyte. Use when you need to retrieve properties like name, path, size, last modified date, type, and other metadata. For folders, optionally list contents with pagination and sorting.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `path` | string | Yes | Full path to the file or folder. Should start with '/'. Example: '/Shared/Documents/file.txt' or '/Shared/MyFolder' |
| `count` | integer | No | Number of items to return in folder listing. Only applicable when list_content=true. |
| `offset` | integer | No | Starting index for pagination of folder contents. Only applicable when list_content=true. |
| `sort_by` | string ("name" | "last_modified" | "size") | No | Sort field options for folder contents. |
| `list_content` | boolean | No | Whether to list folder contents. Only applicable for folders. If true, returns folders and files arrays. |
| `sort_direction` | string ("ascending" | "descending") | No | Sort direction options. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get File Metadata Values

**Slug:** `EGNYTE_GET_FILE_METADATA_VALUES`

Tool to retrieve custom metadata values for a file or file version within a specific namespace. Use when you need to fetch custom properties associated with a file.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | File group_id or entry_id. This is the unique identifier for the file. |
| `namespace_name` | string | Yes | Namespace identifier. The name of the custom metadata namespace to retrieve properties from. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Folder By ID

**Slug:** `EGNYTE_GET_FOLDER_BY_ID`

Tool to get folder metadata using a persistent folder ID instead of a path. Use when you have a folder_id and need to retrieve current folder details including name, path, contents, and permissions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `folder_id` | string | Yes | Persistent folder identifier (UUID format). This ID remains constant even if the folder is moved or renamed. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Folder Statistics

**Slug:** `EGNYTE_GET_FS_STATS`

Tool to get statistics for a folder by ID including file counts, folder counts, and size information. Use when you need to retrieve storage and content metrics for a specific folder.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The persistent folder ID (folder_id) to get statistics for. This is a UUID-like identifier for the folder. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Group Details

**Slug:** `EGNYTE_GET_GROUP`

Tool to retrieve details for a specific group including members and attributes. Use when you need to fetch group information by group ID. SCIM-compliant.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `group_id` | string | Yes | The unique identifier (UUID) of the group to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Link Details

**Slug:** `EGNYTE_GET_LINK`

Tool to get detailed information about a shared link by its ID. Use when you need to retrieve details like path, type, accessibility settings, expiration date, and recipients for a specific shared link.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `link_id` | string | Yes | The unique identifier of the link to retrieve details for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Link Settings

**Slug:** `EGNYTE_GET_LINK_SETTINGS`

Tool to retrieve domain link settings including default expiration and allowed link types. Use when you need to check the organization's policies for link creation and expiration.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Folder Permissions

**Slug:** `EGNYTE_GET_PERMISSIONS`

Tool to get effective permissions for a folder including users and groups with their permission levels. Use when you need to check who has access to a specific folder and their permission levels (Owner, Full, Editor, Viewer, None).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `path` | string | Yes | Folder path to get permissions for. Example: 'Shared' or 'Shared/Documents' |
| `users` | string | No | Filter by specific usernames (pipe-separated list). Example: 'jsmith\|ajones' |
| `groups` | string | No | Filter by specific group names (pipe-separated list). Example: 'All Power Users\|Engineering' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User by ID

**Slug:** `EGNYTE_GET_USER`

Tool to retrieve details for a single user by ID. Use when you need to fetch specific user information using their user ID. SCIM-compliant endpoint.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | integer | Yes | The unique identifier of the user to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Info

**Slug:** `EGNYTE_GET_USERINFO`

Tool to get information about the currently authenticated user. Use when you need to retrieve details about the user associated with the OAuth token.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Bookmarks

**Slug:** `EGNYTE_LIST_BOOKMARKS`

Tool to list all bookmarked folders for the authenticated user with pagination support. Use when you need to retrieve user bookmarks or check which folders are bookmarked.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `count` | integer | No | Number of bookmarks to return per page. Use for controlling page size in pagination. |
| `offset` | integer | No | Starting index for pagination. Use to skip the first N bookmarks in the result set. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Comments

**Slug:** `EGNYTE_LIST_COMMENTS`

Tool to list all comments/notes on a file in Egnyte. Use when you need to retrieve comments or discussion threads associated with a specific file.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `path` | string | Yes | Full path to the file in Egnyte file system (e.g., '/Shared/Documents/test.txt'). Must include leading slash. |
| `count` | integer | No | Maximum number of comments to return in the response. Use for pagination. |
| `offset` | integer | No | Starting index for pagination. Use to skip the first N comments. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Groups

**Slug:** `EGNYTE_LIST_GROUPS`

Tool to list all custom groups in the Egnyte domain. Use when retrieving groups for user management or access control. Does not return default Egnyte groups, only custom-created groups.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `count` | integer | No | The number of results to return per page. Use to control page size in paginated responses. |
| `filter` | string | No | SCIM filter expression to filter groups by attributes. Supports SCIM filtering syntax for querying specific groups. |
| `startIndex` | integer | No | The 1-based index of the first result to return. Use for pagination to specify where to start in the result set. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Insights Files

**Slug:** `EGNYTE_LIST_INSIGHTS_FILES`

Tool to list recently accessed files for the authenticated user. Returns up to 10 files with metadata including size, last_modified, and last_accessed timestamps.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Links V2

**Slug:** `EGNYTE_LIST_LINKS_V2`

Tool to list all shared links using the v2 API with extended response fields. Use when you need detailed link information including accessibility, protection, recipients, creation date, expiry settings, and last accessed timestamp. Note: Non-admin users will only see links they created.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `count` | integer | No | Number of links to return per page. Controls the page size for pagination. |
| `offset` | integer | No | Pagination offset for listing links. Specifies the starting position in the result set. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Metadata Namespaces

**Slug:** `EGNYTE_LIST_METADATA_NAMESPACES`

Tool to list all custom metadata keys in a namespace. Use when you need to inspect metadata key definitions for a specific namespace in Egnyte.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `namespace_name` | string | Yes | Namespace identifier to retrieve metadata keys from |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Users

**Slug:** `EGNYTE_LIST_USERS`

Tool to retrieve all users or a filtered subset from the Egnyte domain. Use when you need to list users with optional pagination and filtering via SCIM-compliant parameters.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `count` | integer | No | The number of results to return per page. Used to control page size. |
| `filter` | string | No | Filter expression to retrieve a subset of users. Supports SCIM filtering (e.g., 'userName eq "jsmith"' or 'email co "@example.com"'). Attribute names are case insensitive. |
| `attributes` | string | No | Comma-separated list of attribute names to return in the response. If not specified, all attributes are returned. |
| `startIndex` | integer | No | The 1-based index of the first result to return. Used for pagination. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List workflows

**Slug:** `EGNYTE_LIST_WORKFLOWS`

Tool to list all workflows in Egnyte. Use when you need to retrieve the list of workflows configured in the Egnyte account.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Workflow Tasks

**Slug:** `EGNYTE_LIST_WORKFLOWS_TASKS`

Tool to list all workflow tasks. Returns an array of tasks with total count. Use when you need to retrieve all workflow tasks in the Egnyte system.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Lock File

**Slug:** `EGNYTE_LOCK_FILE`

Tool to lock a file to prevent edits by other users. Use when you need to acquire an exclusive lock on a file to prevent concurrent modifications.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `path` | string | Yes | Full path to the file to lock in the Egnyte file system. Path should NOT start with a leading slash. Example: 'Shared/Documents/test_file.txt' |
| `lock_token` | string | No | A string identifier for the lock. This token can be used to identify the lock owner and is required to unlock the file later. |
| `lock_timeout` | integer | No | The timeout duration in seconds after which the lock will automatically expire. Example: 7200 for 2 hours, 3600 for 1 hour. |
| `collaboration` | string | No | Optional base64-encoded string containing collaboration metadata. This field is used for storing additional collaboration context. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Replace Group (PUT)

**Slug:** `EGNYTE_REPLACE_GROUP`

Tool to fully replace a group's attributes including display name and members. Use when you need to completely overwrite all group properties. This uses PUT method and replaces all attributes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier (UUID) of the group to replace. |
| `members` | array | Yes | Complete list of members for the group. Each member is specified by their numeric user ID. This replaces the entire member list. |
| `displayName` | string | Yes | The display name for the group. This field is required for PUT operation. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Advanced Search with Metadata Filters

**Slug:** `EGNYTE_SEARCH_V2`

Tool to perform advanced search with custom metadata filtering in Egnyte using v2 API. Use when you need to search files and folders with metadata filters or namespace constraints. Results scoped to user permissions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string | No | Filter results by type. Use 'file' for files only or 'folder' for folders only. |
| `count` | integer | No | Number of results to return per page. Maximum offset + count is 10000. |
| `query` | string | Yes | Search query string to find files and folders based on text content, metadata, and filenames |
| `folder` | string | No | Folder path to limit search scope. Only files within this folder and its subfolders will be searched. |
| `offset` | integer | No | Starting index for pagination. Use to skip the first N results. Maximum offset + count is 10000. |
| `namespaces` | array | No | Array of metadata namespace names to filter results. Only items with metadata in these namespaces will be returned. |
| `custom_metadata` | array | No | Array of custom metadata filters. Each filter specifies namespace, key, operator, and value for advanced metadata-based searching. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Set File Metadata Values

**Slug:** `EGNYTE_SET_FILE_METADATA_VALUES`

Tool to set custom metadata values for a file or file version within a specific namespace. Use when you need to add or update custom properties on a file. Keys must already exist in the namespace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | File group_id for latest version or entry_id for specific version. This is the unique identifier for the file. |
| `properties` | object | Yes | Dictionary of custom metadata property key-value pairs to set. Keys must already be defined in the namespace. Set a value to null to remove that metadata value. |
| `namespace_name` | string | Yes | Namespace identifier. The name of the custom metadata namespace where properties will be set. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Set Folder Metadata Values

**Slug:** `EGNYTE_SET_FOLDER_METADATA_VALUES`

Tool to set custom metadata values for a folder within a namespace. Use when you need to assign or update custom properties on a folder in Egnyte.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `folder_id` | string | Yes | Folder identifier. This is the unique identifier for the folder. |
| `namespace_name` | string | Yes | Namespace identifier. The name of the custom metadata namespace to set properties for. |
| `metadata_properties` | object | Yes | Dictionary of custom metadata property key-value pairs to set within the namespace. Each key must correspond to a metadata key defined in the namespace. Values can be strings, integers, floats, or booleans depending on the metadata key type definition. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Set Folder Permissions

**Slug:** `EGNYTE_SET_PERMISSIONS`

Tool to set folder permissions for users or groups. Permission levels: Owner, Full, Editor, Viewer, None. Use when you need to grant or revoke access to a folder for specific users or groups.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `path` | string | Yes | Folder path to set permissions for. Example: 'Shared/Documents' or 'Shared'. Do not include leading slash. |
| `users` | array | No | Array of usernames to set permissions for. Either users or groups must be provided. |
| `groups` | array | No | Array of group names to set permissions for. Either users or groups must be provided. |
| `permission` | string ("Owner" | "Full" | "Editor" | "Viewer" | "None") | Yes | Permission level to assign. Must be one of: Owner, Full, Editor, Viewer, None. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Stream Audit Events

**Slug:** `EGNYTE_STREAM_AUDIT_EVENTS`

Tool to stream audit events with filtering by audit types (FILE_AUDIT, LOGIN_AUDIT, PERMISSION_AUDIT). Use when you need to retrieve audit events for a specific date range or continue streaming from a previous cursor. Returns up to 5,000 events per request.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `auditType` | array | No | Array of audit types to filter by. If not specified, all audit types are returned. Options: FILE_AUDIT (file operations), LOGIN_AUDIT (login events), PERMISSION_AUDIT (permission changes). |
| `startDate` | string | No | ISO 8601 date to start streaming from. Format: YYYY-MM-DDTHH:MM:SSZ. Example: '2026-02-11T00:00:00Z'. Required if nextCursor is not provided. Must be within the last 7 days. |
| `nextCursor` | string | No | Cursor for pagination. Use the nextCursor value from a previous response to fetch the next batch of events. Mutually exclusive with startDate - provide either startDate or nextCursor, not both. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Folder Options

**Slug:** `EGNYTE_UPDATE_FOLDER_OPTIONS`

Tool to update folder options including description and other settings. Use when you need to modify folder metadata such as adding or updating the folder description.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `path` | string | Yes | Folder path to update. Example: 'Shared' or 'Shared/Documents'. Do not include leading slash. |
| `folder_description` | string | No | Description for the folder. Provide a descriptive text to explain the folder's purpose or contents. Maximum 200 characters. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Group

**Slug:** `EGNYTE_UPDATE_GROUP`

Tool to update specific attributes of a group including display name and members. Use when you need to modify group properties or membership. SCIM-compliant endpoint for incremental updates.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `members` | array | No | Updated list of members for the group. Each member is specified by their numeric user ID. This replaces the entire member list. |
| `group_id` | string | Yes | The unique identifier (UUID) of the group to update. |
| `displayName` | string | No | New display name for the group. Specify this to rename the group. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Metadata Key

**Slug:** `EGNYTE_UPDATE_METADATA_KEY`

Tool to update key definitions including display name, help text, data values for enums, and priority. Use when you need to modify metadata key properties within a namespace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | array | No | Array of allowed values for enum type keys. Only applicable when key type is 'enum' |
| `type` | string | No | Data type of the metadata key (string, integer, decimal, enum, date) |
| `helpText` | string | No | Help text to provide guidance on how to use this metadata key (max 100 characters) |
| `key_name` | string | Yes | Name of the metadata key to update within the namespace |
| `priority` | integer | No | Display priority for the metadata key. Higher values indicate higher priority |
| `displayName` | string | No | New display name for the metadata key |
| `namespace_name` | string | Yes | Namespace identifier containing the metadata key to update |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Metadata Namespace

**Slug:** `EGNYTE_UPDATE_METADATA_NAMESPACE`

Tool to update key definitions of a metadata namespace. Use when you need to change the display name or adjust field priorities. At least one of displayName or priorities must be provided.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `priorities` | object | No | Object containing key-value pairs where keys are metadata field names and values are their priority numbers |
| `displayName` | string | No | New display name for the namespace |
| `namespace_name` | string | Yes | Namespace identifier to update |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update User

**Slug:** `EGNYTE_UPDATE_USER`

Tool to update specific attributes of a user in the Egnyte domain using the SCIM-compliant endpoint. Use when you need to modify user information such as name, email, active status, or other user properties. Only the attributes provided in the request will be updated.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the user to update. |
| `name` | object | No | User's name information for update. |
| `email` | string | No | User's email address to update. |
| `active` | boolean | No | Whether the user account should be active or inactive. |
| `authType` | string | No | Authentication type for the user. |
| `language` | string | No | Language preference for the user in ISO format (e.g., 'en-US', 'de-DE'). |
| `userName` | string | No | The Egnyte username. May have restrictions on modification depending on account configuration. |
| `userType` | string | No | Type of user account in the system. |
| `idpUserId` | string | No | Identity provider user identifier. |
| `externalId` | string | No | Immutable unique identifier provided by the API consumer (e.g., Active Directory SID). |
| `sendInvite` | boolean | No | Whether to send an invitation email to the user after update. |
| `userPrincipalName` | string | No | User principal name (typically the same as email). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Upload File

**Slug:** `EGNYTE_UPLOAD_FILE`

Tool to upload or update a file at the specified path in Egnyte. Use when you need to create a new file or replace an existing file. For files larger than 100MB, consider using chunked upload instead.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file` | object | Yes | File to upload. |
| `path` | string | Yes | Full path including filename where the file should be uploaded (e.g., 'Private/username/document.txt', 'Shared/Documents/report.pdf'). Path should NOT start with a leading slash. |
| `last_modified` | string | No | Last modified timestamp in ISO8601 format (e.g., '2023-01-15T10:30:00Z'). If provided, sets the file's last modified time. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |
