--- title: "Add a user to or disable from a project" method: POST path: "/gdc/projects/{project_id}/users" tags: ["project-users-management"] --- # Add a user to or disable from a project `POST /gdc/projects/{project_id}/users` ## Request - Base URL: `https://secure.gooddata.com` - URL: `https://secure.gooddata.com/gdc/projects/{project_id}/users` - Auth: none declared To be able to add a user to or disable from a project, you must be an administrator of that project and the domain where the project belongs to. Typically, the maximum number of users in a project is 10,000. If you need to exceed this limit, contact [GoodData Support](https://support.gooddata.com/hc/en-us). When adding a user, set its status to ENABLED and specify a user role ID. User roles and their IDs are project-specific. For more information about user roles, see [User Roles](https://help.gooddata.com/display/doc/User+Roles). To disable a user, set its status to DISABLED. This API accepts arrays of objects. That is, you can add or disable more users to a project via one API call. To get information about the specific user role IDs for a project, see [Get roles for a project](#operation/getUserRolesForProject). If you are the domain administrator of the user, you can identify the user also by __login__ instead of **profile_id**: use `"self": "/gdc/account/profile/username@domain.com?` in the `links` parameter. ## Path parameters - `project_id` string, required ## Request body - union - UserTypeProject1 - `user` object, required - `content` UserContent, required - `status` 'ENABLED' | 'DISABLED', required - `firstname` string - `lastname` string - `email` string, email: email in valid format - `login` string - `phonenumber` string - `userRoles` string[]: useRoles that will be assigned to updated or new user (previous roles are discarded - there is no merge!) - `links` object - `self` string, uri: URI of the user's profile - `roles` string, uri - `permissions` string, uri - `projectRelUri` string, uri - `invitations` string, uri - `projects` string, uri - `meta` MetaRequest - `title` string, required: Title of this metadata object. Mustn't contain only whitespace characters - `category` string: Category of this metadata object - `tags` string: List of tags for this metadata object separated by spaces - `author` string, uri: URI of the user's profile - `created` string: Date and time string in the format `YYYY-MM-DD hh:mm:ss` - `contributor` string, uri: URI of the user's profile - `updated` string: Date and time string in the format `YYYY-MM-DD hh:mm:ss` - `identifier` string: Global identifier of a metadata object - `flags` string[]: List of flags specified for this metadata object - `summary` string, nullable: A short description of this metadata object - `projectTemplate` string, uri - `uri` string, uri: Link to this metadata object - `deprecated` union: Legacy boolean allowing boolean values represented by booleans or numbers - '0' | '1' - 0 | 1 - boolean - `locked` union: Legacy boolean allowing boolean values represented by booleans or numbers - '0' | '1' - 0 | 1 - boolean - `unlisted` union: Legacy boolean allowing boolean values represented by booleans or numbers - '0' | '1' - 0 | 1 - boolean - `isProduction` union: Legacy boolean allowing boolean values represented by booleans or numbers - '0' | '1' - 0 | 1 - boolean - `sharedWithSomeone` union: Legacy boolean allowing boolean values represented by booleans or numbers - '0' | '1' - 0 | 1 - boolean - UsersTypeProject1 - `users` UserTypeProject1[], required - `user` object, required - `content` UserContent, required - `status` 'ENABLED' | 'DISABLED', required - `firstname` string - `lastname` string - `email` string, email: email in valid format - `login` string - `phonenumber` string - `userRoles` string[]: useRoles that will be assigned to updated or new user (previous roles are discarded - there is no merge!) - `links` object - `self` string, uri: URI of the user's profile - `roles` string, uri - `permissions` string, uri - `projectRelUri` string, uri - `invitations` string, uri - `projects` string, uri - `meta` MetaRequest - `title` string, required: Title of this metadata object. Mustn't contain only whitespace characters - `category` string: Category of this metadata object - `tags` string: List of tags for this metadata object separated by spaces - `author` string, uri: URI of the user's profile - `created` string: Date and time string in the format `YYYY-MM-DD hh:mm:ss` - `contributor` string, uri: URI of the user's profile - `updated` string: Date and time string in the format `YYYY-MM-DD hh:mm:ss` - `identifier` string: Global identifier of a metadata object - `flags` string[]: List of flags specified for this metadata object - `summary` string, nullable: A short description of this metadata object - `projectTemplate` string, uri - `uri` string, uri: Link to this metadata object - `deprecated` union: Legacy boolean allowing boolean values represented by booleans or numbers - '0' | '1' - 0 | 1 - boolean - `locked` union: Legacy boolean allowing boolean values represented by booleans or numbers - '0' | '1' - 0 | 1 - boolean - `unlisted` union: Legacy boolean allowing boolean values represented by booleans or numbers - '0' | '1' - 0 | 1 - boolean - `isProduction` union: Legacy boolean allowing boolean values represented by booleans or numbers - '0' | '1' - 0 | 1 - boolean - `sharedWithSomeone` union: Legacy boolean allowing boolean values represented by booleans or numbers - '0' | '1' - 0 | 1 - boolean ## Response `200` _ - ProjectUsersUpdateResult - `projectUsersUpdateResult` object, required - `successful` ProfileUri[], required - `failed` object[], required - `user` string, uri, required: URI of the user's profile - `message` string, required ## Other responses - `400`: _ --- [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)