> This page is for Agent Handler. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.merge.dev/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server. # Unily **Authentication:** API key. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow. ## Available Tools #### get_audience Get a Unily audience by its alias. #### search_audiences Search Unily audiences by text, aliases, type, and repository, with paging. You must provide at least one of search_text... #### get_dynamic_audience Get a Unily dynamic audience (including its filter rules) by alias. #### upsert_dynamic_audience Create or update a Unily dynamic audience by alias. Requires a name and filter rules (each with field, comparisonOperato... #### delete_dynamic_audience Delete a Unily dynamic audience by alias. #### get_content Get a Unily content node by its unique identifier (GUID). Returns the content with its properties. Set include_descendan... #### query_content Search Unily content with a Lucene query and pagination. Returns matching content items and a paging token for the next... #### create_content Create a new Unily content node. Requires a unique_id (GUID) to assign, a name, the document_type_alias, the parent_uniq... #### update_content Create or replace a Unily content node by unique_id (GUID) using a full PUT. Requires parent_unique_id and the full set... #### patch_content Partially update a Unily content node by unique_id (GUID). Updates only the supplied properties and fields. Use update_c... #### delete_content Delete a Unily content node by unique_id (GUID). All child content is deleted too. Use query_content to find the unique\_... #### create_content_from_template Create new Unily content by copying a predefined template. Requires the template_id, the parent_id to create under, and... #### list_followed_content List the content a Unily user follows, with search and offset pagination (skip/take). #### follow_content Make a Unily user follow a content item, by user_id and content_id. #### unfollow_content Make a Unily user unfollow a content item, by user_id and content_id. #### list_followed_users List the users a Unily user follows, with search and offset pagination (skip/take). #### follow_user Make a Unily user follow another user, by user_id and followed_user_id. #### unfollow_user Make a Unily user unfollow another user, by user_id and followed_user_id. #### list_form_submissions List Unily form submissions. Requires a scope ('Approvals', 'MySubmissions', or 'AllSubmissions'). Filter by form_ids, a... #### get_form_submission Get a Unily form submission by its submission ID. #### delete_form_submission Delete a Unily form submission by its submission ID. #### update_submission_approval_status Update the approval status of a Unily form submission. State is one of None, PendingApproval, Approved, or Rejected. Opt... #### get_media Get a Unily media node by unique identifier (GUID). Set include_descendants to also return child media. #### get_media_image Get a Unily media image by unique identifier (GUID), including file metadata and focal point. #### get_media_folder Get a Unily media folder by unique identifier (GUID). #### list_notifications List a Unily user's tray notifications with offset pagination. Filter by 'since' date and page with skip/take. #### post_notification Post a Unily notification to users or audiences. The message must include the instance's default system language (common... #### delete_notification Delete a single Unily notification for a user by user_id and notification_id. #### list_organisations List all organisations registered in the Unily instance. #### get_organisation Get a Unily organisation by its unique ID (GUID). #### search Run a GraphQL search against Unily content. Provide a GraphQL query string and optional variables, operation_name, and l... #### list_security_groups List all Unily security groups (static, dynamic, and external). #### get_static_security_group Get a Unily static security group by its unique ID (GUID), including its members. #### get_dynamic_security_group Get a Unily dynamic security group by its unique ID (GUID), including its configuration. #### list_security_roles List all Unily security roles and their permissions. #### get_security_role Get a Unily security role by its unique ID (GUID). #### get_comment Get a Unily social comment by its comment ID. #### create_comment Create a Unily social comment. Requires author_unique_id and type ('Comment' or 'Share'). Set content_unique_id to the c... #### update_comment Update a Unily social comment by comment_id. Requires author_unique_id and type ('Comment' or 'Share'). Use get_comment... #### delete_comment Delete a Unily social comment by its comment ID. #### list_social_reactions List Unily social reaction types (e.g. Like). Filter by applicable_document_types (comma-separated aliases) or by conten... #### list_document_types List all Unily document (content) types. Optionally pass iso_code for translated names. #### get_document_type Get a Unily document type by alias. Optionally pass iso_code for translated names. #### list_data_types List Unily data types. Optionally filter by name. #### get_data_type Get a Unily data type by its unique identifier (GUID). #### list_user_types List all Unily user types and their property definitions. #### get_user_type Get a Unily user type by its alias. #### list_languages List the languages configured in the Unily instance. #### list_users List Unily users with pagination. Returns users and a paging token for the next page. Use order_by/direction to sort. Pa... #### get_user Get a Unily user by unique identifier (GUID). Use list_users or query_users to find IDs. #### query_users Search Unily users with a Lucene query and pagination. Returns matching users and a paging token. Pass paging_token from... #### create_user Create a new Unily user. Requires name, login_name, and user_type_alias. Optionally set email, a unique_id (GUID), and p... #### update_user Update a Unily user's properties by unique_id (GUID). Only supplied fields and properties are changed. Use get_user to f... #### delete_user Delete a Unily user by unique_id (GUID). Use get_user to confirm the user first.