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

# Confirm Revenue Split

> Access: organization users with revenue split permissions; admins see organization splits and end users see allowed splits.

Confirm the Revenue Split for the current party. When all required parties have confirmed,
the split becomes locked (active).

The header `X-User-Id` must be provided for this endpoint to confirm on behalf of users.



## OpenAPI

````yaml /api-reference/openapi.json post /api/v1/splits/{uuid}/confirm
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/splits/{uuid}/confirm:
    parameters:
      - in: path
        name: uuid
        description: The UUID of the Revenue Split to confirm.
        example: 9b6f4b2e-62b1-4d9f-91e4-6c318a2af010
        required: true
        schema:
          type: string
    post:
      tags:
        - Revenue Splits
      summary: Confirm Revenue Split
      description: >-
        Access: organization users with revenue split permissions; admins see
        organization splits and end users see allowed splits.


        Confirm the Revenue Split for the current party. When all required
        parties have confirmed,

        the split becomes locked (active).


        The header `X-User-Id` must be provided for this endpoint to confirm on
        behalf of users.
      operationId: confirmARevenueSplit
      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 <YOUR_ACCESS_TOKEN>`.
          schema:
            type: string
          example: Bearer <YOUR_ACCESS_TOKEN>
        - 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
        - name: uuid
          in: path
          required: true
          description: Organization-scoped resource identifier.
          schema:
            type: string
          example: f78c0f2e-4b30-4b33-87c5-e0bbd17b2b85
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
              example:
                success: true
                message: Split confirmed successfully.
                data:
                  id: a99f63b8-7df7-4091-a0e0-f9327ff7c8d1
                  title: Midnight Signals Writer Share
                  percentage: 25
                  start_date: '2026-05-01T00:00:00+00:00'
                  end_date: '2026-12-31T00:00:00+00:00'
                  locked: true
                  beneficiary:
                    id: 83c09c76-32a5-4b1a-92fa-30129f8e8e6b
                    uuid: 83c09c76-32a5-4b1a-92fa-30129f8e8e6b
                    organization_id: 2a8d3e82-4a9d-4e33-9d3b-85bb1a93e8d4
                    organization_uuid: 2a8d3e82-4a9d-4e33-9d3b-85bb1a93e8d4
                    name: Eli Brooks
                    full_name: Eli Brooks
                    first_name: Eli
                    last_name: Brooks
                    email: eli.brooks@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
                  creator:
                    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
                split:
                  id: a99f63b8-7df7-4091-a0e0-f9327ff7c8d1
                  title: Midnight Signals Writer Share
                  percentage: 25
                  start_date: '2026-05-01T00:00:00+00:00'
                  end_date: '2026-12-31T00:00:00+00:00'
                  locked: true
                  beneficiary:
                    id: 83c09c76-32a5-4b1a-92fa-30129f8e8e6b
                    uuid: 83c09c76-32a5-4b1a-92fa-30129f8e8e6b
                    organization_id: 2a8d3e82-4a9d-4e33-9d3b-85bb1a93e8d4
                    organization_uuid: 2a8d3e82-4a9d-4e33-9d3b-85bb1a93e8d4
                    name: Eli Brooks
                    full_name: Eli Brooks
                    first_name: Eli
                    last_name: Brooks
                    email: eli.brooks@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
                  creator:
                    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
        '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

````