Skip to content

Fetch an existing entry from migration history

get/v1/projects/{ref}/database/migrations/{version}

OAuth scopes

  • database:read

The fine-grained token must include the following permissions to access this endpoint:

  • database_migrations_read

Path parameters

  • ref
    Required
    string

    Project ref

  • version
    Required
    string

Response codes

  • 200
  • 401
  • 403
  • 429
  • 500

Response (200)

{
  "version": "lorem",
  "name": "lorem",
  "statements": [
    "lorem"
  ],
  "rollback": [
    "lorem"
  ],
  "created_by": "lorem",
  "idempotency_key": "lorem"
}
{
  "type": "object",
  "properties": {
    "version": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "statements": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "rollback": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "created_by": {
      "type": "string"
    },
    "idempotency_key": {
      "type": "string"
    }
  },
  "required": [
    "version"
  ]
}