naftiko: 1.0.0-alpha2
info:
  label: Mubert Music API — Tracks
  description: 'Mubert Music API — Tracks. 7 operations covering create, list, retrieve, edit, record, fetch-by-session, similar, and stored. Self-contained Naftiko capability covering the Tracks business surface.'
  tags:
    - Mubert
    - Tracks
    - Generation
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
  - namespace: env
    keys:
      MUBERT_CUSTOMER_ID: MUBERT_CUSTOMER_ID
      MUBERT_ACCESS_TOKEN: MUBERT_ACCESS_TOKEN
capability:
  consumes:
    - type: http
      namespace: tracks-tracks
      baseUri: https://music-api.mubert.com
      description: Mubert Tracks business capability. Self-contained, no shared references.
      resources:
        - name: tracks
          path: /api/v3/public/tracks
          operations:
            - name: listTracks
              method: GET
              description: List tracks generated by the customer.
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: limit
                  in: query
                  type: integer
                - name: offset
                  in: query
                  type: integer
            - name: createTrack
              method: POST
              description: Create a generative music track from a prompt, playlist, or image.
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: body
                  in: body
                  type: object
                  required: true
        - name: track
          path: /api/v3/public/tracks/{track}
          operations:
            - name: getTrack
              method: GET
              description: Get a track by ID.
              inputParameters:
                - name: track
                  in: path
                  type: string
                  required: true
        - name: trackEdit
          path: /api/v3/public/tracks/{track}/edit
          operations:
            - name: editTrack
              method: POST
              description: Edit track parameters or manipulate instrument/stem composition.
              inputParameters:
                - name: track
                  in: path
                  type: string
                  required: true
                - name: body
                  in: body
                  type: object
                  required: true
        - name: trackSimilar
          path: /api/v3/public/tracks/{track}/similar
          operations:
            - name: generateSimilarTrack
              method: POST
              description: Generate a new track similar to an existing one.
              inputParameters:
                - name: track
                  in: path
                  type: string
                  required: true
                - name: body
                  in: body
                  type: object
        - name: trackStored
          path: /api/v3/public/tracks/stored
          operations:
            - name: getStoredTrack
              method: POST
              description: Retrieve a pre-generated track from the track-store cache.
              inputParameters:
                - name: body
                  in: body
                  type: object
                  required: true
        - name: trackRecord
          path: /api/v3/public/tracks/record
          operations:
            - name: recordTrack
              method: POST
              description: Record a streaming session as a fixed track asset.
              inputParameters:
                - name: body
                  in: body
                  type: object
                  required: true
        - name: trackSession
          path: /api/v3/public/tracks/session/{session_id}
          operations:
            - name: getTrackBySession
              method: GET
              description: Get a track by its session id.
              inputParameters:
                - name: session_id
                  in: path
                  type: string
                  required: true
      authentication:
        type: apikey
        key: customer-id
        value: '{{env.MUBERT_CUSTOMER_ID}}'
        placement: header
  exposes:
    - type: rest
      namespace: tracks-tracks-rest
      port: 8080
      description: REST adapter for Mubert Tracks. One Spectral-compliant resource per consumed operation, prefixed with /v1.
      resources:
        - path: /v1/tracks
          name: tracks
          description: REST surface for Mubert tracks.
          operations:
            - method: POST
              name: createTrack
              description: Create a generative music track.
              call: tracks-tracks.createTrack
              with:
                body: rest.body
            - method: GET
              name: listTracks
              description: List previously generated tracks.
              call: tracks-tracks.listTracks