Group placeholder reassignments API

  • Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
History

The availability of this feature is controlled by a feature flag. For more information, see the history.

Prerequisites:

  • You must have the Owner role for the group.

Use the following endpoints to perform bulk placeholder reassignment without using the UI.

Download the CSV file

Download a CSV file of pending reassignments.

Copy to clipboard 
GET /groups/:id/placeholder_reassignments

Supported attributes:

AttributeTypeRequiredDescription
idinteger or stringyesID of the group or URL-encoded path of the group.

Example request:

Shell Copy to clipboard 
curl \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/groups/2/placeholder_reassignments"

Example response:

csv Copy to clipboard 
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.

Copy to clipboard 
POST /groups/:id/placeholder_reassignments

Supported attributes:

AttributeTypeRequiredDescription
idinteger or stringyesID of the group or URL-encoded path of the group.

Example request:

Shell Copy to clipboard 
curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" \
  --form "file=@placeholder_reassignments_for_group_2_1741253695.csv" \
  "http://gdk.test:3000/api/v4/groups/2/placeholder_reassignments"

Example response:

JSON Copy to clipboard 
{"message":"The file is being processed and you will receive an email when completed."}