Batches Manager (REST)

A batch is a collection of documents that a Relativity admin has grouped together based on a specific set of criteria. During the review phase of the e-discovery process, the admin assigns a batch to a reviewer. The reviewer checks out the batch to determine the relevancy of its documents to a case, and then checks the batch in after coding the documents. For more information, see Batches.

The Batches Manager service supports retrieving information about existing batches as well as checking batches in and out. As a sample use case, you could use the Batches Manager service to implement application logic that automatically checks batches in and out on behalf of reviewers.

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

This page contains the following information:

Guidelines for the Batches Manager service

Review the following guidelines for working with this service.

URLs

Set the {{versionNumber}} to the version of the API, using the format lowercase v and the version number, such as v1. Set the variables in the URLs to the Artifact ID of a given entity.

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

<host>/Relativity.REST/api/relativity-review/{{versionNumber}}/workspaces/{{workspaceID}}/batches/{{batchID}}

Set the variables as follows:

  • {{versionNumber}} to the version of the API, such as v1.
  • {{workspaceID}} variable to the Artifact ID of the workspace that contains the batch.
  • {{batchID}} variable to the Artifact ID of a specific batch.

Client code sample

To use the Batches Manager service, send requests by making calls with the required HTTP methods. You can use the following .NET code as a sample client for reading the properties of a batch. For more information, see Read a batch.

public async Task<Batch> ReadBatchViaREST(int workspaceID, int batchID)
{
    Batch result = null;
    string email = "username@email.com";
    string password = "password";
    using (HttpClient client = new HttpClient())
    {
        client.DefaultRequestHeaders.Add("X-CSRF-Header", "-");
        client.DefaultRequestHeaders.Add("Authorization", "Basic " + Convert.ToBase64String(Encoding.GetEncoding("ISO-8859-1").GetBytes($"{email}:{password}")));
        client.DefaultRequestHeaders.Add("X-Kepler-Version", "2.0");
 
        var url = $"http://localhost/Relativity.REST/api/relativity-review/v1/workspaces/{workspaceID}/batches/{batchID}";
        var response = await client.GetAsync(url);
        response.EnsureSuccessStatusCode();
        var content = await response.Content.ReadAsStringAsync();
        result = JsonConvert.DeserializeObject<Batch>(content);
    }
 
    return result;
}

Read a batch

To retrieve the properties of a batch, send a GET request to a URL with the following format:

<host>/Relativity.REST/api/relativity-review/v1/workspaces/{{workspaceID}}/batches/{{batchID}}

The body of the request is empty.

The response contains the following fields:

  • BatchID - the Artifact ID for the batch.
  • Name - the user-friendly name of the batch.
  • Status - the following statuses are available for a batch:
    • None - indicates that the batch isn't checked out.
    • InProgress - indicates that the batch is checked out but not completed.
    • Completed - indicates that the batch is completed and checked in.
  • AssignedUserID - the user who has checked out the batch.
    • Secured - indicates whether the current user has permissions to view the setting in the Value field.
    • Value - the Artifact ID for the user assigned to the batch.
{
  "BatchID": 1593398,
  "Name": "TEST200001",
  "Status": "InProgress",
  "AssignedUserID": {
    "Secured": false,
    "Value": 1021804
  }
}

Check out a batch

To check out a batch, send a POST request to a URL with the following format:

<host>/Relativity.REST/api/relativity-review/v1/workspaces/{{workspaceID}}/batches/{{batchID}}/checkout

The body of the request must contain a request object with a UserID field. Set this field to the Artifact ID for the user who should be assigned to the batch.

{
    "request": {
        "UserID": 1021804
    }
}

When the batch is successfully checked out, the response returns the status code of 200.

Check in a batch

To check in a batch, send a POST request to a URL with the following format:

<host>/Relativity.REST/api/relativity-review/v1/workspaces/{{workspaceID}}/batches/{{batchID}}/checkin?completed=true

Note: You can omit the ?completed=true query string parameter. The default value of false is then used. Alternatively, you can explicitly check in the batch as incomplete with a query string value of ?completed=false.

The body of the request is empty.

When the batch is successfully checked in, the response returns the status code of 200.

Community Updates

Aero Developer FAQ Evolving the Platform Most recent release notes
Learn more Learn more Learn more

Additional Resources

   
Access Third-Party Tools with GitHub     Create .NET Apps Faster with NuGet
Visit github     visit nuget