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

# POST /v1/{+parent}/workspaces

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

Creates a new Workspace in a given Repository.

## Path parameters

- `parent` string, required

## Query parameters

- `workspaceId` string

## Request body

- Workspace — Represents a Dataform Git workspace.
  - `name` string — Identifier. The workspace's name.
  - `dataEncryptionState` DataEncryptionState — Describes encryption state of a resource.
    - `kmsKeyVersionName` string — Required. The KMS key version name with which data of a resource is encrypted.
  - `createTime` string, google-datetime — Output only. The timestamp of when the workspace was created.
  - `internalMetadata` string — Output only. All the metadata information that is used internally to serve the resource. For example: timestamps, flags, status fields, etc. The format of this field is a JSON string.
  - `disableMoves` boolean — Optional. If set to true, workspaces will not be moved if its linked Repository is moved. Instead, it will be deleted.
  - `privateResourceMetadata` PrivateResourceMetadata — Metadata used to identify if a resource is user scoped.
    - `userScoped` boolean — Output only. If true, this resource is user-scoped, meaning it is either a workspace or sourced from a workspace.

## Response `200`

Successful response

---

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