SessionDock Developer Docs

Make your creative workflow programmable.

Authoritative guides, generated Local API reference, and practical patterns for local automation, scripts, launchers, and AI agents running alongside SessionDock.

Trigger a batch import

Starts a batch import and returns accepted status when available.

POST/api/v1/import

Starts a batch import and returns accepted status when available.

curl -X POST 'http://127.0.0.1:18432/api/v1/import' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "kind": "Ableton",
  "generatePreviews": true,
  "items": [
    {
      "projectPath": "<string>",
      "title": "<string>",
      "projectType": "<string>",
      "previewAudioPath": "<string>"
    }
  ]
}'

Request Body

Required

application/json

Schema Shape

{
  "kind": "Ableton",
  "generatePreviews": true,
  "items": [
    {
      "projectPath": "<string>",
      "title": "<string>",
      "projectType": "<string>",
      "previewAudioPath": "<string>"
    }
  ]
}

Example

{
  "kind": "Ableton",
  "generatePreviews": true,
  "items": [
    {
      "projectPath": "<string>",
      "title": "<string>",
      "projectType": "<string>",
      "previewAudioPath": "<string>"
    }
  ]
}

Responses

202

Accepted import

application/json

Schema Shape

{
  "data": {
    "importId": "<string>",
    "total": 0,
    "completed": 0,
    "failed": 0,
    "skipped": 0,
    "done": true,
    "durationMs": 0
  }
}

Example

{
  "data": {
    "importId": "<string>",
    "total": 0,
    "completed": 0,
    "failed": 0,
    "skipped": 0,
    "done": true,
    "durationMs": 0
  }
}
400

Malformed JSON or rejected input.

application/json

Schema Shape

{
  "error": {
    "status": 0,
    "code": "<string>",
    "message": "<string>"
  }
}

Example

{
  "error": {
    "status": 400,
    "code": "invalid_json",
    "message": "Request body must be valid JSON."
  }
}
401

Missing or invalid bearer token.

application/json

Schema Shape

{
  "error": {
    "status": 0,
    "code": "<string>",
    "message": "<string>"
  }
}

Example

{
  "error": {
    "status": 401,
    "code": "unauthorized",
    "message": "Provide Authorization: Bearer <token>."
  }
}
403

Write attempted while Local API is in read-only mode.

application/json

Schema Shape

{
  "error": {
    "status": 0,
    "code": "<string>",
    "message": "<string>"
  }
}

Example

{
  "error": {
    "status": 403,
    "code": "read_only",
    "message": "Enable Full Automation to perform this action."
  }
}
501

Import service is unavailable in the current runtime.

application/json

Schema Shape

{
  "error": {
    "status": 0,
    "code": "<string>",
    "message": "<string>"
  }
}

Example

{
  "error": {
    "status": 501,
    "code": "import_unavailable",
    "message": "Import service is unavailable."
  }
}
PreviousBring SessionDock forward and focus a session card