Mark a migration as successful

Database migrations API

Introduced in GitLab 16.2.

This API is for managing database migrations used in the development of GitLab.

All methods require administrator authorization.

Mark a migration as successful

Mark pending migrations as successfully executed to prevent them from being executed by the db:migrate tasks. Use this API to skip failing migrations after they are determined to be safe to skip.

POST /api/v4/admin/migrations/:version/mark

Attribute	Type	Required	Description
`version`	integer	yes	Version timestamp of the migration to be skipped
`database`	string	no	The database name for which the migration is skipped. Defaults to `main`.

curl --header "PRIVATE-TOKEN: <your_access_token>" \
   --url "https://gitlab.example.com/api/v4/admin/migrations/:version/mark"

Help & feedback

Docs

Edit this page to fix an error or add an improvement in a merge request.
Create an issue to suggest an improvement to this page.

Product

Create an issue if there's something you don't like about this feature.
Propose functionality by submitting a feature request.
Join First Look to help shape new features.

Feature availability and product trials

View pricing to see all GitLab tiers and features, or to upgrade.
Try GitLab for free with access to all features for 30 days.

Get Help

If you didn't find what you were looking for, search the docs.

If you want help with something specific and could use community support, post on the GitLab forum.

For problems setting up or using this feature (depending on your GitLab subscription).

Request support