---
title: "PATCH /v1/projects/{projectsId}/locations/{locationsId}/traceScopes/{traceScopesId}"
method: PATCH
path: "/v1/projects/{projectsId}/locations/{locationsId}/traceScopes/{traceScopesId}"
tags: ["projects"]
---

# PATCH /v1/projects/{projectsId}/locations/{locationsId}/traceScopes/{traceScopesId}

`PATCH /v1/projects/{projectsId}/locations/{locationsId}/traceScopes/{traceScopesId}`

## Request

- Base URL: `https://observability.googleapis.com`
- URL: `https://observability.googleapis.com/v1/projects/{projectsId}/locations/{locationsId}/traceScopes/{traceScopesId}`
- Auth: OAuth 2 and OAuth 2
  - Implicit: `https://accounts.google.com/o/oauth2/auth`
  - Scopes: `https://www.googleapis.com/auth/cloud-platform`
  - Authorization code: `https://accounts.google.com/o/oauth2/auth`
  - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/cloud-platform`

Update a TraceScope.

## Path parameters

- `projectsId` string, required
- `locationsId` string, required
- `traceScopesId` string, required

## Query parameters

- `updateMask` string, google-fieldmask

## Request body

- TraceScope: A trace scope is a collection of resources whose traces are queried together.
  - `createTime` string, google-datetime: Output only. The creation timestamp of the trace scope.
  - `description` string: Optional. Describes this trace scope. The maximum length of the description is 8000 characters.
  - `name` string: Identifier. The resource name of the trace scope. For example: projects/my-project/locations/global/traceScopes/my-trace-scope
  - `resourceNames` string[]: Required. Names of the projects that are included in this trace scope. * `projects/[PROJECT_ID]` A trace scope can include a maximum of 20 projects.
  - `updateTime` string, google-datetime: Output only. The last update timestamp of the trace scope.

## Response `200`

Successful response

- TraceScope: A trace scope is a collection of resources whose traces are queried together.
  - `createTime` string, google-datetime: Output only. The creation timestamp of the trace scope.
  - `description` string: Optional. Describes this trace scope. The maximum length of the description is 8000 characters.
  - `name` string: Identifier. The resource name of the trace scope. For example: projects/my-project/locations/global/traceScopes/my-trace-scope
  - `resourceNames` string[]: Required. Names of the projects that are included in this trace scope. * `projects/[PROJECT_ID]` A trace scope can include a maximum of 20 projects.
  - `updateTime` string, google-datetime: Output only. The last update timestamp of the trace scope.

---

[API](https://skmtc.dev/google/apis/observability.md) - [All operations](https://skmtc.dev/google/apis/observability/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/observability/revisions/77d49783b542?raw)