Group placeholder reassignments API
- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
The availability of this feature is controlled by a feature flag. For more information, see the history.
Use this API to reassign placeholder users in bulk.
Prerequisites:
- You must have the Owner role for the group.
User contribution mapping is not supported when you import projects to a personal namespace. When you import to a personal namespace and the
user_mapping_to_personal_namespace_ownerfeature flag is enabled, all contributions are assigned to the personal namespace owner and they cannot be reassigned. When theuser_mapping_to_personal_namespace_ownerfeature flag is disabled, all contributions are assigned to a single non-functional user calledImport Userand they cannot be reassigned.
Download the CSV file
Download a CSV file of pending reassignments.
GET /groups/:id/placeholder_reassignmentsSupported attributes:
| Attribute | Type | Required | Description |
|---|---|---|---|
id | integer or string | yes | ID of the group or URL-encoded path of the group. |
Example request:
curl --request GET \
--header "PRIVATE-TOKEN: <your_access_token>" \
--url "https://gitlab.example.com/api/v4/groups/2/placeholder_reassignments"Example response:
Source host,Import type,Source user identifier,Source user name,Source username,GitLab username,GitLab public email
http://gitlab.example,gitlab_migration,11,Bob,bob,"",""
http://gitlab.example,gitlab_migration,9,Alice,alice,"",""Reassign placeholders
Complete the CSV file and upload it to reassign placeholder users.
POST /groups/:id/placeholder_reassignmentsSupported attributes:
| Attribute | Type | Required | Description |
|---|---|---|---|
id | integer or string | yes | ID of the group or URL-encoded path of the group. |
Example request:
curl --request POST \
--header "PRIVATE-TOKEN: <your_access_token>" \
--form "file=@placeholder_reassignments_for_group_2_1741253695.csv" \
--url "http://gdk.test:3000/api/v4/groups/2/placeholder_reassignments"Example response:
{"message":"The file is being processed and you will receive an email when completed."}