> ## Documentation Index
> Fetch the complete documentation index at: https://docs.siftstack.com/llms.txt
> Use this file to discover all available pages before exploring further.

# test_reports

> sift/test_reports/v1/test_reports.proto

<a name="sift_test_reports_v1_test_reports-proto" />

<a name="sift_test_reports_v1_test_reports-proto-services" />

## Services

*RPC methods exposed by this API.*

### TestReportService

| Method                 | Request                                                         | Response                                                          | Description                                            |
| :--------------------- | :-------------------------------------------------------------- | :---------------------------------------------------------------- | :----------------------------------------------------- |
| ImportTestReport       | [ImportTestReportRequest](#importtestreportrequest)             | [ImportTestReportResponse](#importtestreportresponse)             | Imports a test report from an already-uploaded file    |
| CreateTestReport       | [CreateTestReportRequest](#createtestreportrequest)             | [CreateTestReportResponse](#createtestreportresponse)             | Creates a test report                                  |
| GetTestReport          | [GetTestReportRequest](#gettestreportrequest)                   | [GetTestReportResponse](#gettestreportresponse)                   | Gets a single test report                              |
| ListTestReports        | [ListTestReportsRequest](#listtestreportsrequest)               | [ListTestReportsResponse](#listtestreportsresponse)               | Lists test reports with optional filtering             |
| UpdateTestReport       | [UpdateTestReportRequest](#updatetestreportrequest)             | [UpdateTestReportResponse](#updatetestreportresponse)             | Updates a test report                                  |
| DeleteTestReport       | [DeleteTestReportRequest](#deletetestreportrequest)             | [DeleteTestReportResponse](#deletetestreportresponse)             | Deletes a test report                                  |
| CreateTestStep         | [CreateTestStepRequest](#createteststeprequest)                 | [CreateTestStepResponse](#createteststepresponse)                 | Creates a test step                                    |
| ListTestSteps          | [ListTestStepsRequest](#listteststepsrequest)                   | [ListTestStepsResponse](#listteststepsresponse)                   | Lists test steps with optional filtering               |
| UpdateTestStep         | [UpdateTestStepRequest](#updateteststeprequest)                 | [UpdateTestStepResponse](#updateteststepresponse)                 | Updates a test step                                    |
| DeleteTestStep         | [DeleteTestStepRequest](#deleteteststeprequest)                 | [DeleteTestStepResponse](#deleteteststepresponse)                 | Deletes a test step                                    |
| CreateTestMeasurement  | [CreateTestMeasurementRequest](#createtestmeasurementrequest)   | [CreateTestMeasurementResponse](#createtestmeasurementresponse)   | Creates a test measurement                             |
| CreateTestMeasurements | [CreateTestMeasurementsRequest](#createtestmeasurementsrequest) | [CreateTestMeasurementsResponse](#createtestmeasurementsresponse) | Creates multiple test measurements in a single request |
| ListTestMeasurements   | [ListTestMeasurementsRequest](#listtestmeasurementsrequest)     | [ListTestMeasurementsResponse](#listtestmeasurementsresponse)     | Lists test measurements with optional filtering        |
| CountTestSteps         | [CountTestStepsRequest](#countteststepsrequest)                 | [CountTestStepsResponse](#countteststepsresponse)                 | Counts test steps with optional filtering              |
| CountTestMeasurements  | [CountTestMeasurementsRequest](#counttestmeasurementsrequest)   | [CountTestMeasurementsResponse](#counttestmeasurementsresponse)   | Counts test measurements with optional filtering       |
| UpdateTestMeasurement  | [UpdateTestMeasurementRequest](#updatetestmeasurementrequest)   | [UpdateTestMeasurementResponse](#updatetestmeasurementresponse)   | Updates a test measurement                             |
| DeleteTestMeasurement  | [DeleteTestMeasurementRequest](#deletetestmeasurementrequest)   | [DeleteTestMeasurementResponse](#deletetestmeasurementresponse)   | Deletes a test measurement                             |

<a name="sift_test_reports_v1_test_reports-proto-messages" />

## Messages

*Data models used across requests/responses.*

### CountTestMeasurementsRequest

Request message for CountTestMeasurements

| Field  | Type   | Label | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| :----- | :----- | :---- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| filter | string |       | A [Common Expression Language (CEL)](https://github.com/google/cel-spec) filter string. Available fields to filter by are `measurement_id`, `measurement_type`, `name`, `test_step_id`, `test_report_id`, `numeric_value`, `string_value`, `boolean_value`, `passed`, `timestamp`, `created_date`, `modified_date`, and `metadata`. Metadata can be used in filters by using `metadata.{metadata_key_name}` as the field name. For further information about how to use CELs, please refer to [this guide](https://github.com/google/cel-spec/blob/master/doc/langdef.md#standard-definitions). For more information about the fields used for filtering, please refer to [this definition](/docs/api/grpc/protocol-buffers/test-results#testmeasurement). Optional. |

### CountTestMeasurementsResponse

Response message for CountTestMeasurements

| Field | Type  | Label | Description                                              |
| :---- | :---- | :---- | :------------------------------------------------------- |
| count | int64 |       | The total count of test measurements matching the filter |

### CountTestStepsRequest

Request message for CountTestSteps

| Field  | Type   | Label | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| :----- | :----- | :---- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| filter | string |       | A [Common Expression Language (CEL)](https://github.com/google/cel-spec) filter string. Available fields to filter by are `test_step_id`, `test_report_id`, `parent_step_id`, `name`, `description`, `step_type`, `step_path`, `status`, `start_time`, `end_time`, `error_code`, `error_message`, `created_date`, `modified_date`, and `metadata`. Metadata can be used in filters by using `metadata.{metadata_key_name}` as the field name. For further information about how to use CELs, please refer to [this guide](https://github.com/google/cel-spec/blob/master/doc/langdef.md#standard-definitions). For more information about the fields used for filtering, please refer to [this definition](/docs/api/grpc/protocol-buffers/test-results#teststep). Optional. |

### CountTestStepsResponse

Response message for CountTestSteps

| Field | Type  | Label | Description                                       |
| :---- | :---- | :---- | :------------------------------------------------ |
| count | int64 |       | The total count of test steps matching the filter |

### CreateTestMeasurementRequest

Request message for CreateTestMeasurement

| Field             | Type                                | Label | Description                    |
| :---------------- | :---------------------------------- | :---- | :----------------------------- |
| test\_measurement | [TestMeasurement](#testmeasurement) |       | The test measurement to create |

### CreateTestMeasurementResponse

Response message for CreateTestMeasurement

| Field             | Type                                | Label | Description                  |
| :---------------- | :---------------------------------- | :---- | :--------------------------- |
| test\_measurement | [TestMeasurement](#testmeasurement) |       | The created test measurement |

### CreateTestMeasurementsRequest

Request message for CreateTestMeasurements

| Field              | Type                                | Label    | Description                     |
| :----------------- | :---------------------------------- | :------- | :------------------------------ |
| test\_measurements | [TestMeasurement](#testmeasurement) | repeated | The test measurements to create |

### CreateTestMeasurementsResponse

Response message for CreateTestMeasurements

| Field                        | Type   | Label    | Description                                          |
| :--------------------------- | :----- | :------- | :--------------------------------------------------- |
| measurements\_created\_count | int32  |          | The number of test measurements successfully created |
| measurement\_ids             | string | repeated | The IDs of the created test measurements             |

### CreateTestReportRequest

Request message for CreateTestReport

| Field              | Type                                                              | Label    | Description                                       |
| :----------------- | :---------------------------------------------------------------- | :------- | :------------------------------------------------ |
| status             | [TestStatus](#teststatus)                                         |          | The status of the test run                        |
| name               | string                                                            |          | The name of the test run                          |
| test\_system\_name | string                                                            |          | The name of the test system                       |
| test\_case         | string                                                            |          | The test case that was run                        |
| start\_time        | google.protobuf.Timestamp                                         |          | The start time of the test run                    |
| end\_time          | google.protobuf.Timestamp                                         |          | The end time of the test run                      |
| metadata           | [sift.metadata.v1.MetadataValue](#sift-metadata-v1-metadatavalue) | repeated | The metadata values associated with this test run |
| serial\_number     | string                                                            |          | The serial number for the DUT                     |
| part\_number       | string                                                            |          | The part number for the DUT                       |
| system\_operator   | string                                                            |          | Unique identifier for user owner                  |
| run\_id            | string                                                            |          | The run ID for the test report                    |

### CreateTestReportResponse

Response message for CreateTestReport

| Field        | Type                      | Label | Description             |
| :----------- | :------------------------ | :---- | :---------------------- |
| test\_report | [TestReport](#testreport) |       | The created test report |

### CreateTestStepRequest

Request message for CreateTestStep

| Field      | Type                  | Label | Description             |
| :--------- | :-------------------- | :---- | :---------------------- |
| test\_step | [TestStep](#teststep) |       | The test step to create |

### CreateTestStepResponse

Response message for CreateTestStep

| Field      | Type                  | Label | Description           |
| :--------- | :-------------------- | :---- | :-------------------- |
| test\_step | [TestStep](#teststep) |       | The created test step |

### DeleteTestMeasurementRequest

Request message for DeleteTestMeasurement

| Field           | Type   | Label | Description                              |
| :-------------- | :----- | :---- | :--------------------------------------- |
| measurement\_id | string |       | The ID of the test measurement to delete |

### DeleteTestMeasurementResponse

Response message for DeleteTestMeasurement

Empty response indicating successful deletion

*This message has no fields.*

### DeleteTestReportRequest

Request message for DeleteTestReport

| Field            | Type   | Label | Description                         |
| :--------------- | :----- | :---- | :---------------------------------- |
| test\_report\_id | string |       | The ID of the test report to delete |

### DeleteTestReportResponse

Response message for DeleteTestReport

Empty response indicating successful deletion

*This message has no fields.*

### DeleteTestStepRequest

Request message for DeleteTestStep

| Field          | Type   | Label | Description                       |
| :------------- | :----- | :---- | :-------------------------------- |
| test\_step\_id | string |       | The ID of the test step to delete |

### DeleteTestStepResponse

Response message for DeleteTestStep

Empty response indicating successful deletion

*This message has no fields.*

### ErrorInfo

| Field          | Type   | Label | Description |
| :------------- | :----- | :---- | :---------- |
| error\_code    | int32  |       |             |
| error\_message | string |       |             |

### GetTestReportRequest

Request message for GetTestReport

| Field            | Type   | Label | Description                      |
| :--------------- | :----- | :---- | :------------------------------- |
| test\_report\_id | string |       | The ID of the test report to get |

### GetTestReportResponse

Response message for GetTestReport

| Field        | Type                      | Label | Description     |
| :----------- | :------------------------ | :---- | :-------------- |
| test\_report | [TestReport](#testreport) |       | The test report |

### ImportTestReportRequest

Request message for ImportTestReport

| Field            | Type   | Label | Description                                     |
| :--------------- | :----- | :---- | :---------------------------------------------- |
| remote\_file\_id | string |       | The remote file ID containing the XML test data |

### ImportTestReportResponse

Response message for ImportTestReport

| Field        | Type                      | Label | Description              |
| :----------- | :------------------------ | :---- | :----------------------- |
| test\_report | [TestReport](#testreport) |       | The imported test report |

### ListTestMeasurementsRequest

Request message for ListTestMeasurements

| Field       | Type   | Label | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| :---------- | :----- | :---- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| page\_size  | uint32 |       | The maximum number of test measurements to return. The service may return fewer than this value. If unspecified, at most 50 test measurements will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| page\_token | string |       | A page token, received from a previous `ListTestMeasurements` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListTestMeasurements` must match the call that provided the page token.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| filter      | string |       | A [Common Expression Language (CEL)](https://github.com/google/cel-spec) filter string. Available fields to filter by are `measurement_id`, `measurement_type`, `name`, `test_step_id`, `test_report_id`, `numeric_value`, `string_value`, `boolean_value`, `passed`, `timestamp`, `created_date`, `modified_date`, and `metadata`. Metadata can be used in filters by using `metadata.{metadata_key_name}` as the field name. For further information about how to use CELs, please refer to [this guide](https://github.com/google/cel-spec/blob/master/doc/langdef.md#standard-definitions). For more information about the fields used for filtering, please refer to [this definition](/docs/api/grpc/protocol-buffers/test-results#testmeasurement). Optional. |
| order\_by   | string |       | How to order the retrieved test measurements. Formatted as a comma-separated string i.e. "FIELD\_NAME\[ desc],...". Available fields to order\_by are `measurement_id`, `name`, `measurement_type`, `test_step_id`, `test_report_id`, `passed`, `timestamp`, `created_date`, and `modified_date`. If left empty, items are ordered by `timestamp` in ascending order. For more information about the format of this field, read [this](https://google.aip.dev/132#ordering) Example: "timestamp asc,name"                                                                                                                                                                                                                                                            |

### ListTestMeasurementsResponse

Response message for ListTestMeasurements

| Field              | Type                                | Label    | Description                        |
| :----------------- | :---------------------------------- | :------- | :--------------------------------- |
| test\_measurements | [TestMeasurement](#testmeasurement) | repeated | The list of test measurements      |
| next\_page\_token  | string                              |          | The next page token for pagination |

### ListTestReportsRequest

Request message for ListTestReports

| Field       | Type   | Label | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| :---------- | :----- | :---- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| page\_size  | uint32 |       | The maximum number of test reports to return. The service may return fewer than this value. If unspecified, at most 50 test reports will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| page\_token | string |       | A page token, received from a previous `ListTestReports` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListTestReports` must match the call that provided the page token.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| filter      | string |       | A [Common Expression Language (CEL)](https://github.com/google/cel-spec) filter string. Available fields to filter by are `test_report_id`, `status`, `name`, `test_system_name`, `test_case`, `start_time`, `end_time`, `serial_number`, `created_by_user_id`, `modified_by_user_id`, `part_number`, `system_operator`, `run_id`, `archived_date`, and `metadata`. Metadata can be used in filters by using `metadata.{metadata_key_name}` as the field name. For further information about how to use CELs, please refer to [this guide](https://github.com/google/cel-spec/blob/master/doc/langdef.md#standard-definitions). For more information about the fields used for filtering, please refer to [this definition](/docs/api/grpc/protocol-buffers/test-results#testreport). Optional. |
| order\_by   | string |       | How to order the retrieved test reports. Formatted as a comma-separated string i.e. "FIELD\_NAME\[ desc],...". Available fields to order\_by are `test_report_id`, `name`, `test_system_name`, `test_case`, `start_time`, `end_time`, `created_date`, and `modified_date`. If left empty, items are ordered by `start_time` in descending order (newest-first). For more information about the format of this field, read [this](https://google.aip.dev/132#ordering) Example: "start\_time desc,name"                                                                                                                                                                                                                                                                                          |

### ListTestReportsResponse

Response message for ListTestReports

| Field             | Type                      | Label    | Description                        |
| :---------------- | :------------------------ | :------- | :--------------------------------- |
| test\_reports     | [TestReport](#testreport) | repeated | The list of test reports           |
| next\_page\_token | string                    |          | The next page token for pagination |

### ListTestStepsRequest

Request message for ListTestSteps

| Field       | Type   | Label | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| :---------- | :----- | :---- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| page\_size  | uint32 |       | The maximum number of test steps to return. The service may return fewer than this value. If unspecified, at most 50 test steps will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| page\_token | string |       | A page token, received from a previous `ListTestSteps` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListTestSteps` must match the call that provided the page token.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| filter      | string |       | A [Common Expression Language (CEL)](https://github.com/google/cel-spec) filter string. Available fields to filter by are `test_step_id`, `test_report_id`, `parent_step_id`, `name`, `description`, `step_type`, `step_path`, `status`, `start_time`, `end_time`, `error_code`, `error_message`, `created_date`, `modified_date`, and `metadata`. Metadata can be used in filters by using `metadata.{metadata_key_name}` as the field name. For further information about how to use CELs, please refer to [this guide](https://github.com/google/cel-spec/blob/master/doc/langdef.md#standard-definitions). For more information about the fields used for filtering, please refer to [this definition](/docs/api/grpc/protocol-buffers/test-results#teststep). Optional. |
| order\_by   | string |       | How to order the retrieved test steps. Formatted as a comma-separated string i.e. "FIELD\_NAME\[ desc],...". Available fields to order\_by are `test_step_id`, `name`, `step_type`, `step_path`, `status`, `start_time`, `end_time`, `created_date`, and `modified_date`. If left empty, items are ordered by `step_path` in ascending order. For more information about the format of this field, read [this](https://google.aip.dev/132#ordering) Example: "step\_path asc,start\_time desc"                                                                                                                                                                                                                                                                               |

### ListTestStepsResponse

Response message for ListTestSteps

| Field             | Type                  | Label    | Description                        |
| :---------------- | :-------------------- | :------- | :--------------------------------- |
| test\_steps       | [TestStep](#teststep) | repeated | The list of test steps             |
| next\_page\_token | string                |          | The next page token for pagination |

### NumericBounds

| Field | Type   | Label    | Description |
| :---- | :----- | :------- | :---------- |
| min   | double | optional |             |
| max   | double | optional |             |

### StringBounds

| Field           | Type   | Label | Description |
| :-------------- | :----- | :---- | :---------- |
| expected\_value | string |       |             |

### TestMeasurement

| Field                         | Type                                                              | Label    | Description                                                                                                                                                    |
| :---------------------------- | :---------------------------------------------------------------- | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| measurement\_id               | string                                                            |          |                                                                                                                                                                |
| measurement\_type             | [TestMeasurementType](#testmeasurementtype)                       |          |                                                                                                                                                                |
| name                          | string                                                            |          |                                                                                                                                                                |
| test\_step\_id                | string                                                            |          |                                                                                                                                                                |
| test\_report\_id              | string                                                            |          |                                                                                                                                                                |
| oneof value. numeric\_value   | double                                                            |          |                                                                                                                                                                |
| oneof value. string\_value    | string                                                            |          |                                                                                                                                                                |
| oneof value. boolean\_value   | bool                                                              |          |                                                                                                                                                                |
| unit                          | [sift.unit.v2.Unit](#sift-unit-v2-unit)                           |          |                                                                                                                                                                |
| oneof bounds. numeric\_bounds | [NumericBounds](#numericbounds)                                   |          |                                                                                                                                                                |
| oneof bounds. string\_bounds  | [StringBounds](#stringbounds)                                     |          |                                                                                                                                                                |
| passed                        | bool                                                              |          |                                                                                                                                                                |
| timestamp                     | google.protobuf.Timestamp                                         |          |                                                                                                                                                                |
| description                   | string                                                            |          | Description or note about the measurement                                                                                                                      |
| channel\_names                | string                                                            | repeated | Names of Sift channels this measurement is associated with. Allows cross-plotting in Explore using the Report's associated Run to resolve channels from names. |
| metadata                      | [sift.metadata.v1.MetadataValue](#sift-metadata-v1-metadatavalue) | repeated | The metadata values associated with this measurement                                                                                                           |

### TestReport

| Field              | Type                                                              | Label    | Description                                            |
| :----------------- | :---------------------------------------------------------------- | :------- | :----------------------------------------------------- |
| test\_report\_id   | string                                                            |          | Unique identifier for the run                          |
| status             | [TestStatus](#teststatus)                                         |          | The status of the test run                             |
| name               | string                                                            |          | The name of the test run                               |
| test\_system\_name | string                                                            |          | The name of the test system                            |
| test\_case         | string                                                            |          | The test case that was run                             |
| start\_time        | google.protobuf.Timestamp                                         |          | The start time of the test run                         |
| end\_time          | google.protobuf.Timestamp                                         |          | The end time of the test run                           |
| metadata           | [sift.metadata.v1.MetadataValue](#sift-metadata-v1-metadatavalue) | repeated | The metadata values associated with this test run      |
| serial\_number     | string                                                            |          | The serial number for the DUT                          |
| part\_number       | string                                                            |          | The part number for the DUT                            |
| system\_operator   | string                                                            |          | Unique identifier for user owner                       |
| archived\_date     | google.protobuf.Timestamp                                         |          | The date and time the test run was archived (internal) |
| is\_archived       | bool                                                              |          | Whether the test run is archived (externally exposed)  |
| run\_id            | string                                                            |          | The run ID for the test run                            |

### TestStep

| Field            | Type                                                              | Label    | Description                                        |
| :--------------- | :---------------------------------------------------------------- | :------- | :------------------------------------------------- |
| test\_step\_id   | string                                                            |          | unique identifier for the step                     |
| test\_report\_id | string                                                            |          | pointer to overall test run                        |
| parent\_step\_id | string                                                            |          | pointer to parent step, if any                     |
| name             | string                                                            |          | Name of the test step for display                  |
| description      | string                                                            |          | Description of the test step from test controller  |
| step\_type       | [TestStepType](#teststeptype)                                     |          | Semantic type of the test step                     |
| step\_path       | string                                                            |          | Hierarchical path (e.g., "1", "1.1", "1.2.3")      |
| status           | [TestStatus](#teststatus)                                         |          | Status of the test step                            |
| start\_time      | google.protobuf.Timestamp                                         |          | Start time of the test step                        |
| end\_time        | google.protobuf.Timestamp                                         |          | End time of the test step                          |
| error\_info      | [ErrorInfo](#errorinfo)                                           |          | Error information of the test step                 |
| metadata         | [sift.metadata.v1.MetadataValue](#sift-metadata-v1-metadatavalue) | repeated | The metadata values associated with this test step |

### UpdateTestMeasurementRequest

Request message for UpdateTestMeasurement

| Field             | Type                                                    | Label | Description                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| :---------------- | :------------------------------------------------------ | :---- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| test\_measurement | [TestMeasurement](#testmeasurement)                     |       | The test measurement to update                                                                                                                                                                                                                                                                                                                                                                                                                          |
| update\_mask      | [google.protobuf.FieldMask](#google-protobuf-fieldmask) |       | The field mask specifying which fields to update. The fields available to be updated are `name`, `measurement_type`, `numeric_value`, `string_value`, `boolean_value`, `unit`, `numeric_bounds`, `string_bounds`, `passed`, `timestamp`, `description`, and `channel_names` and `metadata`. When `metadata` is in the mask, the supplied list replaces all existing metadata for the measurement; sending an empty or omitted list clears all metadata. |

### UpdateTestMeasurementResponse

Response message for UpdateTestMeasurement

| Field             | Type                                | Label | Description                  |
| :---------------- | :---------------------------------- | :---- | :--------------------------- |
| test\_measurement | [TestMeasurement](#testmeasurement) |       | The updated test measurement |

### UpdateTestReportRequest

Request message for UpdateTestReport

| Field        | Type                                                    | Label | Description                                                                                                                                                                                                                                           |
| :----------- | :------------------------------------------------------ | :---- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| test\_report | [TestReport](#testreport)                               |       | The test report to update                                                                                                                                                                                                                             |
| update\_mask | [google.protobuf.FieldMask](#google-protobuf-fieldmask) |       | The field mask specifying which fields to update. The fields available to be updated are `status`, `name`, `test_system_name`, `test_case`, `start_time`, `end_time`, `serial_number`, `part_number`, `system_operator`, `run_id`, and `is_archived`. |

### UpdateTestReportResponse

Response message for UpdateTestReport

| Field        | Type                      | Label | Description             |
| :----------- | :------------------------ | :---- | :---------------------- |
| test\_report | [TestReport](#testreport) |       | The updated test report |

### UpdateTestStepRequest

Request message for UpdateTestStep

| Field        | Type                                                    | Label | Description                                                                                                                                                                                                                                                                                                                                                                        |
| :----------- | :------------------------------------------------------ | :---- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| test\_step   | [TestStep](#teststep)                                   |       | The test step to update                                                                                                                                                                                                                                                                                                                                                            |
| update\_mask | [google.protobuf.FieldMask](#google-protobuf-fieldmask) |       | The field mask specifying which fields to update. The fields available to be updated are `name`, `description`, `step_type`, `step_path`, `test_case`, `status`, `start_time`, `end_time`, `error_info`, and `metadata`. When `metadata` is in the mask, the supplied list replaces all existing metadata for the test step; sending an empty or omitted list clears all metadata. |

### UpdateTestStepResponse

Response message for UpdateTestStep

| Field      | Type                  | Label | Description           |
| :--------- | :-------------------- | :---- | :-------------------- |
| test\_step | [TestStep](#teststep) |       | The updated test step |

<a name="sift_test_reports_v1_test_reports-proto-enums" />

## Enums

*Allowed constant values used in message fields.*

### TestMeasurementType

| Name                                 | Number | Description |
| :----------------------------------- | :----- | :---------- |
| TEST\_MEASUREMENT\_TYPE\_UNSPECIFIED | 0      |             |
| TEST\_MEASUREMENT\_TYPE\_DOUBLE      | 1      |             |
| TEST\_MEASUREMENT\_TYPE\_STRING      | 3      |             |
| TEST\_MEASUREMENT\_TYPE\_BOOLEAN     | 4      |             |
| TEST\_MEASUREMENT\_TYPE\_LIMIT       | 5      |             |

### TestStatus

| Name                       | Number | Description                                                |
| :------------------------- | :----- | :--------------------------------------------------------- |
| TEST\_STATUS\_UNSPECIFIED  | 0      |                                                            |
| TEST\_STATUS\_DRAFT        | 1      | Barebones test report created, waiting for file processing |
| TEST\_STATUS\_PASSED       | 2      |                                                            |
| TEST\_STATUS\_FAILED       | 3      |                                                            |
| TEST\_STATUS\_ABORTED      | 4      |                                                            |
| TEST\_STATUS\_ERROR        | 5      |                                                            |
| TEST\_STATUS\_IN\_PROGRESS | 6      |                                                            |
| TEST\_STATUS\_SKIPPED      | 7      |                                                            |

### TestStepType

| Name                            | Number | Description                                      |
| :------------------------------ | :----- | :----------------------------------------------- |
| TEST\_STEP\_TYPE\_UNSPECIFIED   | 0      |                                                  |
| TEST\_STEP\_TYPE\_SEQUENCE      | 1      | ResultSet/MainSequence - top-level test sequence |
| TEST\_STEP\_TYPE\_GROUP         | 2      | TestGroup - logical grouping of test steps       |
| TEST\_STEP\_TYPE\_ACTION        | 3      | SessionAction - individual executable action     |
| TEST\_STEP\_TYPE\_FLOW\_CONTROL | 4      | Flow control elements (While, If, etc.)          |
