Error Manager (REST)

Relativity provides a logging mechanism called Errors. Through the REST API, the Error Manager API exposes a single endpoint for creating errors, which can be displayed in the Error tab in Relativity.

You can use this to create a single error log which can be found on the Error tab in Relativity using a returned ArtifactID.

This page contains the following information:

Guidelines for the Error Manager service

Review the following guidelines for working with this service.

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

  • Set {versionNumber} to the version of the API, using the format lowercase v and the version number, such as v1.
  • Set other path parameters in the URLs to the Artifact ID of a given entity, such as {workspaceID} to the Artifact ID of a workspace.
  • Note: To indicate the admin-level context, set the {workspaceID} path parameter to -1.

Postman sample file

You can use the Postman sample file to become familiar with making calls to endpoints on the Error Manager service. To download the sample file, click Error 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.

Create an error log

To create an error log, send a POST request with a URL in the following format:

<host>/Relativity.Rest/api/relativity-environment/{versionNumber}/workspaces/-1/errors

The request body contains the following fields

  • createErrorRequest - an object with the following fields:
    • Message - (required) brief summary of what the error log is about.
    • FullError - (optional) long message, call stack or exception details.
    • Server - (optional) server name of where the error occurred.
    • URL - (optional) URL of the resource where the error occurred (if CustomPage or Kepler service).
    • StepsToReproduce - (optional) a few words what user can do to reproduce this error.
    • Workspace - (optional) workspace name
    • ArtifactID - (optional) with which workspace you want to associate this error.
{
    "createErrorRequest": {
        "Message": "Error message",
        "FullError": "Full error message (i.e. exception message)",
        "Server": "Server name",
        "Source": "Source name",
        "URL": "http://relativity.com",
        "StepsToReproduce": "1. Step one, 2. Step two",
        "Workspace": {
            "ArtifactID":-1
        }
    }
}

The newly created ArtifactID of the error log will be returned in the response.

Additional Resources

DevHelp Community GitHub Release Notes NuGet

Share knowledge with the Relativity developer community.

Access tools and resources to build an application.

Review the most recent product release notes.

Create .NET Apps faster with NuGet.