Production Data Source Manager (REST)

A production data source associates a production with a set of documents returned by a saved search. The save search is used to identify the documents to be produced for distribution to legal counsel. For general information, see Production data source on the RelativityOne Documentation site.

The Production Data Source Manager service supports the following functionality:

  • CRUD operations on data sources
  • Retrieving default field values for a data source

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

This page contains the following information:

See these related pages:

Guidelines for productions in REST

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 {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.

The following example illustrates how to set the path parameters when deleting a data source, but the same convention applies to all URLs in the Production APIs:

<host>/Relativity.REST/api/relativity-productions/{versionNumber}/workspaces/{WorkspaceID}/production-data-sources/{DataSourceID}

Set the path parameters as follows:

  • {versionNumber} to the version of the API, such as v1.
  • {WorkspaceID} to the Artifact ID of the workspace that contains the data source.
  • {DataSourceID} to the Artifact ID of a specific data source.

Create a data source

To create a data source, send a POST request with a URL in the following format:

<host>/Relativity.REST/api/relativity-productions/{versionNumber}/workspaces/{WorkspaceID}/productions/{ProductionID}/production-data-sources

The response contains the Artifact ID of the new data source.

1051307

Retrieve a data source

To read a data source, send a GET request with a URL in the following format:

<host>/Relativity.REST/api/relativity-productions/{versionNumber}/workspaces/{WorkspaceID}/production-data-sources/{DataSourceID}?withPlaceholderImage={WithPlaceholderImage}}

You can pass an optional variable called withPlaceholderImage to return placeholder images for a data source as follows:

  • withPlaceholderImage = true - populates values for read-only placeholder image properties on the data source. The placeholder image is available only for data sources with produced productions.
  • withPlaceholderImage = false - doesn't populate any placeholder image properties. The default setting is false.

The request body is empty.

The response for a read operation contains the same fields as a request for a create operation. See the field descriptions in Create a data source. Additionally, the read response contains the Artifact ID of the data source.

Update a data source

To update a data source, send a PUT request with a URL in the following format:

<host>/Relativity.REST/api/relativity-productions/{versionNumber}/workspaces/{WorkspaceID}/productions/{ProductionID}/production-data-sources

The request for an update operation contains the same fields as a request for a create operation. See the field descriptions in Create a data source. Additionally, the update request contains the Artifact ID of the data source.

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

Delete a data source

To delete a data source, send a DELETE request with a URL in the following format:

<host>/Relativity.REST/api/relativity-productions/{versionNumber}/workspaces/{WorkspaceID}/production-data-sources/{DataSourceID}

The request body is empty.

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

Retrieve default field values for a data source

To retrieve default field values for a data source, send a GET request with a URL in the following format:

<host>/Relativity.REST/api/relativity-productions/{versionNumber}/workspaces/{workspaceID}/production-data-sources/defaults

The request body is empty.

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.