Method: projects.patchTraces

Sends new traces to Stackdriver 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



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

Authorization requires the following Google 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 will be 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.

Was this page helpful? Let us know how we did:

Send feedback about...

Stackdriver Trace
Need help? Visit our support page.