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

# POST /v1/{+tensorboardExperiment}:write

`POST /v1/{+tensorboardExperiment}:write`

Write time series data points of multiple TensorboardTimeSeries in multiple TensorboardRun's. If any data fail to be ingested, an error is returned.

## Path parameters

- `tensorboardExperiment` string, required

## Request body

- GoogleCloudAiplatformV1WriteTensorboardExperimentDataRequest — Request message for TensorboardService.WriteTensorboardExperimentData.
  - `writeRunDataRequests` GoogleCloudAiplatformV1WriteTensorboardRunDataRequest[] — Required. Requests containing per-run TensorboardTimeSeries data to write.
    - `tensorboardRun` string — Required. The resource name of the TensorboardRun to write data to. Format: `projects/{project}/locations/{location}/tensorboards/{tensorboard}/experiments/{experiment}/runs/{run}`
    - `timeSeriesData` GoogleCloudAiplatformV1TimeSeriesData[] — Required. The TensorboardTimeSeries data to write. Values with in a time series are indexed by their step value. Repeated writes to the same step will overwrite the existing value for that step. The upper limit of data points per write request is 5000.
      - `valueType` 'VALUE_TYPE_UNSPECIFIED' | 'SCALAR' | 'TENSOR' | 'BLOB_SEQUENCE' — Required. Immutable. The value type of this time series. All the values in this time series data must match this value type.
      - `values` GoogleCloudAiplatformV1TimeSeriesDataPoint[] — Required. Data points in this time series.
        - `blobs` GoogleCloudAiplatformV1TensorboardBlobSequence — One point viewable on a blob metric plot, but mostly just a wrapper message to work around repeated fields can't be used directly within `oneof` fields.
          - `values` GoogleCloudAiplatformV1TensorboardBlob[] — List of blobs contained within the sequence.
            - `id` string — Output only. A URI safe key uniquely identifying a blob. Can be used to locate the blob stored in the Cloud Storage bucket of the consumer project.
            - `data` string, byte — Optional. The bytes of the blob is not present unless it's returned by the ReadTensorboardBlobData endpoint.
        - `scalar` GoogleCloudAiplatformV1Scalar — One point viewable on a scalar metric plot.
          - `value` number, double — Value of the point at this step / timestamp.
        - `tensor` GoogleCloudAiplatformV1TensorboardTensor — One point viewable on a tensor metric plot.
          - `versionNumber` integer — Optional. Version number of TensorProto used to serialize value.
          - `value` string, byte — Required. Serialized form of https://github.com/tensorflow/tensorflow/blob/master/tensorflow/core/framework/tensor.proto
        - `wallTime` string, google-datetime — Wall clock timestamp when this data point is generated by the end user.
        - `step` string, int64 — Step index of this data point within the run.
      - `tensorboardTimeSeriesId` string — Required. The ID of the TensorboardTimeSeries, which will become the final component of the TensorboardTimeSeries' resource name

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/aiplatform.md) · [All operations](https://skmtc.net/google/apis/aiplatform/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/aiplatform/versions/b608d71b91f0/schema)