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

# POST /v1/{+parent}/conversionWorkspaces

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

Creates a new conversion workspace in a given project and location.

## Path parameters

- `parent` string, required

## Query parameters

- `conversionWorkspaceId` string
- `requestId` string

## Request body

- ConversionWorkspace — The main conversion workspace resource entity.
  - `latestCommitId` string — Output only. The latest commit ID.
  - `source` DatabaseEngineInfo — The type and version of a source or destination database.
    - `engine` 'DATABASE_ENGINE_UNSPECIFIED' | 'MYSQL' | 'POSTGRESQL' | 'SQLSERVER' | 'ORACLE' — Required. Engine type.
    - `version` string — Required. Engine version, for example "12.c.1".
  - `destination` DatabaseEngineInfo — The type and version of a source or destination database.
    - `engine` 'DATABASE_ENGINE_UNSPECIFIED' | 'MYSQL' | 'POSTGRESQL' | 'SQLSERVER' | 'ORACLE' — Required. Engine type.
    - `version` string — Required. Engine version, for example "12.c.1".
  - `name` string — Full name of the workspace resource, in the form of: projects/{project}/locations/{location}/conversionWorkspaces/{conversion_workspace}.
  - `updateTime` string, google-datetime — Output only. The timestamp when the workspace resource was last updated.
  - `destinationProvider` 'DATABASE_PROVIDER_UNSPECIFIED' | 'CLOUDSQL' | 'RDS' | 'AURORA' | 'ALLOYDB' | 'AZURE_DATABASE' — Optional. The provider for the destination database.
  - `sourceProvider` 'DATABASE_PROVIDER_UNSPECIFIED' | 'CLOUDSQL' | 'RDS' | 'AURORA' | 'ALLOYDB' | 'AZURE_DATABASE' — Optional. The provider for the source database.
  - `latestCommitTime` string, google-datetime — Output only. The timestamp when the workspace was committed.
  - `hasUncommittedChanges` boolean — Output only. Whether the workspace has uncommitted changes (changes which were made after the workspace was committed).
  - `createTime` string, google-datetime — Output only. The timestamp when the workspace resource was created.
  - `globalSettings` object — Optional. A generic list of settings for the workspace. The settings are database pair dependant and can indicate default behavior for the mapping rules engine or turn on or off specific features. Such examples can be: convert_foreign_key_to_interleave=true, skip_triggers=false, ignore_non_table_synonyms=true
  - `displayName` string — Optional. The display name for the workspace.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/datamigration.md) · [All operations](https://skmtc.dev/google/apis/datamigration/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/datamigration/revisions/d77bd66e25e6/schema)