---
title: "POST /v1/{+parent}/traceScopes"
method: POST
path: "/v1/{+parent}/traceScopes"
tags: ["projects"]
---

# POST /v1/{+parent}/traceScopes

`POST /v1/{+parent}/traceScopes`

Create a new TraceScope.

## Path parameters

- `parent` string, required

## Query parameters

- `traceScopeId` string

## Request body

- TraceScope — A trace scope is a collection of resources whose traces are queried together.
  - `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
  - `updateTime` string, google-datetime — Output only. The last update timestamp of the trace scope.
  - `createTime` string, google-datetime — Output only. The creation timestamp of the 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.

## Response `200`

Successful response

---

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