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
AttributeTypeRequiredDescription
versionintegeryesVersion timestamp of the migration to be skipped
databasestringnoThe 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"