The Matters API from Google Vault — 8 operation(s) for matters.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/google-vault-matters-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Google Vault Exports Matters API
description: Best-effort OpenAPI 3.1 for the Google Vault API, an information governance and eDiscovery API for Google Workspace. Covers matters, holds, exports, saved queries, held accounts, and long-running operations.
version: v1
servers:
- url: https://vault.googleapis.com
security:
- googleOAuth: []
tags:
- name: Matters
paths:
/v1/matters:
get:
tags:
- Matters
summary: List matters
operationId: matters.list
parameters:
- in: query
name: state
schema:
type: string
enum:
- STATE_UNSPECIFIED
- OPEN
- CLOSED
- DELETED
- in: query
name: pageSize
schema:
type: integer
- in: query
name: pageToken
schema:
type: string
- in: query
name: view
schema:
type: string
enum:
- VIEW_UNSPECIFIED
- BASIC
- FULL
responses:
'200':
description: Matters
content:
application/json:
schema:
type: object
properties:
matters:
type: array
items:
$ref: '#/components/schemas/Matter'
nextPageToken:
type: string
post:
tags:
- Matters
summary: Create matter
operationId: matters.create
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/Matter'
responses:
'200':
description: Matter
content:
application/json:
schema:
$ref: '#/components/schemas/Matter'
/v1/matters/{matterId}:
get:
tags:
- Matters
summary: Get matter
operationId: matters.get
parameters:
- in: path
name: matterId
required: true
schema:
type: string
responses:
'200':
description: Matter
put:
tags:
- Matters
summary: Update matter
operationId: matters.update
parameters:
- in: path
name: matterId
required: true
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/Matter'
responses:
'200':
description: Matter
delete:
tags:
- Matters
summary: Delete matter
operationId: matters.delete
parameters:
- in: path
name: matterId
required: true
schema:
type: string
responses:
'200':
description: Empty
/v1/matters/{matterId}:close:
post:
tags:
- Matters
summary: Close a matter
operationId: matters.close
parameters:
- in: path
name: matterId
required: true
schema:
type: string
responses:
'200':
description: Closed
/v1/matters/{matterId}:reopen:
post:
tags:
- Matters
summary: Reopen a matter
operationId: matters.reopen
parameters:
- in: path
name: matterId
required: true
schema:
type: string
responses:
'200':
description: Reopened
/v1/matters/{matterId}:undelete:
post:
tags:
- Matters
summary: Undelete a matter
operationId: matters.undelete
parameters:
- in: path
name: matterId
required: true
schema:
type: string
responses:
'200':
description: Undeleted
/v1/matters/{matterId}:count:
post:
tags:
- Matters
summary: Count accounts processed by a query
operationId: matters.count
parameters:
- in: path
name: matterId
required: true
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
query:
$ref: '#/components/schemas/Query'
view:
type: string
enum:
- COUNT_RESULT_VIEW_UNSPECIFIED
- TOTAL_COUNT
- ALL
responses:
'200':
description: Operation
/v1/matters/{matterId}:addPermissions:
post:
tags:
- Matters
summary: Add collaborator to matter
operationId: matters.addPermissions
parameters:
- in: path
name: matterId
required: true
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
matterPermission:
type: object
properties:
role:
type: string
enum:
- ROLE_UNSPECIFIED
- COLLABORATOR
- OWNER
accountId:
type: string
sendEmails:
type: boolean
ccMe:
type: boolean
responses:
'200':
description: MatterPermission
/v1/matters/{matterId}:removePermissions:
post:
tags:
- Matters
summary: Remove collaborator from matter
operationId: matters.removePermissions
parameters:
- in: path
name: matterId
required: true
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
accountId:
type: string
responses:
'200':
description: Empty
components:
schemas:
Matter:
type: object
properties:
matterId:
type: string
name:
type: string
description:
type: string
state:
type: string
enum:
- STATE_UNSPECIFIED
- OPEN
- CLOSED
- DELETED
matterPermissions:
type: array
items:
type: object
properties:
role:
type: string
accountId:
type: string
Query:
type: object
properties:
corpus:
type: string
enum:
- CORPUS_TYPE_UNSPECIFIED
- DRIVE
- MAIL
- GROUPS
- HANGOUTS_CHAT
- VOICE
- CALENDAR
dataScope:
type: string
enum:
- DATA_SCOPE_UNSPECIFIED
- ALL_DATA
- HELD_DATA
- UNPROCESSED_DATA
searchMethod:
type: string
enum:
- SEARCH_METHOD_UNSPECIFIED
- ACCOUNT
- ORG_UNIT
- TEAM_DRIVE
- ENTIRE_ORG
- ROOM
- SITES_URL
- SHARED_DRIVE
terms:
type: string
startTime:
type: string
format: date-time
endTime:
type: string
format: date-time
timeZone:
type: string
securitySchemes:
googleOAuth:
type: oauth2
flows:
authorizationCode:
authorizationUrl: https://accounts.google.com/o/oauth2/v2/auth
tokenUrl: https://oauth2.googleapis.com/token
scopes:
https://www.googleapis.com/auth/ediscovery: Manage all Vault data
https://www.googleapis.com/auth/ediscovery.readonly: Read-only Vault data