---
title: "Create Workspace"
method: POST
path: "/v1/workspaces"
tags: ["workspace"]
---

# Create Workspace

`POST /v1/workspaces`

## Query parameters

- `workspaceId` string, required

## Request body

- WorkspaceInput — The singleton SQL data environment owned by an organization. Connectors and catalogs are direct child resources. Catalogs without a relational source own schemas, and schemas without one own tables. Any mutation to the defaults or an owned child advances `revision`.
  - `name` string — Resource name in the form `workspaces/{workspace}`.
  - `sqlDefaults` SqlDefaults, required — Default SQL names used when a query omits qualifiers.
    - `defaultCatalog` string, required — Catalog selected when SQL omits the catalog qualifier.
    - `defaultSchema` string, required — Schema selected when SQL omits the schema qualifier.
  - `revision` integer — Monotonically increasing version of the complete workspace state.
  - `createTime` string, date-time, nullable — Time at which the workspace was created.
  - `updateTime` string, date-time, nullable — Time at which the workspace was most recently updated.

## Response `201`

Successful Response

- WorkspaceOutput — The singleton SQL data environment owned by an organization. Connectors and catalogs are direct child resources. Catalogs without a relational source own schemas, and schemas without one own tables. Any mutation to the defaults or an owned child advances `revision`.
  - `name` string, required — Resource name in the form `workspaces/{workspace}`.
  - `sqlDefaults` SqlDefaults, required — Default SQL names used when a query omits qualifiers.
    - `defaultCatalog` string, required — Catalog selected when SQL omits the catalog qualifier.
    - `defaultSchema` string, required — Schema selected when SQL omits the schema qualifier.
  - `revision` string — Monotonically increasing version of the complete workspace state.
  - `createTime` string, nullable — Time at which the workspace was created.
  - `updateTime` string, nullable — Time at which the workspace was most recently updated.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/outerproduct/apis/outerproduct-api.md) · [All operations](https://skmtc.net/outerproduct/apis/outerproduct-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/outerproduct/outerproduct-api/revisions/6c6e81fb3282/schema)