# Relativity

> Work with RelativityOne e-discovery: find and code documents, run saved searches, manage matters, folders and productions, and start workflows when a workspace, document or production arrives or a production finishes.

App · 25 actions. Web page: https://docs.lodol.com/docs/integrations/relativity

## Actions

### Create folder

Create a folder in a workspace, at the top or inside another folder.

**Inputs**

- Workspace (`workspace_id`, text, required): The workspace. Pick one, or give its artifact ID.
- Name (`name`, text, required): The new folder's name.
- Inside folder (`parent_folder_id`, text): The folder to create it in. At the top of the workspace when left empty.

**Outputs**

- `folder` (object): The new folder

**Example output**

```json
{
  "folder": {
    "artifact_id": 1039180,
    "name": "Hot documents",
    "parent_id": 1003697
  }
}
```

### Create matter

Create a matter under a client, Active unless another status is picked, and return it.

**Inputs**

- Name (`name`, text, required): The matter's name.
- Client (`client_id`, text, required): The client the matter is for. Pick one, or give its artifact ID.
- Status (`status_id`, text): The matter's status. Active when left empty.
- Matter number (`number`, text): Your number for the matter, such as 2026-0042.
- Keywords (`keywords`, text): Keywords to find the matter by.
- Notes (`notes`, text): Notes about the matter.

**Outputs**

- `matter` (object): The new matter

**Example output**

```json
{
  "matter": {
    "artifact_id": 1016411,
    "client_id": 1006066,
    "client_name": "Acme Corp",
    "created_on": "2026-03-01T15:04:05.123",
    "keywords": "",
    "last_modified_on": "2026-03-01T15:04:05.123",
    "name": "Smith v. Acme",
    "notes": "",
    "number": "2026-0042",
    "status_id": 671,
    "status_name": "Active"
  }
}
```

### Create production

Create a production set numbered page by page with a Bates prefix. Add its documents (a data source) in Relativity before staging it.

**Inputs**

- Workspace (`workspace_id`, text, required): The workspace. Pick one, or give its artifact ID.
- Name (`name`, text, required): The production's name, such as Volume 001.
- Bates prefix (`bates_prefix`, text, required): The text before each Bates number, such as ACME.
- Bates suffix (`bates_suffix`, text): Text after each Bates number, if any.
- Start number (`start_number`, number): The first Bates number. Defaults to 1. At least 0.
- Number of digits (`number_of_digits`, number): How many digits each Bates number has, padded with zeros. Defaults to 7. From 1 to 20.
- Placeholder image format (`placeholder_format`, text): The image format of placeholders. Defaults to TIFF. One of: `Tiff` (TIFF (default)), `Jpeg`. Default: `Tiff`.
- Email when done (`email_recipients`, text): Email addresses Relativity tells when the production finishes, separated by semicolons.
- Keywords (`keywords`, text): Keywords to find the production by.
- Notes (`notes`, text): Notes about the production.

**Outputs**

- `production` (object): The new production

**Example output**

```json
{
  "production": {
    "bates_prefix": "ACME",
    "date_produced": null,
    "first_bates_value": null,
    "keywords": "",
    "last_bates_value": null,
    "last_run_error": null,
    "last_run_status": null,
    "name": "Volume 001",
    "notes": "",
    "numbering_type": "PageLevel",
    "production_id": 1048147,
    "status": "New",
    "total_document_count": 0,
    "total_images_count": 0
  }
}
```

### Delete matter

Delete a matter. Relativity refuses while a workspace still belongs to it.

**Inputs**

- Matter (`matter_id`, text, required): The matter. Pick one, or give its artifact ID.

**Outputs**

- `deleted` (true/false): True once the matter is deleted
- `matter_id` (number): The deleted matter's artifact ID

**Example output**

```json
{
  "deleted": true,
  "matter_id": 1016411
}
```

### Delete production

Delete a production set. Its documents stay in the workspace.

**Inputs**

- Workspace (`workspace_id`, text, required): The workspace. Pick one, or give its artifact ID.
- Production (`production_id`, text, required): The production. Pick one, or give its artifact ID.

**Outputs**

- `deleted` (true/false): True once the production is deleted
- `production_id` (number): The deleted production's artifact ID

**Example output**

```json
{
  "deleted": true,
  "production_id": 1048147
}
```

### Get document

Get one document's identifier and the fields asked for, such as its custodian, coding or extracted text.

**Inputs**

- Workspace (`workspace_id`, text, required): The workspace. Pick one, or give its artifact ID.
- Document ID (`document_id`, text, required): The document's artifact ID, from 'Query documents', a saved search or a trigger.
- Fields to return (`fields`, list): The fields to read for each record, by their names in Relativity, such as Custodian or Email Subject. Each record's name and artifact ID come back without naming them.

**Outputs**

- `document` (object): The document

**Example output**

```json
{
  "document": {
    "artifact_id": 1038295,
    "fields": {
      "Custodian": "Jane Doe",
      "Email Subject": "Q3 plan"
    },
    "name": "ACME0000001",
    "parent_id": 1003663
  }
}
```

### Get matter

Get one matter with its number, client, status, keywords and notes.

**Inputs**

- Matter (`matter_id`, text, required): The matter. Pick one, or give its artifact ID.

**Outputs**

- `matter` (object): The matter

**Example output**

```json
{
  "matter": {
    "artifact_id": 1016411,
    "client_id": 1006066,
    "client_name": "Acme Corp",
    "created_on": "2026-03-01T15:04:05.123",
    "keywords": "",
    "last_modified_on": "2026-03-01T15:04:05.123",
    "name": "Smith v. Acme",
    "notes": "",
    "number": "2026-0042",
    "status_id": 671,
    "status_name": "Active"
  }
}
```

### Get production

Get one production with its status, Bates range, numbering and counts.

**Inputs**

- Workspace (`workspace_id`, text, required): The workspace. Pick one, or give its artifact ID.
- Production (`production_id`, text, required): The production. Pick one, or give its artifact ID.

**Outputs**

- `production` (object): The production

**Example output**

```json
{
  "production": {
    "bates_prefix": "ACME",
    "date_produced": "2026-03-02T19:23:40.233",
    "first_bates_value": "ACME0000001",
    "keywords": "",
    "last_bates_value": "ACME0000021",
    "last_run_error": null,
    "last_run_status": "Completed",
    "name": "Volume 001",
    "notes": "",
    "numbering_type": "PageLevel",
    "production_id": 1048147,
    "status": "Produced",
    "total_document_count": 7,
    "total_images_count": 21
  }
}
```

### Get production status

Get where a production's job is: its status, how far imaging and producing have got, and any errors.

**Inputs**

- Workspace (`workspace_id`, text, required): The workspace. Pick one, or give its artifact ID.
- Production (`production_id`, text, required): The production. Pick one, or give its artifact ID.

**Outputs**

- `branding_errors` (list): Up to 10 branding errors
- `job_status` (text): The job: NotRunning, Running, Errored or Complete
- `last_run_error` (text): The last run's error, if any
- `last_run_status` (text): What the last run reported
- `number_of_branding_errors` (number): How many images failed branding
- `percentage_imaging` (number): How far imaging has got, in percent
- `percentage_producing` (number): How far producing has got, in percent
- `production_id` (number): The production's artifact ID
- `status` (text): Its status, such as Producing or Produced

**Example output**

```json
{
  "branding_errors": [],
  "job_status": "Running",
  "last_run_error": null,
  "last_run_status": null,
  "number_of_branding_errors": 0,
  "percentage_imaging": 100.0,
  "percentage_producing": 42.5,
  "production_id": 1048147,
  "status": "Producing"
}
```

### Get workspace

Get one workspace with its matter, status, keywords and notes, and how many documents it holds.

**Inputs**

- Workspace (`workspace_id`, text, required): The workspace. Pick one, or give its artifact ID.

**Outputs**

- `workspace` (object): The workspace

**Example output**

```json
{
  "workspace": {
    "artifact_id": 1017266,
    "document_count": 73973,
    "download_handler_url": "Relativity.Distributed",
    "enable_data_grid": false,
    "file_size_bytes": 1048576,
    "keywords": "",
    "matter_id": 1016411,
    "name": "Smith v. Acme",
    "notes": "",
    "status_id": 675
  }
}
```

### List clients

List the clients matters are filed under, newest first. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Name contains (`name`, text): Only clients whose name contains this text.
- Fields to return (`fields`, list): The fields to read for each record, by their names in Relativity, such as Custodian or Email Subject. Each record's name and artifact ID come back without naming them.
- Page (`page`, number): Which page to get, from 1. Use the 'next_page' an earlier run gave to read on. At least 1.
- Page size (`page_size`, number): How many to return, 1 to 1,000. Defaults to 100. From 1 to 1000.

**Outputs**

- `clients` (list): The clients found
- `count` (number): How many are on this page
- `next_page` (number): The next page to ask for, or 0 when this was the last
- `page` (number): The page returned, from 1
- `total_count` (number): How many match in all

**Example output**

```json
{
  "clients": [
    {
      "artifact_id": 1006066,
      "fields": {},
      "name": "Acme Corp",
      "parent_id": 1003663
    }
  ],
  "count": 1,
  "next_page": 0,
  "page": 1,
  "total_count": 1
}
```

### List folders

List a workspace's folders, newest first, each with its parent folder. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Workspace (`workspace_id`, text, required): The workspace. Pick one, or give its artifact ID.
- Name contains (`name`, text): Only folders whose name contains this text.
- Page (`page`, number): Which page to get, from 1. Use the 'next_page' an earlier run gave to read on. At least 1.
- Page size (`page_size`, number): How many to return, 1 to 1,000. Defaults to 100. From 1 to 1000.

**Outputs**

- `count` (number): How many are on this page
- `folders` (list): The folders found
- `next_page` (number): The next page to ask for, or 0 when this was the last
- `page` (number): The page returned, from 1
- `total_count` (number): How many match in all

**Example output**

```json
{
  "count": 1,
  "folders": [
    {
      "artifact_id": 1039027,
      "fields": {},
      "name": "Custodian Jane Doe",
      "parent_id": 1003663
    }
  ],
  "next_page": 0,
  "page": 1,
  "total_count": 1
}
```

### List group members

List the users in a group with their full name and email address. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Group (`group_id`, text, required): The group. Pick one, or give its artifact ID.
- Page (`page`, number): Which page to get, from 1. Use the 'next_page' an earlier run gave to read on. At least 1.
- Page size (`page_size`, number): How many to return, 1 to 1,000. Defaults to 100. From 1 to 1000.

**Outputs**

- `count` (number): How many are on this page
- `group_id` (number): The group's artifact ID
- `members` (list): The group's users
- `next_page` (number): The next page to ask for, or 0 when this was the last
- `page` (number): The page returned, from 1
- `total_count` (number): How many match in all

**Example output**

```json
{
  "count": 1,
  "group_id": 1015005,
  "members": [
    {
      "artifact_id": 1015300,
      "email": "jane@example.com",
      "full_name": "Doe, Jane"
    }
  ],
  "next_page": 0,
  "page": 1,
  "total_count": 1
}
```

### List groups

List user groups, newest first. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Name contains (`name`, text): Only groups whose name contains this text.
- Page (`page`, number): Which page to get, from 1. Use the 'next_page' an earlier run gave to read on. At least 1.
- Page size (`page_size`, number): How many to return, 1 to 1,000. Defaults to 100. From 1 to 1000.

**Outputs**

- `count` (number): How many are on this page
- `groups` (list): The groups found
- `next_page` (number): The next page to ask for, or 0 when this was the last
- `page` (number): The page returned, from 1
- `total_count` (number): How many match in all

**Example output**

```json
{
  "count": 1,
  "groups": [
    {
      "artifact_id": 1015005,
      "fields": {},
      "name": "Review Team",
      "parent_id": 1003663
    }
  ],
  "next_page": 0,
  "page": 1,
  "total_count": 1
}
```

### List matters

List matters, newest first, by name or a condition. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Name contains (`name`, text): Only matters whose name contains this text.
- Condition (`condition`, text): Only records matching this Relativity condition, written as in Relativity's Object Manager: field names in single quotes, such as 'Custodian' == 'Jane Doe' AND 'Date Sent' >= 2024-01-01T00:00:00.00Z.
- Fields to return (`fields`, list): The fields to read for each record, by their names in Relativity, such as Custodian or Email Subject. Each record's name and artifact ID come back without naming them.
- Page (`page`, number): Which page to get, from 1. Use the 'next_page' an earlier run gave to read on. At least 1.
- Page size (`page_size`, number): How many to return, 1 to 1,000. Defaults to 100. From 1 to 1000.

**Outputs**

- `count` (number): How many are on this page
- `matters` (list): The matters found
- `next_page` (number): The next page to ask for, or 0 when this was the last
- `page` (number): The page returned, from 1
- `total_count` (number): How many match in all

**Example output**

```json
{
  "count": 1,
  "matters": [
    {
      "artifact_id": 1016411,
      "fields": {},
      "name": "Smith v. Acme",
      "parent_id": 1003663
    }
  ],
  "next_page": 0,
  "page": 1,
  "total_count": 1
}
```

### List object types

List a workspace's object types, such as custodians or the types an installed application adds. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Workspace (`workspace_id`, text, required): The workspace. Pick one, or give its artifact ID.
- Name contains (`name`, text): Only object types whose name contains this text.
- Page (`page`, number): Which page to get, from 1. Use the 'next_page' an earlier run gave to read on. At least 1.
- Page size (`page_size`, number): How many to return, 1 to 1,000. Defaults to 100. From 1 to 1000.

**Outputs**

- `count` (number): How many are on this page
- `next_page` (number): The next page to ask for, or 0 when this was the last
- `object_types` (list): The object types found
- `page` (number): The page returned, from 1
- `total_count` (number): How many match in all

**Example output**

```json
{
  "count": 1,
  "next_page": 0,
  "object_types": [
    {
      "artifact_id": 1039410,
      "fields": {},
      "name": "Custodian",
      "parent_id": 1003663
    }
  ],
  "page": 1,
  "total_count": 1
}
```

### List productions

List a workspace's productions with their status, Bates range and counts, or only those with one status.

**Inputs**

- Workspace (`workspace_id`, text, required): The workspace. Pick one, or give its artifact ID.
- Status (`status`, text): Only productions with this status, such as Produced or Staged.

**Outputs**

- `count` (number): How many productions were returned
- `productions` (list): The productions

**Example output**

```json
{
  "count": 1,
  "productions": [
    {
      "bates_prefix": "ACME",
      "date_produced": "2026-03-02T19:23:40.233",
      "first_bates_value": "ACME0000001",
      "keywords": "",
      "last_bates_value": "ACME0000021",
      "last_run_error": null,
      "last_run_status": "Completed",
      "name": "Volume 001",
      "notes": "",
      "numbering_type": "PageLevel",
      "production_id": 1048147,
      "status": "Produced",
      "total_document_count": 7,
      "total_images_count": 21
    }
  ]
}
```

### List saved searches

List a workspace's saved searches, newest first. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Workspace (`workspace_id`, text, required): The workspace. Pick one, or give its artifact ID.
- Name contains (`name`, text): Only saved searches whose name contains this text.
- Page (`page`, number): Which page to get, from 1. Use the 'next_page' an earlier run gave to read on. At least 1.
- Page size (`page_size`, number): How many to return, 1 to 1,000. Defaults to 100. From 1 to 1000.

**Outputs**

- `count` (number): How many are on this page
- `next_page` (number): The next page to ask for, or 0 when this was the last
- `page` (number): The page returned, from 1
- `saved_searches` (list): The saved searchs found
- `total_count` (number): How many match in all

**Example output**

```json
{
  "count": 1,
  "next_page": 0,
  "page": 1,
  "saved_searches": [
    {
      "artifact_id": 1039005,
      "fields": {},
      "name": "Responsive, not privileged",
      "parent_id": 1003663
    }
  ],
  "total_count": 1
}
```

### List users

List Relativity users with their full name and email address, newest first, by name or a condition. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Name contains (`name`, text): Only users whose full name contains this text.
- Condition (`condition`, text): Only records matching this Relativity condition, written as in Relativity's Object Manager: field names in single quotes, such as 'Custodian' == 'Jane Doe' AND 'Date Sent' >= 2024-01-01T00:00:00.00Z.
- Fields to return (`fields`, list): The fields to read for each record, by their names in Relativity, such as Custodian or Email Subject. Each record's name and artifact ID come back without naming them.
- Page (`page`, number): Which page to get, from 1. Use the 'next_page' an earlier run gave to read on. At least 1.
- Page size (`page_size`, number): How many to return, 1 to 1,000. Defaults to 100. From 1 to 1000.

**Outputs**

- `count` (number): How many are on this page
- `next_page` (number): The next page to ask for, or 0 when this was the last
- `page` (number): The page returned, from 1
- `total_count` (number): How many match in all
- `users` (list): The users found

**Example output**

```json
{
  "count": 1,
  "next_page": 0,
  "page": 1,
  "total_count": 1,
  "users": [
    {
      "artifact_id": 1015300,
      "fields": {
        "E-mail Address": "jane@example.com",
        "Full Name": "Doe, Jane"
      },
      "name": "Doe, Jane",
      "parent_id": 1003663
    }
  ]
}
```

### List workspaces

List the workspaces the OAuth2 client's user can see, newest first, by name or a condition. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Name contains (`name`, text): Only workspaces whose name contains this text.
- Condition (`condition`, text): Only records matching this Relativity condition, written as in Relativity's Object Manager: field names in single quotes, such as 'Custodian' == 'Jane Doe' AND 'Date Sent' >= 2024-01-01T00:00:00.00Z.
- Fields to return (`fields`, list): The fields to read for each record, by their names in Relativity, such as Custodian or Email Subject. Each record's name and artifact ID come back without naming them.
- Page (`page`, number): Which page to get, from 1. Use the 'next_page' an earlier run gave to read on. At least 1.
- Page size (`page_size`, number): How many to return, 1 to 1,000. Defaults to 100. From 1 to 1000.

**Outputs**

- `count` (number): How many are on this page
- `next_page` (number): The next page to ask for, or 0 when this was the last
- `page` (number): The page returned, from 1
- `total_count` (number): How many match in all
- `workspaces` (list): The workspaces found

**Example output**

```json
{
  "count": 1,
  "next_page": 0,
  "page": 1,
  "total_count": 1,
  "workspaces": [
    {
      "artifact_id": 1017266,
      "fields": {},
      "name": "Smith v. Acme",
      "parent_id": 1003663
    }
  ]
}
```

### Query documents

Find a workspace's documents matching a condition, with the fields asked for, newest first or sorted by a field. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Workspace (`workspace_id`, text, required): The workspace. Pick one, or give its artifact ID.
- Condition (`condition`, text): Only records matching this Relativity condition, written as in Relativity's Object Manager: field names in single quotes, such as 'Custodian' == 'Jane Doe' AND 'Date Sent' >= 2024-01-01T00:00:00.00Z.
- Fields to return (`fields`, list): The fields to read for each record, by their names in Relativity, such as Custodian or Email Subject. Each record's name and artifact ID come back without naming them.
- Sort by field (`sort_by`, text): A field to sort by, by its name. Newest first when left empty.
- Sort direction (`sort_direction`, text): Which way to sort by that field. Defaults to oldest or lowest first. One of: `Descending` (Newest or highest first), `Ascending` (Oldest or lowest first). Default: `Ascending`.
- Page (`page`, number): Which page to get, from 1. Use the 'next_page' an earlier run gave to read on. At least 1.
- Page size (`page_size`, number): How many to return, 1 to 1,000. Defaults to 100. From 1 to 1000.

**Outputs**

- `count` (number): How many are on this page
- `documents` (list): The documents found
- `next_page` (number): The next page to ask for, or 0 when this was the last
- `page` (number): The page returned, from 1
- `total_count` (number): How many match in all

**Example output**

```json
{
  "count": 1,
  "documents": [
    {
      "artifact_id": 1038295,
      "fields": {
        "Custodian": "Jane Doe",
        "Email Subject": "Q3 plan"
      },
      "name": "ACME0000001",
      "parent_id": 1003663
    }
  ],
  "next_page": 0,
  "page": 1,
  "total_count": 1
}
```

### Query objects

Find the objects of one type in a workspace, such as custodians or Legal Hold projects, by a condition, with the fields asked for. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Workspace (`workspace_id`, text, required): The workspace. Pick one, or give its artifact ID.
- Object type (`object_type`, text, required): The type of object. Pick one, or give its name.
- Condition (`condition`, text): Only records matching this Relativity condition, written as in Relativity's Object Manager: field names in single quotes, such as 'Custodian' == 'Jane Doe' AND 'Date Sent' >= 2024-01-01T00:00:00.00Z.
- Fields to return (`fields`, list): The fields to read for each record, by their names in Relativity, such as Custodian or Email Subject. Each record's name and artifact ID come back without naming them.
- Sort by field (`sort_by`, text): A field to sort by, by its name. Newest first when left empty.
- Sort direction (`sort_direction`, text): Which way to sort by that field. Defaults to oldest or lowest first. One of: `Descending` (Newest or highest first), `Ascending` (Oldest or lowest first). Default: `Ascending`.
- Page (`page`, number): Which page to get, from 1. Use the 'next_page' an earlier run gave to read on. At least 1.
- Page size (`page_size`, number): How many to return, 1 to 1,000. Defaults to 100. From 1 to 1000.

**Outputs**

- `count` (number): How many are on this page
- `next_page` (number): The next page to ask for, or 0 when this was the last
- `object_type` (text): The object type queried
- `objects` (list): The objects found
- `page` (number): The page returned, from 1
- `total_count` (number): How many match in all

**Example output**

```json
{
  "count": 1,
  "next_page": 0,
  "object_type": "Custodian",
  "objects": [
    {
      "artifact_id": 1039500,
      "fields": {
        "Department": "Finance"
      },
      "name": "Jane Doe",
      "parent_id": 1003663
    }
  ],
  "page": 1,
  "total_count": 1
}
```

### Run saved search

Get the documents a saved search returns now, with the fields asked for. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Workspace (`workspace_id`, text, required): The workspace. Pick one, or give its artifact ID.
- Saved search (`saved_search_id`, text, required): The saved search. Pick one, or give its artifact ID.
- Fields to return (`fields`, list): The fields to read for each record, by their names in Relativity, such as Custodian or Email Subject. Each record's name and artifact ID come back without naming them.
- Page (`page`, number): Which page to get, from 1. Use the 'next_page' an earlier run gave to read on. At least 1.
- Page size (`page_size`, number): How many to return, 1 to 1,000. Defaults to 100. From 1 to 1000.

**Outputs**

- `count` (number): How many are on this page
- `documents` (list): The documents found
- `next_page` (number): The next page to ask for, or 0 when this was the last
- `page` (number): The page returned, from 1
- `saved_search_id` (number): The saved search's artifact ID
- `total_count` (number): How many match in all

**Example output**

```json
{
  "count": 1,
  "documents": [
    {
      "artifact_id": 1038295,
      "fields": {
        "Custodian": "Jane Doe",
        "Email Subject": "Q3 plan"
      },
      "name": "ACME0000001",
      "parent_id": 1003663
    }
  ],
  "next_page": 0,
  "page": 1,
  "saved_search_id": 1039005,
  "total_count": 1
}
```

### Stage and run production

Start a production: stage it and run it, only stage it, or run one already staged. Returns once Relativity has queued the job; use 'Get production status' or the 'Production produced' trigger to follow it.

**Inputs**

- Workspace (`workspace_id`, text, required): The workspace. Pick one, or give its artifact ID.
- Production (`production_id`, text, required): The production. Pick one, or give its artifact ID.
- What to do (`mode`, text): Stage then run, stage only, or run a staged production. One of: `stage_and_run` (Stage, then run (default)), `stage` (Stage only), `run` (Run a production already staged). Default: `stage_and_run`.
- Ignore warnings (`suppress_warnings`, true/false): When running a staged production, run it despite warnings. Only when What to do is Run a production already staged.
- Override conflicts (`override_conflicts`, true/false): When running a staged production, produce documents that conflict with another production anyway. Only when What to do is Run a production already staged.

**Outputs**

- `job` (object): The production job Relativity queued
- `mode` (text): What was started: stage_and_run, stage or run

**Example output**

```json
{
  "job": {
    "errors": [],
    "job_id": 52,
    "messages": [],
    "production_id": 1048147,
    "warnings": [],
    "was_job_created": true,
    "workspace_id": 1017266
  },
  "mode": "stage_and_run"
}
```

### Update document fields

Set field values on a document, such as coding a yes/no field or filling in a text field. Relativity's event handlers still apply.

**Inputs**

- Workspace (`workspace_id`, text, required): The workspace. Pick one, or give its artifact ID.
- Document ID (`document_id`, text, required): The document's artifact ID, from 'Query documents', a saved search or a trigger.
- Field values (`field_values`, object, required): Each field to set, by its name in Relativity, with its new value: text, a number, true or false, a date such as 2026-03-01T00:00:00Z, or for a choice {"ArtifactID": 1039123}.

**Outputs**

- `document_id` (number): The document's artifact ID
- `fields_updated` (list): The fields set
- `updated` (true/false): True once Relativity saved the values

**Example output**

```json
{
  "document_id": 1038295,
  "fields_updated": [
    "Responsive"
  ],
  "updated": true
}
```
