# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for GitHub v3 REST Migrations API version: 1.0.0 extends: openapi/github-migrations-api-openapi.yml actions: - target: $.info update: x-apievangelist-phrasing: method: generated generated: '2026-09-24' generator: build-phrasing.py label: Generated by API Evangelist operations: 11 - target: $.paths['/orgs/{org}/migrations'].get update: x-apievangelist-phrasing: intent: List an organization's recent migrations effect: read questions: - What migrations have been run for my organization recently, exports and imports alike? - Can I see which organization migration exports are still in progress? instructions: - text: List the recent migrations for the {org} organization. slots: org: path.org - text: Show the last {per_page} migrations for {org}. slots: org: path.org per_page: query.per_page method: generated generated: '2026-09-24' - target: $.paths['/orgs/{org}/migrations'].post update: x-apievangelist-phrasing: intent: Start an organization migration export effect: write questions: - How do I export several of my organization's repositories into a migration archive? - Can I lock repositories while their organization migration archive is being generated? - Is it possible to leave out releases or attachments when exporting an org's repos? instructions: - text: Start an organization migration for {org} covering the repositories {repositories}. slots: org: path.org repositories: requestBody.repositories - text: Export {repositories} from {org} into a migration archive and lock them during the export ({lock_repositories}). slots: org: path.org repositories: requestBody.repositories lock_repositories: requestBody.lock_repositories method: generated generated: '2026-09-24' - target: $.paths['/orgs/{org}/migrations/{migration_id}'].get update: x-apievangelist-phrasing: intent: Check an organization migration's status effect: read questions: - Has my organization's migration export finished yet, or is it still exporting? - What state is a specific org migration in right now? instructions: - text: Get the status of migration {migration_id} for the {org} organization. slots: org: path.org migration_id: path.migration_id - text: Check whether org migration {migration_id} in {org} is exported or failed. slots: org: path.org migration_id: path.migration_id method: generated generated: '2026-09-24' - target: $.paths['/orgs/{org}/migrations/{migration_id}/archive'].get update: x-apievangelist-phrasing: intent: Download an organization migration archive effect: read questions: - Where do I download the archive once my organization migration is exported? - Can I get a download link for a finished org migration archive? instructions: - text: Get the download URL for the archive of migration {migration_id} in {org}. slots: org: path.org migration_id: path.migration_id - text: Download the {org} organization's migration archive for migration {migration_id}. slots: org: path.org migration_id: path.migration_id method: generated generated: '2026-09-24' - target: $.paths['/orgs/{org}/migrations/{migration_id}/archive'].delete update: x-apievangelist-phrasing: intent: Delete an organization migration archive effect: destructive questions: - Can I delete an organization migration archive before the seven-day automatic cleanup? - How do I remove an old org export archive I no longer need? instructions: - text: Delete the archive for migration {migration_id} in the {org} organization. slots: org: path.org migration_id: path.migration_id - text: Remove the {org} org's migration archive from export {migration_id} now instead of waiting seven days. slots: org: path.org migration_id: path.migration_id method: generated generated: '2026-09-24' - target: $.paths['/orgs/{org}/migrations/{migration_id}/repos/{repo_name}/lock'].delete update: x-apievangelist-phrasing: intent: Unlock a repository locked for migration effect: destructive questions: - My repository is still locked after an organization migration; how do I unlock it? - What do I do with repos that were locked during an org export once the migration is done? instructions: - text: Unlock repository {repo_name} that was locked by migration {migration_id} in {org}. slots: org: path.org migration_id: path.migration_id repo_name: path.repo_name - text: Release the migration lock on {repo_name} in the {org} organization for migration {migration_id}. slots: org: path.org migration_id: path.migration_id repo_name: path.repo_name method: generated generated: '2026-09-24' - target: $.paths['/orgs/{org}/migrations/{migration_id}/repositories'].get update: x-apievangelist-phrasing: intent: List repositories in an organization migration effect: read questions: - Which repositories are included in a given organization migration? - Can I check what repos an org export actually covered? instructions: - text: List the repositories included in migration {migration_id} for {org}. slots: org: path.org migration_id: path.migration_id - text: Show which repos the {org} organization exported in migration {migration_id}. slots: org: path.org migration_id: path.migration_id method: generated generated: '2026-09-24' - target: $.paths['/user/migrations'].get update: x-apievangelist-phrasing: intent: List my user migrations effect: read questions: - What personal account migrations have I started? - Can I see all the user migration exports I've kicked off on GitHub? instructions: - text: List all the user migrations I've started. - text: Show page {page} of my personal account migrations. slots: page: query.page method: generated generated: '2026-09-24' - target: $.paths['/user/migrations'].post update: x-apievangelist-phrasing: intent: Start a user migration export effect: write questions: - How do I export my own personal repositories into a migration archive? - Can I exclude git data or metadata when exporting my user account's repos? instructions: - text: Start a user migration that exports my repositories {repositories}. slots: repositories: requestBody.repositories - text: Create a personal migration archive for {repositories} and lock them while exporting ({lock_repositories}). slots: repositories: requestBody.repositories lock_repositories: requestBody.lock_repositories method: generated generated: '2026-09-24' - target: $.paths['/user/migrations/{migration_id}/archive'].get update: x-apievangelist-phrasing: intent: Download my user migration archive effect: read questions: - Where can I download the tar.gz archive from my personal account migration? - What's in a user migration archive once I download it? instructions: - text: Get the download link for my user migration archive {migration_id}. slots: migration_id: path.migration_id - text: Download the tar.gz from my personal migration {migration_id}. slots: migration_id: path.migration_id method: generated generated: '2026-09-24' - target: $.paths['/user/migrations/{migration_id}/repositories'].get update: x-apievangelist-phrasing: intent: List repositories in my user migration effect: read questions: - Which of my repositories were included in a personal account migration? - Can I list the repos covered by one of my own user migrations? instructions: - text: List the repositories in my user migration {migration_id}. slots: migration_id: path.migration_id - text: Show which of my repos personal migration {migration_id} exported. slots: migration_id: path.migration_id method: generated generated: '2026-09-24'