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

# POST /v1/{+parent}/tensorboards

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

Creates a Tensorboard.

## Path parameters

- `parent` string, required

## Request body

- GoogleCloudAiplatformV1Tensorboard — Tensorboard is a physical database that stores users' training metrics. A default Tensorboard is provided in each region of a Google Cloud project. If needed users can also create extra Tensorboards in their projects.
  - `encryptionSpec` GoogleCloudAiplatformV1EncryptionSpec — Represents a customer-managed encryption key specification that can be applied to a Vertex AI resource.
    - `kmsKeyName` string — Required. Resource name of the Cloud KMS key used to protect the resource. The Cloud KMS key must be in the same region as the resource. It must have the format `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`.
  - `satisfiesPzs` boolean — Output only. Reserved for future use.
  - `displayName` string — Required. User provided name of this Tensorboard.
  - `satisfiesPzi` boolean — Output only. Reserved for future use.
  - `name` string — Output only. Name of the Tensorboard. Format: `projects/{project}/locations/{location}/tensorboards/{tensorboard}`
  - `description` string — Description of this Tensorboard.
  - `blobStoragePathPrefix` string — Output only. Consumer project Cloud Storage path prefix used to store blob data, which can either be a bucket or directory. Does not end with a '/'.
  - `updateTime` string, google-datetime — Output only. Timestamp when this Tensorboard was last updated.
  - `labels` object — The labels with user-defined metadata to organize your Tensorboards. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. No more than 64 user labels can be associated with one Tensorboard (System labels are excluded). See https://goo.gl/xmQnxf for more information and examples of labels. System reserved label keys are prefixed with "aiplatform.googleapis.com/" and are immutable.
  - `etag` string — Used to perform a consistent read-modify-write updates. If not set, a blind "overwrite" update happens.
  - `isDefault` boolean — Used to indicate if the TensorBoard instance is the default one. Each project & region can have at most one default TensorBoard instance. Creation of a default TensorBoard instance and updating an existing TensorBoard instance to be default will mark all other TensorBoard instances (if any) as non default.
  - `createTime` string, google-datetime — Output only. Timestamp when this Tensorboard was created.
  - `runCount` integer — Output only. The number of Runs stored in this Tensorboard.

## 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)