Matter Manager (REST)

In Relativity, a matter is a legal case, such as a dispute or other action during which a law firm acts as a representative of a client. For general information, see Matters on the Relativity Documentation site.

The Matter Manager service exposes multiple endpoints for programmatically managing matters in your Relativity environment. It includes the following features:

  • Supports create, read, update, and delete operations on matters.
  • Provides helper endpoints used to retrieve available clients and statuses. Use these endpoints when creating or updating matters.

You can also use the Matter Manager service through .NET. For more information, see Matter Manager (.NET).

Guidelines for the Matter Manager service

Review the following guidelines for working with this service.

URLs

The URLs for REST endpoints contain path parameters that you need to set before making a call:

  • Set the {versionNumber} placeholder to the version of the REST API that you want to use, using the format lowercase v and the version number, for example v1.
  • Set other path parameters in the URLs to the Artifact ID of a given entity, for example setting {workspaceID} to the Artifact ID of a workspace.
  • Note: To indicate the admin-level context, set the {workspaceID} path parameter to -1.

For example, you can use the following URL to retrieve a matter:

Copy
<host>/Relativity.Rest/API/relativity-environment/{versionNumber}/workspaces/-1/matters/{Matter ID}

Set the path parameters as follows:

  • {versionNumber} to the version of the API, such as v1.
  • {Matter ID} to the Artifact ID of a specific matter.

Postman sample file

You can use the Postman sample file to become familiar with making calls to endpoints on the Matter Manager service. To download the sample file, click Matter Manager Postman file.

To get started with Postman, complete these steps:

  1. Obtain access to a Relativity environment. You need a username and password to make calls to your environment.
  2. Install Postman.
  3. Import the Postman sample file for the service. For more information, see Working with data files on the Postman web site.
  4. Select an endpoint. Update the URL with the domain for your Relativity environment and any other variables.
  5. In the Authorization tab, set the Type to Basic Auth, enter your Relativity credentials, and click Update Request.
  6. See the following sections on this page for more information on setting required fields for a request.
  7. Click Send to make a request.

Note: In the following examples, the URLs use -1 to indicate the admin-level context. For example, the URL for creating a matter uses -1 as the workspace ID. See Create a matter.

Retrieve a list of available clients

To retrieve a list of the available clients in a Relativity environment, send a GET request to the following URL:

Copy
<host>/Relativity.rest/api/relativity-environment/{versionNumber}/workspaces/-1/eligible-clients

The request body is empty.

The response contains the following fields for each server returned in the array:

  • Name – the name of the client.
  • ArtifactID - the Artifact ID of the client.

Retrieve a list of matter statuses

To retrieve a list of available matter statuses in a Relativity environment, send a GET request to the following URL:

Copy
<host>/Relativity.rest/api/relativity-environment/{versionNumber}/workspaces/-1/matters/eligible-statuses

The request body is empty.

The response contains the following fields for each server returned in the array:

  • Name – the name of the status.
  • ArtifactID - the Artifact ID of the status.

Create a matter

Before creating a matter, you need to identify an available client and status to associate with the matter. Use the helper endpoints to obtain this information. See Retrieve a list of available clients and Retrieve a list of matter statuses.

To add a new matter to a Relativity environment, send a POST request to this URL:

Copy
<host>/Relativity.Rest/API/relativity-environment/{versionNumber}/workspaces/-1/matters

When the matter is successfully created, the response returns the status code of 200.

Retrieve metadata for a matter

You can retrieve basic information about a matter or extended information, which also includes operations that you have permissions to perform on the matter.

  • Retrieve basic metadata for a matter - send a GET request with a URL in the following general format:
  • Copy
    <host>/Relativity.Rest/API/relativity-environment/{versionNumber}/workspaces/-1/matters/{Matter ID}
  • Retrieve extended metadata for a matter -send a GET request with a URL in the following general format:
  • Copy
    <host>/Relativity.Rest/API/relativity-environment/{versionNumber}/workspaces/-1/matters/{Matter ID}/true/true

The body of the request is empty.

Update a matter

You can modify the properties of a matter, such as its name. Additionally, you can also restrict the update of a matter to the date that it was last modified by adding the LastModifiedOn field to the request.

To update the properties of a matter, send a PUT request with a URL in the following general format:

Copy
<host>/Relativity.Rest/API/relativity-environment/{versionNumber}/workspaces/-1/matters/{Matter ID}

When the matter is successfully updated, the response returns the status code of 200.

Delete a matter

You can delete a matter from a Relativity environment if it isn't associated with any workspace.

To delete a matter, send a DELETE request with a URL in the following general format:

Copy
<host>/Relativity.Rest/API/relativity-environment/{versionNumber}/workspaces/-1/matters/{ToDelete}

The body of the request is empty.

When the matter is successfully deleted, the response returns the status code of 200.