gitlab-foss/doc/api/database_migrations.md

stage, group, info, title

stage	group	info	title
Data Access	Database Frameworks	To determine the technical writer assigned to the Stage/Group associated with this page, see https://handbook.gitlab.com/handbook/product/ux/technical-writing/#assignments	Database migrations API

{{< details >}}

• Tier: Free, Premium, Ultimate
• Offering: GitLab Self-Managed

{{< /details >}}

{{< history >}}

• Introduced in GitLab 16.2.

{{< /history >}}

Use this API to manage GitLab database migrations.

Prerequisites:

• You must have administrator access to the instance.

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"