> ## Documentation Index > Fetch the complete documentation index at: https://docs.spacemedia.uk/llms.txt > Use this file to discover all available pages before exploring further. # Start Release Migration > Access: organization users with release permissions; `X-User-Id` may target a same-organization user where allowed. ## OpenAPI ````yaml /api-reference/openapi.json post /api/v1/releases/migrate openapi: 3.1.0 info: title: SpaceMedia Public API version: 1.0.0 description: >- Production public API reference for SpaceMedia organization admins, permitted team members, end users, and API clients. The spec excludes SpaceMedia system/backoffice routes and cross-organization selectors. contact: name: SpaceMedia Support email: whitelabel@spacemedia.uk url: https://spacemedia.uk/contact servers: - url: https://enterprise.spacemedia.uk description: Production security: - bearerAuth: [] tags: - name: Authentication description: 'Access: API client credential flow.' x-mint: icon: key - name: Account Settings description: 'Access: authenticated organization user.' x-mint: icon: settings - name: Reference Data description: 'Access: authenticated organization users and API clients.' x-mint: icon: globe - name: Artists description: >- Access: organization users with artist permissions; `X-User-Id` may target a same-organization user where allowed. x-mint: icon: mic - name: Releases description: >- Access: organization users with release permissions; `X-User-Id` may target a same-organization user where allowed. x-mint: icon: disc - name: Tracks description: >- Access: organization users with track permissions; `X-User-Id` may target a same-organization user where allowed. x-mint: icon: music - name: Revenue Splits description: >- Access: organization users with revenue split permissions; admins see organization splits and end users see allowed splits. x-mint: icon: percent - name: User Management description: >- Access: organization admins or users allowed by user policies. Cross-organization selectors are excluded from this public spec. x-mint: icon: users - name: Plans & Upgrades description: >- Access: organization admins for plan lists; authenticated end users for upgrade options. x-mint: icon: package - name: Billing & Checkouts description: >- Access: authenticated organization users. Gateway availability depends on organization settings. x-mint: icon: credit-card - name: Add-On Management description: 'Access: organization admins for add-on checkout and lifecycle actions.' x-mint: icon: blocks - name: Copyright Management description: >- Access: organization admins or users with copyright wallet and release access. System-only provider and adjustment actions are excluded. x-mint: icon: shield-check - name: Quality Control description: 'Access: organization admins with release processing permission.' x-mint: icon: clipboard-check paths: /api/v1/releases/migrate: post: tags: - Releases summary: Start Release Migration description: >- Access: organization users with release permissions; `X-User-Id` may target a same-organization user where allowed. operationId: migrateRelease parameters: - name: Accept in: header required: false description: Use `application/json` for API responses. schema: type: string example: application/json - name: Authorization in: header required: false description: Bearer access token. Use `Bearer `. schema: type: string example: Bearer - in: header name: X-User-Id description: >- Optional user UUID to perform the request on behalf of a user in the same organization. example: 42e6f4a8-9b12-4f7a-8c55-9d7f6a2b1234 schema: type: string requestBody: required: true content: application/json: schema: type: object additionalProperties: true example: urls: - https://open.spotify.com/album/demo distributor: distrokid responses: '200': description: Success content: application/json: schema: type: object additionalProperties: true example: data: - id: f78c0f2e-4b30-4b33-87c5-e0bbd17b2b85 uuid: f78c0f2e-4b30-4b33-87c5-e0bbd17b2b85 title: Midnight Signals status: draft created_at: '2026-04-15T10:20:00+00:00' viewUrl: /releases/f78c0f2e-4b30-4b33-87c5-e0bbd17b2b85/edit created_by: id: 9d7046b2-3ab1-4c9d-9bd8-90bbd22b7df2 uuid: 9d7046b2-3ab1-4c9d-9bd8-90bbd22b7df2 organization_id: 2a8d3e82-4a9d-4e33-9d3b-85bb1a93e8d4 organization_uuid: 2a8d3e82-4a9d-4e33-9d3b-85bb1a93e8d4 name: Maya Chen full_name: Maya Chen first_name: Maya last_name: Chen email: maya.chen@example.test phone: '+442071838750' language: en country: United Kingdom address: 22 Demo Lane, London photo: null profile_photo: null verified: true email_verified_at: '2026-04-10T08:15:00+00:00' last_login_at: '2026-04-18T08:45:00+00:00' created_at: '2026-03-20T09:00:00+00:00' updated_at: '2026-04-18T08:45:00+00:00' is_suspended: false suspended_at: null invitation_status: accepted is_invited: false roles: - id: role-admin-demo uuid: role-admin-demo name: Admin cover_art: >- https://cdn.spacemedia.uk/demo/releases/midnight-signals-cover.jpg image: >- https://cdn.spacemedia.uk/demo/releases/midnight-signals-cover.jpg resizedImage: >- https://cdn.spacemedia.uk/demo/releases/midnight-signals-cover-512.jpg numberOfTracks: 2 scheduled_date: '2026-06-19' version: null label: Demo Label genre: Electronic secondary_genre: Ambient language: English is_copyrighted: false copyright_links: [] is_parental_advisory: false format: single upc_code: '5051234567890' reference_number: DLG-2026-001 gidr: null description: A production-safe demo release used in API examples. price_category: mid digital_release_date: '2026-06-19' original_release_date: '2026-04-01' license_type: copyright creative_commons_license: null license_holder_year: 2026 license_holder_name: Demo Label Group Ltd sound_recordings_copyright_year: 2026 sound_recordings_copyright_name: Demo Label Group Ltd distribution: channels: - spotify - apple_music - youtube_music territories: - GB - US - DE submitted_at: null artists: - id: 4cbb71fa-6e92-4a8b-9c3d-0b6811ef6f1b uuid: 4cbb71fa-6e92-4a8b-9c3d-0b6811ef6f1b name: Nova Vale url: /artists/4cbb71fa-6e92-4a8b-9c3d-0b6811ef6f1b viewUrl: /artists/4cbb71fa-6e92-4a8b-9c3d-0b6811ef6f1b editRoute: /artists/4cbb71fa-6e92-4a8b-9c3d-0b6811ef6f1b/edit artist_type: Primary Artist spotify_id: 6dDemoNovaVale releases_count: 1 tracks_count: 2 total_releases: 1 total_tracks: 2 total_streams: 125000 metadata: country: GB created_at: '2026-03-22T11:00:00+00:00' updated_at: '2026-04-15T10:20:00+00:00' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '422': $ref: '#/components/responses/ValidationError' security: - bearerAuth: [] components: responses: Unauthorized: description: Unauthorized content: application/json: example: success: false message: Missing bearer token Forbidden: description: Forbidden content: application/json: example: success: false message: This action is unauthorized. NotFound: description: Not found content: application/json: example: success: false message: Resource not found ValidationError: description: Validation error content: application/json: example: success: false message: Validation failed. errors: title: - The title field is required. securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: Sanctum token ````