matters

POST /v1/matters

Changed on Oct 10, 2026

Creates a matter with the given name and description. The initial state is open, and the owner is the method caller. Returns the created matter with default view.

Request

Base URL
https://vault.googleapis.com
Auth
OAuth 2 and OAuth 2
Implicithttps://accounts.google.com/o/oauth2/auth
Scopeshttps://www.googleapis.com/auth/ediscovery
Authorization codehttps://accounts.google.com/o/oauth2/auth
Token URLhttps://accounts.google.com/o/oauth2/token
Scopeshttps://www.googleapis.com/auth/ediscovery
TypeScript
https://skmtc.dev/google/apis/vault/docs/v1/matters/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

descriptionstring

An optional description for the matter.

matterIdstring

The matter ID, which is generated by the server. Leave blank when creating a matter.

matterRegion'MATTER_REGION_UNSPECIFIED' | 'ANY' | 'US' | 'EUROPE'

Optional. The requested data region for the matter.

namestring

The name of the matter.

state'STATE_UNSPECIFIED' | 'OPEN' | 'CLOSED' | 'DELETED'

The state of the matter.

Response

Successful response