Method: projects.patchTraces

Sends new traces to Cloud Trace or updates existing traces. If the ID of a trace that you send matches that of an existing trace, any fields in the existing trace and its spans are overwritten by the provided values, and any new fields provided are merged with the existing trace data. If the ID does not match, a new trace is created.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required. ID of the Cloud project where the trace data is stored.

Authorization requires the following IAM permission on the specified resource projectId:

  • cloudtrace.traces.patch

Request body

The request body contains an instance of Traces.

Response body

If successful, the response body is empty.

Authorization Scopes

Requires one of the following OAuth scopes:


For more information, see the Authentication Overview.


List of new or updated traces.

JSON representation
  "traces": [
      object (Trace)

object (Trace)

List of traces.