---
title: "Create a Data Warehouse instance"
method: POST
path: "/gdc/datawarehouse/instances"
tags: ["datawarehouse"]
---

# Create a Data Warehouse instance

`POST /gdc/datawarehouse/instances`

## Request

- Base URL: `https://secure.gooddata.com`
- URL: `https://secure.gooddata.com/gdc/datawarehouse/instances`
- Auth: none declared

**NOTE:** You must have a Data Warehouse token to create a Data Warehouse instance.

## Query parameters

- `offset` string
- `limit` integer

## Request body

- CreateInstance
  - `instance` object, required: The instance you want to create
    - `title` string, required: The instance title
    - `description` string: The instance description
    - `environment` 'PRODUCTION' | 'DEVELOPMENT' | 'TESTING': Platform enviroment
    - `authorizationToken` string, required: Token used for instance creation

## Response `202`

New instance creation task has been created

- NewAsyncTask: New taskman async task used in all new API resources. It contains `links` element in plural which complies with our API rules.
  - `asyncTask` object, required
    - `links` AsyncTaskPollLink, required
      - `poll` string, uri, required: URI of the polling resource

## Other responses

- `400`: Bad request (Invalid data in the request)

---

[API](https://skmtc.dev/gooddata/apis/gooddata-api-documentation.md) - [All operations](https://skmtc.dev/gooddata/apis/gooddata-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/gooddata/apis/gooddata-api-documentation/revisions/e5dc0ee6ab00?raw)