Import endpoints

Batch import is the fastest way to ingest existing projects into SessionDock from external tooling.

Main route

• POST /api/v1/import

This route requires full-automation mode.

Import payload structure

Each request includes:

• a default kind
• an optional generatePreviews flag
• an items array with project paths and optional titles

Example

curl \
  -X POST \
  -H "Authorization: Bearer $SESSIONDOCK_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "kind": "Ableton",
    "generatePreviews": true,
    "items": [
      {
        "projectPath": "/Users/me/Music/Projects/Launch Cue",
        "title": "Launch Cue"
      },
      {
        "projectPath": "/Users/me/Music/Projects/Resonance",
        "title": "Resonance"
      }
    ]
  }' \
  "$SESSIONDOCK_BASE_URL/import"

Response behavior

The API acknowledges import with a 202 response and returns import status fields such as:

• importId
• total
• completed
• failed
• skipped
• done

Operational note

Treat import as an accepted background workflow, not a synchronous completion response.