Database migrations API

{{< details >}}

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

{{< /details >}}

{{< history >}}

{{< /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"