---
title: "PUT /v1/matters/{matterId}"
method: PUT
path: "/v1/matters/{matterId}"
tags: ["matters"]
---

# PUT /v1/matters/{matterId}

`PUT /v1/matters/{matterId}`

Updates the specified matter. This updates only the name and description of the matter, identified by matter ID. Changes to any other fields are ignored. Returns the default view of the matter.

## Path parameters

- `matterId` string, required

## Request body

- Matter — Represents a matter. To work with Vault resources, the account must have the [required Vault privileges] (https://support.google.com/vault/answer/2799699) and access to the matter. To access a matter, the account must have created the matter, have the matter shared with them, or have the **View All Matters** privilege.
  - `description` string — An optional description for the matter.
  - `matterPermissions` MatterPermission[] — Lists the users and their permission for the matter. Currently there is no programmer defined limit on the number of permissions a matter can have.
    - `role` 'ROLE_UNSPECIFIED' | 'COLLABORATOR' | 'OWNER' — The user's role for the matter.
    - `accountId` string — The account ID, as provided by the [Admin SDK](https://developers.google.com/admin-sdk/).
  - `matterRegion` 'MATTER_REGION_UNSPECIFIED' | 'ANY' | 'US' | 'EUROPE' — Optional. The requested data region for the matter.
  - `matterId` string — The matter ID, which is generated by the server. Leave blank when creating a matter.
  - `name` string — The name of the matter.
  - `state` 'STATE_UNSPECIFIED' | 'OPEN' | 'CLOSED' | 'DELETED' — The state of the matter.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/vault.md) · [All operations](https://skmtc.dev/google/apis/vault/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/vault/revisions/db6937065136/schema)