Doseedo API

openapi: 3.1.0
info:
  title: Doseedo API
  version: '2026-11-05'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-05: 8 operation(s) read from 11 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Doseedo has published no machine-readable contract that the pipeline
    could find. Engine: local.'
  x-evidence-tiers:
    code-example: 3
    documentation: 5
    pages-with-code: 6
    pages-read: 11
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-05'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://doseedo.com/guides/reaper-mcp-server
  - https://doseedo.com/guides/cubase-mcp-server
  - https://doseedo.com/guides/bitwig-mcp-server
  - https://doseedo.com/guides/control-your-daw-from-cursor
  - https://doseedo.com/guides/audio-to-midi-mcp-server
  - https://doseedo.com/guides/music-generation-mcp-server
  - https://doseedo.com/guides/render-midi-with-real-instruments
  - https://doseedo.com/guides/sound-effects-foley-mcp-server
  - https://doseedo.com/guides/bounce-stems-without-opening-your-daw
  - https://doseedo.com/guides/control-ableton-with-python
  - https://doseedo.com/guides/control-logic-pro-with-python
servers:
- url: https://api.doseedo.com
paths:
  /api/audio-to-session:
    post:
      operationId: post_api_audio_to_session
      tags:
      - Api
      summary: 'Generate a set from audio: turns a mix into a native .als with separated stems, tempo map, optional per‑stem MIDI and a chord
        guide.'
      x-source: https://doseedo.com/guides/control-ableton-with-python
      parameters:
      - name: target
        in: query
        required: true
        schema:
          type: string
        description: The DAW format to generate, e.g., "ableton".
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/convert:
    post:
      operationId: post_api_convert
      tags:
      - Api
      summary: Convert an .als natively to Logic, FL Studio, REAPER or Pro Tools (or any of them to an .als).
      x-source: https://doseedo.com/guides/control-ableton-with-python
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/instruments:
    get:
      operationId: get_api_instruments
      tags:
      - Api
      summary: Lists the modelled instruments available in the catalog.
      description: Retrieves the instrument catalog used by doseedo_render_midi and other tools.
      x-source: https://doseedo.com/guides/music-generation-mcp-server
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/jobs:
    post:
      operationId: post_api_jobs
      tags:
      - Api
      summary: POST /api/jobs
      x-source: https://doseedo.com/guides/render-midi-with-real-instruments
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiJobsRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -s -X POST https://api.doseedo.com/api/jobs  -H \"X-API-Key: $DOO_API_KEY\"  -H 'Content-Type: application/json'  -H 'Idempotency-Key:\
          \ cue-1m1-cello-v1'  -d '{\"kind\":\"render_midi\",\"input\":{\"instrument\":\"cello\",\"bpm\":72,\"takes\":2,\"name\":\"cue-1m1-cello\"\
          ,\n \"notes\":[{\"pitch\":48,\"start_beats\":0,\"duration_beats\":2,\"velocity\":80},\n {\"pitch\":55,\"start_beats\":2,\"duration_beats\"\
          :2,\"velocity\":88}]}}' \n Th"
  /api/jobs/kinds/render_midi:
    get:
      operationId: get_api_jobs_kinds_render_midi
      tags:
      - Api
      summary: Retrieve the full schema for the render_midi job kind.
      description: Provides the complete JSON schema for the render_midi job, useful for validation and client generation.
      x-source: https://doseedo.com/guides/render-midi-with-real-instruments
      parameters:
      - name: X-API-Key
        in: header
        required: true
        schema:
          type: string
        description: API key for authentication.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiJobsKindsRenderMidiResponse'
      x-evidence:
        kind: documentation
  /api/jobs/{id}:
    get:
      operationId: get_api_jobs_id
      tags:
      - Api
      summary: Poll a job for its status and retrieve the result.
      description: GET https://api.doseedo.com/api/jobs/{id}?wait=50 returns the job object, including status and output files.
      x-source: https://doseedo.com/guides/sound-effects-foley-mcp-server
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: wait
        in: query
        required: false
        schema:
          type: integer
        description: Number of seconds to long‑poll the job.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiJobsIdResponse'
      x-evidence:
        kind: documentation
  /api/jobs/{id}/events:
    get:
      operationId: get_api_jobs_id_events
      tags:
      - Api
      summary: Stream job state changes via Server‑Sent Events.
      description: Long‑polls the job and streams updates until it completes or the wait timeout expires.
      x-source: https://doseedo.com/guides/render-midi-with-real-instruments
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: wait
        in: query
        required: false
        schema:
          type: integer
        description: Maximum seconds to hold the connection (max 50).
      - name: X-API-Key
        in: header
        required: true
        schema:
          type: string
        description: API key for authentication.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiJobsIdEventsResponse'
      x-evidence:
        kind: documentation
  /mcp:
    get:
      operationId: get_mcp
      tags:
      - Mcp
      summary: GET /mcp
      x-source: https://doseedo.com/guides/reaper-mcp-server
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl for 24 hours, with no key on the download. Those links are reusable as the input of the next tool, so a separated stem\
          \ feeds the transcriber and a generated take lands on a session track without a round trip through your disk. \n What it does not do:\
          \ read this before you install \n No live control of a running REAPER. No transport, no live FX tweaks, no reading the project REAPER\
          \ has open right"
components:
  schemas:
    PostApiJobsRequest:
      type: object
      properties:
        kind:
          type: string
        input:
          type: object
          properties:
            instrument:
              type: string
            bpm:
              type: integer
            takes:
              type: integer
            name:
              type: string
            notes:
              type: array
              items:
                type: object
                properties:
                  pitch:
                    type: integer
                  start_beats:
                    type: integer
                  duration_beats:
                    type: integer
                  velocity:
                    type: integer
    GetApiJobsKindsRenderMidiResponse:
      type: object
      properties:
        schema:
          type: object
          description: OpenAPI‑style JSON schema describing all fields accepted by the render_midi kind.
    GetApiJobsIdResponse:
      type: object
      properties:
        kind:
          type: string
          description: The kind of job, e.g., "generate_sound".
        status:
          type: string
          description: Job status, e.g., "succeeded".
        output:
          type: object
          description: Result of the job.
        artifacts:
          type: array
          description: List of generated files with URLs and metadata.
    GetApiJobsIdEventsResponse:
      type: object
      properties:
        event:
          type: object
          description: Server‑Sent Event payload containing job updates (status, progress, etc.).
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-API-Key
security:
- apiKey: []
tags:
- name: Api
- name: Mcp