title:Migrations | GitHub API

* TOC

{:toc}

{{#tip}}

To access the Migrations API, you must provide a custom[media type](/v3/media) in the`Accept` header:

{{/tip}}

Initiates the generation of a migration archive.

Name | Type | Description

--------|---------|--------------

`repositories` |`array` of`strings` |**Required**. A list of arrays indicating which repositories should be migrated.

`lock_repositories`|`boolean` | Indicates whether repositories should be locked (to prevent manipulation) while migrating data. Default:`false`.

<%= json\

:repositories =>["octocat/Hello-World"],

:lock_repositories => true

%>

<%= headers 201 %>

<%= json(:migrations) %>

Lists the most recent migrations.

<%= headers 200,:pagination => default_pagination_rels %>

<%= json(:migrations) { |h|[h] } %>

Fetches 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.

<%= headers 200 %>

<%= json(:migrations) { |h| h['state'] = 'exported'; h } %>

Fetches the URL to a migration archive.

<%= headers 302 %>

<preclass="body-response"><code>

https://s3.amazonaws.com/github-cloud/migration/79/67?response-content-disposition=filename%3D0b989ba4-242f-11e5-81e1.tar.gz&response-content-type=application/x-gzip

</code></pre>

Deletes a previous migration archive. Migration archives are automatically deleted after seven days.

<%= headers 204 %>

<h3><ahref="#"class="js-expand-btn collapsed arrow-btn"data-proofer-ignore></a><ahref="/v3/orgs/">Organizations</a></h3>

<ulclass="js-guides">

<li><ahref="/v3/orgs/members/">Members</a></li>

<li><ahref="/v3/orgs/migrations/">Migrations</a></li>

<li><ahref="/v3/orgs/teams/">Teams</a></li>

<li><ahref="/v3/orgs/hooks/">Webhooks</a></li>

ACTIVE_ORG_MEMBERSHIPS ||=[ACTIVE_ADMIN_ORG_MEMBERSHIP]

PENDING_ORG_MEMBERSHIPS ||=[PENDING_ADMIN_ORG_MEMBERSHIP]

MIGRATIONS ||={

LABEL ||={