Unily

Connect your AI agents to Unily.

Authentication: API key. See 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.

validate_credential

Validate Unily credentials by making a test API call. Returns success status and a message. Use this to confirm the subd…