Skip to main content

migrations

Overview

Namemigrations
TypeResource
Idgithub.migrations.migrations

Fields

NameDatatypeDescription
idinteger
archive_urlstring
created_atstring
excludearrayExclude related items from being returned in the response in order to improve performance of the request. The array can include any of: "repositories".
exclude_attachmentsboolean
exclude_git_databoolean
exclude_metadataboolean
exclude_owner_projectsboolean
exclude_releasesboolean
guidstring
lock_repositoriesboolean
node_idstring
org_metadata_onlyboolean
ownerobjectA GitHub user.
repositoriesarrayThe repositories included in the migration. Only returned for export migrations.
statestring
updated_atstring
urlstring

Methods

NameAccessible byRequired ParamsDescription
get_status_for_authenticated_userSELECTmigration_idFetches a single user migration. The response includes the state of the migration, which can be one of the following values:

pending - the migration hasn't started yet.
exporting - the migration is in progress.
exported - the migration finished successfully.
failed - the migration failed.

Once the migration has been exported you can download the migration archive.
get_status_for_orgSELECTmigration_id, orgFetches the status of a migration.

The state of a migration can be one of the following values:

pending, which means the migration hasn't started yet.
exporting, which means the migration is in progress.
exported, which means the migration finished successfully.
failed, which means the migration failed.
list_for_authenticated_userSELECTLists all migrations a user has started.
list_for_orgSELECTorgLists the most recent migrations, including both exports (which can be started through the REST API) and imports (which cannot be started using the REST API).

A list of repositories is only returned for export migrations.
start_for_authenticated_userEXECdata__repositoriesInitiates the generation of a user migration archive.
start_for_orgEXECorg, data__repositoriesInitiates the generation of a migration archive.