---
title: "Add users to a Data Warehouse instance"
method: POST
path: "/gdc/datawarehouse/instances/{instanceId}/users"
tags: ["datawarehouse"]
---

# Add users to a Data Warehouse instance

`POST /gdc/datawarehouse/instances/{instanceId}/users`

## Request

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

## Query parameters

- `offset` string
- `limit` integer

## Request body

- UserRequest
  - `user` UserCommon, required
    - `role` string, required: The user role. Can be `admin` (can manage the instance and users within in it), `dataAdmin` (can run queries; cannot manage users), or `readOnly` (can only access the instance in read-only mode; cannot make any changes in the instance). For more information about user roles, see [Data Warehouse User Roles](https://help.gooddata.com/display/doc/Data+Warehouse+User+Roles).
    - `profile` string, uri: URI of the user's profile
    - `login` string, email: GoodData login of the user. **NOTE:** Specify either `profile` or `login`, not both.
    - `links` SelfParentLinks: Self and parent links
      - `self` string, uri, required: Self link
      - `parent` string, uri, required: Parent link

## Response `202`

Add user to instance 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)
- `403`: User doesn't have rights to add new users to the instance
- `404`: Instance has not been found.

---

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