---
title: "POST /v1/{+name}:rollback"
method: POST
path: "/v1/{+name}:rollback"
tags: ["projects"]
---

# POST /v1/{+name}:rollback

`POST /v1/{+name}:rollback`

Rolls back messages from the HL7v2 store to the specified time. This method returns an Operation that can be used to track the status of the rollback by calling GetOperation. Immediate fatal errors appear in the error field, errors are also logged to Cloud Logging (see [Viewing error logs in Cloud Logging](https://cloud.google.com/healthcare/docs/how-tos/logging)). Otherwise, when the operation finishes, a detailed response of type RollbackHl7V2MessagesResponse is returned in the response field. The metadata field type for this operation is OperationMetadata.

## Path parameters

- `name` string, required

## Request body

- RollbackHl7V2MessagesRequest — Point in time recovery rollback request.
  - `resultGcsBucket` string — Required. Bucket to deposit result
  - `rollbackTime` string, google-datetime — Required. Times point to rollback to.
  - `inputGcsObject` string — Optional. Cloud storage object containing list of {resourceId} lines, identifying resources to be reverted
  - `filteringFields` RollbackHL7MessagesFilteringFields — Filtering fields for an HL7v2 rollback. Currently only supports a list of operation ids to roll back.
    - `operationIds` string[] — Optional. A list of operation IDs to roll back.
  - `force` boolean — Optional. When enabled, changes will be reverted without explicit confirmation.
  - `excludeRollbacks` boolean — Optional. Specifies whether to exclude earlier rollbacks.
  - `changeType` 'CHANGE_TYPE_UNSPECIFIED' | 'ALL' | 'CREATE' | 'UPDATE' | 'DELETE' — Optional. CREATE/UPDATE/DELETE/ALL for reverting all txns of a certain type.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/healthcare.md) · [All operations](https://skmtc.net/google/apis/healthcare/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/healthcare/versions/cdec6fe2315f/schema)