Repository storage moves

An administrator moves repositories between Gitaly storage shards with storage moves. For each of projects, groups and snippets these actions list every move, list the moves of one, read a move, schedule one, and schedule moves for every repository on a shard. Group moves are served from Premium.

Sample questions

• “List the project storage moves in progress”
• “Move project 42 to the storage2 shard”
• “What is the state of group storage move 7?”

How to call it

• Dynamic, the default surface: call gitlab_execute_action with action set to the action’s ID, such as storage_move.get_group, and its parameters in params. gitlab_find_action finds an ID from a description of the task.
• Meta (GITLAB_MCP_TOOL_SURFACE=meta): call gitlab_storage_move with action set to the action’s name, such as get_group, and its parameters in params.
• Individual (GITLAB_MCP_TOOL_SURFACE=individual): call the action’s own tool, such as gitlab_get_group_storage_move, with its parameters as the arguments.

Availability

How many of these actions an instance serves at each tier, out of a total of 18:

• Free: 12
• Premium: 18
• Ultimate: 18

Listed only for a token that carries admin_mode: the server removes the group from every surface for a token whose scopes it knows and that lacks it.

Read-only actions: 12 of 18, the ones a deployment in read-only mode keeps.

Actions

The description of each action, and of each of its parameters, is the text the server serves for it on the default surface, quoted as served.

Action	Tier	Individual
storage_move.get_group	Premium	gitlab_get_group_storage_move
storage_move.get_group_for_group	Premium	gitlab_get_group_storage_move_for_group
storage_move.get_project	Free	gitlab_get_project_storage_move
storage_move.get_project_for_project	Free	gitlab_get_project_storage_move_for_project
storage_move.get_snippet	Free	gitlab_get_snippet_storage_move
storage_move.get_snippet_for_snippet	Free	gitlab_get_snippet_storage_move_for_snippet
storage_move.retrieve_all_group	Premium	gitlab_retrieve_all_group_storage_moves
storage_move.retrieve_all_project	Free	gitlab_retrieve_all_project_storage_moves
storage_move.retrieve_all_snippet	Free	gitlab_retrieve_all_snippet_storage_moves
storage_move.retrieve_group	Premium	gitlab_retrieve_group_storage_moves
storage_move.retrieve_project	Free	gitlab_retrieve_project_storage_moves
storage_move.retrieve_snippet	Free	gitlab_retrieve_snippet_storage_moves
storage_move.schedule_all_group	Premium	gitlab_schedule_all_group_storage_moves
storage_move.schedule_all_project	Free	gitlab_schedule_all_project_storage_moves
storage_move.schedule_all_snippet	Free	gitlab_schedule_all_snippet_storage_moves
storage_move.schedule_group	Premium	gitlab_schedule_group_storage_move
storage_move.schedule_project	Free	gitlab_schedule_project_storage_move
storage_move.schedule_snippet	Free	gitlab_schedule_snippet_storage_move

storage_move.get_group

Get a single group repository storage move by ID. Returns: the storage move with state, source and destination storage names, group reference, and creation time. See also: storage_move.retrieve_all_group, storage_move.get_group_for_group.

• Meta-tool: gitlab_storage_move, action get_group
• Individual tool: gitlab_get_group_storage_move
• Tier: Premium
• Behavior: read-only, idempotent

Parameter	Type	Mandatory	Description
id	integer	yes	Numeric ID of the storage move

storage_move.get_group_for_group

Get a single repository storage move for a specific group. Returns: the storage move with state, source and destination storage names, group reference, and creation time. See also: storage_move.retrieve_group, storage_move.get_group.

• Meta-tool: gitlab_storage_move, action get_group_for_group
• Individual tool: gitlab_get_group_storage_move_for_group
• Tier: Premium
• Behavior: read-only, idempotent

Parameter	Type	Mandatory	Description
group_id	integer	yes	Numeric ID of the group
id	integer	yes	Numeric ID of the storage move

storage_move.get_project

Get a single project repository storage move by its global move id. Returns: the move’s id, state, source and destination storage shards, and project. Admin-only and self-managed only. See also: storage_move.retrieve_all_project.

• Meta-tool: gitlab_storage_move, action get_project
• Individual tool: gitlab_get_project_storage_move
• Tier: Free
• Behavior: read-only, idempotent

Parameter	Type	Mandatory	Description
id	integer	yes	Numeric ID of the storage move

storage_move.get_project_for_project

Get a single repository storage move for a specific project by project_id and move id. Returns: the move’s id, state, source and destination storage shards, and project. Admin-only and self-managed only. See also: storage_move.retrieve_project.

• Meta-tool: gitlab_storage_move, action get_project_for_project
• Individual tool: gitlab_get_project_storage_move_for_project
• Tier: Free
• Behavior: read-only, idempotent

Parameter	Type	Mandatory	Description
id	integer	yes	Numeric ID of the storage move
project_id	integer	yes	Numeric ID of the project

storage_move.get_snippet

Get a single snippet repository storage move by its ID. Returns: the storage move with state, source and destination storage shards, and the associated snippet. See also: storage_move.retrieve_all_snippet, storage_move.get_snippet_for_snippet.

• Meta-tool: gitlab_storage_move, action get_snippet
• Individual tool: gitlab_get_snippet_storage_move
• Tier: Free
• Behavior: read-only, idempotent

Parameter	Type	Mandatory	Description
id	integer	yes	Numeric ID of the storage move

storage_move.get_snippet_for_snippet

Get a single repository storage move scoped to one snippet by snippet ID and move ID. Returns: the storage move with state, source and destination storage shards, and the associated snippet. See also: storage_move.retrieve_snippet, storage_move.get_snippet.

• Meta-tool: gitlab_storage_move, action get_snippet_for_snippet
• Individual tool: gitlab_get_snippet_storage_move_for_snippet
• Tier: Free
• Behavior: read-only, idempotent

Parameter	Type	Mandatory	Description
id	integer	yes	Numeric ID of the storage move
snippet_id	integer	yes	Numeric ID of the snippet

storage_move.retrieve_all_group

List all group repository storage moves across the instance. Returns: storage moves with state, source and destination storage names, group reference, creation time, and pagination metadata. See also: storage_move.retrieve_group, storage_move.get_group, storage_move.schedule_all_group.

• Meta-tool: gitlab_storage_move, action retrieve_all_group
• Individual tool: gitlab_retrieve_all_group_storage_moves
• Tier: Premium
• Behavior: read-only, idempotent

Parameter	Type	Mandatory	Description
order_by	string	no	Column to order keyset-paginated results by (e.g. id). Only used when pagination=‘keyset’.
page	integer	no	Page number to fetch, 1-based. Defaults to 1. Use the next_page field from the previous response to paginate forward.
page_token	string	no	Keyset pagination cursor: record id at which to fetch the next page, taken from the previous keyset response. Only used when pagination=‘keyset’.
pagination	string	no	Pagination method: ‘keyset’ for keyset-based pagination on large ordered result sets, or ‘offset’ (the default). Keyset avoids deep-offset cost.
per_page	integer	no	Items per page. Defaults to 20, minimum 1, maximum 100. Use 100 to minimize round trips when the result set is large.
sort	string (asc, desc)	no	Sort direction for keyset-paginated results: asc or desc. Only used when pagination=‘keyset’.

storage_move.retrieve_all_project

List all project repository storage moves on the instance. Returns: each move’s id, state, source and destination storage shards, and project. Admin-only and self-managed only. See also: storage_move.get_project, storage_move.schedule_all_project.

• Meta-tool: gitlab_storage_move, action retrieve_all_project
• Individual tool: gitlab_retrieve_all_project_storage_moves
• Tier: Free
• Behavior: read-only, idempotent

Parameter	Type	Mandatory	Description
order_by	string	no	Column to order keyset-paginated results by (e.g. id). Only applies when pagination=‘keyset’.
page	integer	no	Page number to fetch, 1-based. Defaults to 1. Use the next_page field from the previous response to paginate forward.
page_token	string	no	Keyset pagination cursor: record id at which to fetch the next page, taken from the previous keyset response. Only used when pagination=‘keyset’.
pagination	string	no	Pagination method: ‘keyset’ for keyset-based pagination on large ordered result sets, or ‘offset’ (the default). Keyset avoids deep-offset cost.
per_page	integer	no	Items per page. Defaults to 20, minimum 1, maximum 100. Use 100 to minimize round trips when the result set is large.
sort	string (asc, desc)	no	Sort direction for keyset-paginated results: asc or desc. Only applies when pagination=‘keyset’.

storage_move.retrieve_all_snippet

List every snippet repository storage move on the instance with ordering and pagination. Returns: storage moves with state, source and destination storage shards, the associated snippet, and pagination metadata. See also: storage_move.get_snippet, storage_move.retrieve_snippet, storage_move.schedule_all_snippet.

• Meta-tool: gitlab_storage_move, action retrieve_all_snippet
• Individual tool: gitlab_retrieve_all_snippet_storage_moves
• Tier: Free
• Behavior: read-only, idempotent

Parameter	Type	Mandatory	Description
order_by	string	no	Field to order results by (for example ‘id’). Maps to the GitLab order_by query parameter.
page	integer	no	Page number to fetch, 1-based. Defaults to 1. Use the next_page field from the previous response to paginate forward.
page_token	string	no	Keyset pagination cursor: record id at which to fetch the next page, taken from the previous keyset response. Only used when pagination=‘keyset’.
pagination	string	no	Pagination method: ‘keyset’ for keyset-based pagination on large ordered result sets, or ‘offset’ (the default). Keyset avoids deep-offset cost.
per_page	integer	no	Items per page. Defaults to 20, minimum 1, maximum 100. Use 100 to minimize round trips when the result set is large.
sort	string (asc, desc)	no	Sort direction: ‘asc’ or ‘desc’. Maps to the GitLab sort query parameter.

storage_move.retrieve_group

List repository storage moves for a single group. Returns: the group’s storage moves with state, source and destination storage names, creation time, and pagination metadata. See also: storage_move.retrieve_all_group, storage_move.get_group_for_group, storage_move.schedule_group.

• Meta-tool: gitlab_storage_move, action retrieve_group
• Individual tool: gitlab_retrieve_group_storage_moves
• Tier: Premium
• Behavior: read-only, idempotent

Parameter	Type	Mandatory	Description
group_id	integer	yes	Numeric ID of the group
order_by	string	no	Column to order keyset-paginated results by (e.g. id). Only used when pagination=‘keyset’.
page	integer	no	Page number to fetch, 1-based. Defaults to 1. Use the next_page field from the previous response to paginate forward.
page_token	string	no	Keyset pagination cursor: record id at which to fetch the next page, taken from the previous keyset response. Only used when pagination=‘keyset’.
pagination	string	no	Pagination method: ‘keyset’ for keyset-based pagination on large ordered result sets, or ‘offset’ (the default). Keyset avoids deep-offset cost.
per_page	integer	no	Items per page. Defaults to 20, minimum 1, maximum 100. Use 100 to minimize round trips when the result set is large.
sort	string (asc, desc)	no	Sort direction for keyset-paginated results: asc or desc. Only used when pagination=‘keyset’.

storage_move.retrieve_project

List repository storage moves for a single project. Returns: each move’s id, state, source and destination storage shards, and project. Admin-only and self-managed only. See also: storage_move.get_project_for_project, storage_move.schedule_project.

• Meta-tool: gitlab_storage_move, action retrieve_project
• Individual tool: gitlab_retrieve_project_storage_moves
• Tier: Free
• Behavior: read-only, idempotent

Parameter	Type	Mandatory	Description
project_id	integer	yes	Numeric ID of the project
order_by	string	no	Column to order keyset-paginated results by (e.g. id). Only applies when pagination=‘keyset’.
page	integer	no	Page number to fetch, 1-based. Defaults to 1. Use the next_page field from the previous response to paginate forward.
page_token	string	no	Keyset pagination cursor: record id at which to fetch the next page, taken from the previous keyset response. Only used when pagination=‘keyset’.
pagination	string	no	Pagination method: ‘keyset’ for keyset-based pagination on large ordered result sets, or ‘offset’ (the default). Keyset avoids deep-offset cost.
per_page	integer	no	Items per page. Defaults to 20, minimum 1, maximum 100. Use 100 to minimize round trips when the result set is large.
sort	string (asc, desc)	no	Sort direction for keyset-paginated results: asc or desc. Only applies when pagination=‘keyset’.

storage_move.retrieve_snippet

List repository storage moves for one snippet with ordering and pagination. Returns: storage moves scoped to the snippet with state, source and destination storage shards, and pagination metadata. See also: storage_move.get_snippet_for_snippet, storage_move.retrieve_all_snippet, storage_move.schedule_snippet.

• Meta-tool: gitlab_storage_move, action retrieve_snippet
• Individual tool: gitlab_retrieve_snippet_storage_moves
• Tier: Free
• Behavior: read-only, idempotent

Parameter	Type	Mandatory	Description
snippet_id	integer	yes	Numeric ID of the snippet
order_by	string	no	Field to order results by (for example ‘id’). Maps to the GitLab order_by query parameter.
page	integer	no	Page number to fetch, 1-based. Defaults to 1. Use the next_page field from the previous response to paginate forward.
page_token	string	no	Keyset pagination cursor: record id at which to fetch the next page, taken from the previous keyset response. Only used when pagination=‘keyset’.
pagination	string	no	Pagination method: ‘keyset’ for keyset-based pagination on large ordered result sets, or ‘offset’ (the default). Keyset avoids deep-offset cost.
per_page	integer	no	Items per page. Defaults to 20, minimum 1, maximum 100. Use 100 to minimize round trips when the result set is large.
sort	string (asc, desc)	no	Sort direction: ‘asc’ or ‘desc’. Maps to the GitLab sort query parameter.

storage_move.schedule_all_group

Schedule repository storage moves for all groups on a source storage shard. Returns: a confirmation that the bulk move has been scheduled. See also: storage_move.retrieve_all_group, storage_move.schedule_group.

• Meta-tool: gitlab_storage_move, action schedule_all_group
• Individual tool: gitlab_schedule_all_group_storage_moves
• Tier: Premium
• Behavior: writes, not idempotent

Parameter	Type	Mandatory	Description
destination_storage_name	string	no	Name of the destination storage shard
source_storage_name	string	no	Name of the source storage shard

storage_move.schedule_all_project

Schedule repository storage moves for all projects on a Gitaly storage shard. Drains source_storage_name onto destination_storage_name. Returns: a confirmation message. Admin-only and self-managed only. See also: storage_move.retrieve_all_project, storage_move.schedule_project.

• Meta-tool: gitlab_storage_move, action schedule_all_project
• Individual tool: gitlab_schedule_all_project_storage_moves
• Tier: Free
• Behavior: writes, not idempotent

Parameter	Type	Mandatory	Description
destination_storage_name	string	no	Name of the destination storage shard
source_storage_name	string	no	Name of the source storage shard

storage_move.schedule_all_snippet

Schedule repository storage moves for all snippets on a source Gitaly storage shard. Returns: a confirmation that the bulk move was scheduled. See also: storage_move.retrieve_all_snippet, storage_move.schedule_snippet.

• Meta-tool: gitlab_storage_move, action schedule_all_snippet
• Individual tool: gitlab_schedule_all_snippet_storage_moves
• Tier: Free
• Behavior: writes, not idempotent

Parameter	Type	Mandatory	Description
destination_storage_name	string	no	Name of the destination storage shard
source_storage_name	string	no	Name of the source storage shard

storage_move.schedule_group

Schedule a repository storage move for a single group. Returns: the scheduled storage move with state, source and destination storage names, and group reference. See also: storage_move.retrieve_group, storage_move.get_group_for_group, storage_move.schedule_all_group.

• Meta-tool: gitlab_storage_move, action schedule_group
• Individual tool: gitlab_schedule_group_storage_move
• Tier: Premium
• Behavior: writes, not idempotent

Parameter	Type	Mandatory	Description
group_id	integer	yes	Numeric ID of the group
destination_storage_name	string	no	Name of the destination storage shard

storage_move.schedule_project

Schedule a repository storage move for a single project to another Gitaly storage shard. Returns: the created move’s id, state, source and destination shards, and project. Admin-only and self-managed only. See also: storage_move.retrieve_project, storage_move.schedule_all_project.

• Meta-tool: gitlab_storage_move, action schedule_project
• Individual tool: gitlab_schedule_project_storage_move
• Tier: Free
• Behavior: writes, not idempotent

Parameter	Type	Mandatory	Description
project_id	integer	yes	Numeric ID of the project
destination_storage_name	string	no	Name of the destination storage shard

storage_move.schedule_snippet

Schedule a repository storage move for one snippet to a destination Gitaly storage shard. Returns: the scheduled storage move with its initial state and the associated snippet. See also: storage_move.retrieve_snippet, storage_move.get_snippet_for_snippet, storage_move.schedule_all_snippet.

• Meta-tool: gitlab_storage_move, action schedule_snippet
• Individual tool: gitlab_schedule_snippet_storage_move
• Tier: Free
• Behavior: writes, not idempotent

Parameter	Type	Mandatory	Description
snippet_id	integer	yes	Numeric ID of the snippet
destination_storage_name	string	no	Name of the destination storage shard