# REST Resource: projects.locations.investigations.revisions

- [Resource: InvestigationRevision](https://docs.cloud.google.com/cloud-assist/reference/rest/v1alpha/projects.locations.investigations.revisions#InvestigationRevision)
  - [JSON representation](https://docs.cloud.google.com/cloud-assist/reference/rest/v1alpha/projects.locations.investigations.revisions#InvestigationRevision.SCHEMA_REPRESENTATION)
- [Methods](https://docs.cloud.google.com/cloud-assist/reference/rest/v1alpha/projects.locations.investigations.revisions#METHODS_SUMMARY)

## Resource: InvestigationRevision

A revision holds a snapshot of the investigation at a past point in time. The most recent revision holds the investigation's current state, while previous revisions are immutable.

| JSON representation |
|---|
| ``` { "name": string, "snapshot": { object (`https://docs.cloud.google.com/cloud-assist/reference/rest/v1alpha/projects.locations.investigations#Investigation`) }, "createTime": string, "labels": { string: string, ... }, "index": integer } ``` |

| Fields ||
|---|---|
| `name` | `string` Identifier. The name of the revision resource, of the form: projects/{projectNumber}/locations/{locationId}/investigations/{investigationId}/revisions/{revision_id} |
| `snapshot` | ``object (`https://docs.cloud.google.com/cloud-assist/reference/rest/v1alpha/projects.locations.investigations#Investigation`)`` Optional. Snapshot of the investigation contents at this revision. |
| `createTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The time when the revision was created. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `labels` | `map (key: string, value: string)` Optional. User-defined labels for the revision. An object containing a list of `"key": value` pairs. Example: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`. |
| `index` | `integer` Output only. Revision index number, in order of creation. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/cloud-assist/reference/rest/v1alpha/projects.locations.investigations.revisions/create (deprecated)` | Deprecated: Investigations should only be modified by the agent. |
| ### `https://docs.cloud.google.com/cloud-assist/reference/rest/v1alpha/projects.locations.investigations.revisions/delete` | Deletes a single revision of an Investigation. |
| ### `https://docs.cloud.google.com/cloud-assist/reference/rest/v1alpha/projects.locations.investigations.revisions/get` | Gets details of a single revision of an Investigation. |
| ### `https://docs.cloud.google.com/cloud-assist/reference/rest/v1alpha/projects.locations.investigations.revisions/list` | Lists Investigations in a given project. |
| ### `https://docs.cloud.google.com/cloud-assist/reference/rest/v1alpha/projects.locations.investigations.revisions/run (deprecated)` | Deprecated: Investigations should only be run by the agent. |