relone_add_user_to_group
ChatGPTAdd a user as a member of a security group. Use relone_list_users to find the user Artifact ID and relone_list_groups to find the group Artifact ID, then pass both. Single user, single group per call — this tool intentionally does not bulk-operate so the resolved-name confirmation prompt is unambiguous. Eventually consistent: the upstream Group Manager call returns immediately, but the membership change propagates through ADS agents and service bus over several minutes. A subsequent relone_list_user_groups or relone_list_group_users call may not reflect the change immediately. Uses the Group Manager Kepler service (Relativity-Identity v1).
relone_add_workspace_group
ChatGPTGrant a security group access to a workspace. In Relativity, workspace access is controlled through groups — users are members of groups, and groups are granted access to workspaces. Use relone_list_groups to find the group Artifact ID, then use this tool to add it to a workspace. Uses the Permission Manager Kepler service — caller needs Manage Workspace Permissions rights.
relone_connection_status
ChatGPTCheck the current authenticated connection to Relativity aiR. Returns the instance URL, authenticated user identity, and auth type derived from the request's OAuth context.
relone_create_client
ChatGPTCreate a new legal client in the Relativity aiR instance. Clients are the top-level organizational entity in the Client → Matter → Workspace hierarchy. You must create a Client before you can create a Matter, and you must create a Matter before you can create a Workspace. Use the returned ArtifactId when creating a Matter with relone_create_matter.
relone_create_matter
ChatGPTCreate a new legal matter (case) in the Relativity aiR instance. A Matter belongs to a Client and is required when creating a Workspace — the Matter's Artifact ID is passed to relone_create_workspace. This completes the Client → Matter → Workspace creation flow.
relone_create_workspace
ChatGPTEnqueue creation of a new workspace on the connected Relativity aiR instance. This returns a job handle within seconds — it does NOT block until the workspace is ready. Workspace creation runs asynchronously on Relativity aiR and typically takes 5–10 minutes. After calling this tool, poll relone_get_workspace_create_job with the returned JobId every 30–60 seconds until JobState is "COMPLETED" (success) or "ERROR" (failure). On COMPLETED, the job status exposes WorkspaceId — call relone_get_workspace for full details. Use relone_list_workspace_templates to find a template Artifact ID. useCase must be one of the canonical Use Case display strings (e.g. "Litigation - Other Civil", "Data Breach Response", "Internal Investigation", "Freedom of Information Act (FOIA)", "Contract Reviews"); match is case-insensitive and unknown values are rejected with the full list of valid options.
relone_edit_client
ChatGPTEdit an existing legal client. The new name is required on every call; number and status are optional and may be omitted to leave them unchanged. The tool GETs the current client so the confirmation preview shows exactly which fields will change and which are being preserved. At least one of number or status must be supplied alongside name (or name itself must differ from the current value).
relone_edit_matter
ChatGPTEdit an existing legal matter. The new name is required on every call; number, clientId, and status are optional and may be omitted to leave them unchanged. IMPORTANT: re-assigning the Client (clientId) on a Matter that already has workspaces is blocked in the Relativity UI. Whether Object Manager enforces the same restriction depends on the R1 version — the tool will surface any server-side rejection verbatim rather than work around it.
relone_edit_workspace
ChatGPTEdit a workspace's editable metadata — name, status, and/or assigned Matter. Omit any parameter to leave it unchanged; at least one must be supplied. Workspace template and use-case are fixed at creation and cannot be changed here. Re-assigning a workspace to a different Matter re-parents it under a different Client as well, and may be blocked server-side if the workspace has dependencies — the tool surfaces any R1 rejection verbatim rather than working around it.
relone_get_fields
ChatGPTGet field definitions for a specific object type. Use relone_list_choices for choice-type fields to see available values. Returns a paginated envelope with TotalCount (authoritative total), an Items page, ActiveFilters, and ProjectionUsed.
relone_get_workspace
ChatGPTGet details of a specific workspace by ID. Returns workspace name, status, matter and client references, and creation/modification timestamps.
relone_get_workspace_create_job
ChatGPTGet progress of an asynchronous workspace-create job returned by relone_create_workspace. JobState transitions NEW → IN_PROGRESS → COMPLETED (or ERROR). On COMPLETED, WorkspaceId is populated — call relone_get_workspace for full workspace details. Poll every 30–60 seconds. Workspace creation typically completes in 5–10 minutes.
relone_list_choices
ChatGPTGet available values for a choice field. Returns a paginated envelope with TotalCount (authoritative total), an Items page, ActiveFilters, and ProjectionUsed. Use the field name from relone_get_fields results as the fieldName parameter.
relone_list_clients
ChatGPTList legal clients configured in the Relativity aiR instance. Clients are the top-level organizational entity — every Matter belongs to a Client, and every Workspace belongs to a Matter. Use this to find or verify a Client before creating a Matter. Returns a paginated envelope with TotalCount (authoritative total), an Items page, ActiveFilters, and ProjectionUsed. Queries admin workspace (-1).
relone_list_group_users
ChatGPTList the users that are members of a security group. Use relone_list_groups to find the group Artifact ID first, then call this tool with that ID. Returns a paginated envelope with TotalCount, an Items page (each Item exposes ArtifactId, Full Name, Email Address), Start, and Truncated. Backed by the Group Manager Kepler service's groups/{groupId}/query-members endpoint. Membership changes from relone_add_user_to_group / relone_remove_user_from_group are eventually consistent and may take several minutes to appear in the results here.
relone_list_groups
ChatGPTList security groups on the Relativity aiR instance. Groups control access to workspaces and objects — users are assigned to groups, and groups are granted permissions on workspaces. Use this to find groups before assigning workspace access with relone_add_workspace_group. Returns a paginated envelope with TotalCount (authoritative total), an Items page, ActiveFilters, and ProjectionUsed. Common built-in groups include 'System Administrators' and 'Everyone'. Queries admin workspace (-1).
relone_list_matters
ChatGPTList legal matters (cases) configured in the Relativity aiR instance. A Matter belongs to a Client and is required when creating a new Workspace — you must provide the Matter's Artifact ID to relone_create_workspace. Use this to find the correct Matter ID before workspace creation. Returns a paginated envelope with TotalCount (authoritative total), an Items page, ActiveFilters, and ProjectionUsed. Queries admin workspace (-1).
relone_list_object_types
ChatGPTList object types in a workspace. Use the Artifact Type ID from Items with relone_get_fields to inspect a type's fields. Returns a paginated envelope with TotalCount (authoritative total), an Items page, ActiveFilters, and ProjectionUsed.
relone_list_user_groups
ChatGPTList the security groups a user belongs to. Use relone_list_users to find the user Artifact ID first, then call this tool with that ID. Returns a paginated envelope with TotalCount, an Items page (each Item exposes ArtifactId, Name, and any other fields requested via projection), Start, and Truncated. Backed by the Group Manager Kepler service's groups/query-by-user/{userId} endpoint, which is the canonical way to ask this question — there is no general-purpose 'groups this user is in' query in Object Manager. Membership changes from relone_add_user_to_group / relone_remove_user_from_group are eventually consistent and may take several minutes to appear in the results here.
relone_list_users
ChatGPTList user accounts on the Relativity aiR instance. Use this to find users when setting up workspace access, verifying team membership, or checking who has admin privileges. Returns a paginated envelope with TotalCount (authoritative total), an Items page, ActiveFilters, and ProjectionUsed. Queries admin workspace (-1). Filter by name or email using the condition parameter (e.g., condition: "'Email Address' LIKE '%@relativity.com'"). Use the projection parameter to request admin-relevant fields like Enabled, First Name, or Last Name.
relone_list_workspace_groups
ChatGPTList the security groups that currently have access to a workspace. Use this to audit workspace access, verify a group was added, or check which teams can see the workspace. Returns a paginated envelope with TotalCount (authoritative total), an Items page, ActiveFilters, and ProjectionUsed.
relone_list_workspace_templates
ChatGPTList workspaces that can be used as templates when creating new workspaces. In Relativity, any existing workspace can serve as a template — creating a workspace from a template clones its structure, views, layouts, fields, and applications into the new workspace. Use the Artifact ID from the Items as the templateId parameter in relone_create_workspace. Returns a paginated envelope with TotalCount (authoritative total), an Items page, ActiveFilters, and ProjectionUsed. Note: template-based workspace creation can take 5+ minutes for DB restore and permissions setup.
relone_list_workspaces
ChatGPTList workspaces on the connected Relativity aiR instance with optional name filtering. Returns a paginated envelope with TotalCount (authoritative total), an Items page, ActiveFilters, and ProjectionUsed.
relone_remove_user_from_group
ChatGPTRemove a user from a security group — the inverse of relone_add_user_to_group. Single user, single group per call. The user will lose every permission they were receiving via this group; if their access to a workspace came only through this group, they will lose that workspace too. Eventually consistent: the upstream Group Manager call returns immediately, but the removal propagates through ADS agents and service bus over several minutes. A subsequent relone_list_user_groups call may briefly still show the membership. Server-side idempotent: removing a user that isn't currently a member is a no-op. Uses the Group Manager Kepler service (Relativity-Identity v1).
relone_remove_workspace_group
ChatGPTRevoke a security group's access to a workspace — the inverse of relone_add_workspace_group. All members of the group will lose access to the workspace. Uses the Permission Manager Kepler service — caller needs Manage Workspace Permissions rights. Server-side idempotent: removing a group that doesn't currently have access is a no-op.
relone_usage_delete_report
ChatGPTDelete a usage report by ID. Works on reports in any status. PERMISSION NOTE: Returns 403 unless the OAuth client's Context User is in a group with 'View Instance-wide Usage Reports' (or 'View Client Domain Usage Reports') under Admin Operations, plus 'Management Console' + 'Usage Reports' under Tab Visibility. System Admin alone is not sufficient — this permission must be explicitly granted.
relone_usage_download_report
ChatGPTDownload a finished usage report as CSV. Returns the CSV content as text. The report must have status "Completed". Reports larger than 10 MB are rejected — use relone_usage_get_report_details for paginated structured access to large reports. PERMISSION NOTE: Returns 403 unless the OAuth client's Context User is in a group with 'View Instance-wide Usage Reports' (or 'View Client Domain Usage Reports') under Admin Operations, plus 'Management Console' + 'Usage Reports' under Tab Visibility. System Admin alone is not sufficient — this permission must be explicitly granted.
relone_usage_generate_report
ChatGPTGenerate a new usage report. Report generation is asynchronous — the returned report will have status "Scheduled". Use relone_usage_wait_for_report to poll until it reaches "Completed". All field GUIDs must belong to the same reportType (Workspace or User). PERMISSION NOTE: Returns 403 unless the OAuth client's Context User is in a group with 'View Instance-wide Usage Reports' (or 'View Client Domain Usage Reports') under Admin Operations, plus 'Management Console' + 'Usage Reports' under Tab Visibility. System Admin alone is not sufficient — this permission must be explicitly granted.
relone_usage_get_metadata
ChatGPTRetrieve available metadata fields (origins and metrics) for building usage reports. Each metric has a GUID, name, description, valueType, reportType (Workspace or User), and isDefault flag. Use the GUIDs in the fields array when generating a report. PERMISSION NOTE: Returns 403 unless the OAuth client's Context User is in a group with 'View Instance-wide Usage Reports' (or 'View Client Domain Usage Reports') under Admin Operations, plus 'Management Console' + 'Usage Reports' under Tab Visibility. System Admin alone is not sufficient — this permission must be explicitly granted.
relone_usage_get_report
ChatGPTGet details of a specific usage report by ID. Returns status (Scheduled, InProgress, or Completed), name, date range, fields, type, and creation timestamp. PERMISSION NOTE: Returns 403 unless the OAuth client's Context User is in a group with 'View Instance-wide Usage Reports' (or 'View Client Domain Usage Reports') under Admin Operations, plus 'Management Console' + 'Usage Reports' under Tab Visibility. System Admin alone is not sufficient — this permission must be explicitly granted.
relone_usage_get_report_details
ChatGPTGet paginated row-level data from a finished usage report. The response contains a Fields array (metric GUIDs as column headers) and an Items array (rows of values). The report must have status "Completed" — call relone_usage_wait_for_report first if just generated. PERMISSION NOTE: Returns 403 unless the OAuth client's Context User is in a group with 'View Instance-wide Usage Reports' (or 'View Client Domain Usage Reports') under Admin Operations, plus 'Management Console' + 'Usage Reports' under Tab Visibility. System Admin alone is not sufficient — this permission must be explicitly granted.
relone_usage_list_reports
ChatGPTList all existing usage reports for the tenant. The endpoint is not paginated — all reports are returned in a single call, so TotalCount equals the number of Items. PERMISSION NOTE: Returns 403 unless the OAuth client's Context User is in a group with 'View Instance-wide Usage Reports' (or 'View Client Domain Usage Reports') under Admin Operations, plus 'Management Console' + 'Usage Reports' under Tab Visibility. System Admin alone is not sufficient — this permission must be explicitly granted.
relone_usage_wait_for_report
ChatGPTPoll a usage report until it reaches "Completed" status or times out. Returns the final report object on success. Use after relone_usage_generate_report. IMPORTANT: This tool blocks while polling for up to maxWaitMs (default 2 minutes, maximum 10 minutes). PERMISSION NOTE: Returns 403 unless the OAuth client's Context User is in a group with 'View Instance-wide Usage Reports' (or 'View Client Domain Usage Reports') under Admin Operations, plus 'Management Console' + 'Usage Reports' under Tab Visibility. System Admin alone is not sufficient — this permission must be explicitly granted.
relone_wait_for_workspace_create_job
ChatGPTWait for an asynchronous workspace-create job to reach a terminal state (COMPLETED or ERROR). Polls internally and emits MCP progress notifications — rendered inline by clients that support them, ignored gracefully otherwise. The upstream creation job runs independently of this wait: cancelling the tool call (for example, the user interrupting to ask something else) does NOT cancel the workspace creation; call this tool again with the same JobId to resume watching. If the wait timeout elapses without reaching a terminal state, returns the current non-terminal status — call again to keep waiting. On COMPLETED, call relone_get_workspace with the returned WorkspaceId for full details.
relone_add_user_to_group
Clauderelone_add_workspace_group
Clauderelone_connection_status
Clauderelone_create_client
Clauderelone_create_matter
Clauderelone_create_workspace
Clauderelone_edit_client
Clauderelone_edit_matter
Clauderelone_edit_workspace
Clauderelone_get_fields
Clauderelone_get_workspace
Clauderelone_get_workspace_create_job
Clauderelone_list_choices
Clauderelone_list_clients
Clauderelone_list_group_users
Clauderelone_list_groups
Clauderelone_list_matters
Clauderelone_list_object_types
Clauderelone_list_user_groups
Clauderelone_list_users
Clauderelone_list_workspace_groups
Clauderelone_list_workspace_templates
Clauderelone_list_workspaces
Clauderelone_remove_user_from_group
Clauderelone_remove_workspace_group
Clauderelone_usage_delete_report
Clauderelone_usage_download_report
Clauderelone_usage_generate_report
Clauderelone_usage_get_metadata
Clauderelone_usage_get_report
Clauderelone_usage_get_report_details
Clauderelone_usage_list_reports
Clauderelone_usage_wait_for_report
Clauderelone_wait_for_workspace_create_job
Claude