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.

Open the session in its DAW or project context

POST/api/v1/sessions/{id}/open

curl -X POST 'http://127.0.0.1:18432/api/v1/sessions/session_123/open' \
  -H 'Authorization: Bearer <token>'

Parameters

Name	In	Type	Required	Description	Example
id	path	string	Yes	Session identifier.	session_123

Responses

200

Open acknowledgement

application/json

Schema Shape

{
  "data": {
    "id": "<string>",
    "opened": true,
    "focused": true
  }
}

Example

{
  "data": {
    "id": "<string>",
    "opened": true,
    "focused": true
  }
}

400

Open action failed.

application/json

Schema Shape

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

Example

{
  "error": {
    "status": 400,
    "code": "open_failed",
    "message": "Session project path is unavailable."
  }
}

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."
  }
}

404

No matching resource was found.

application/json

Schema Shape

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

Example

{
  "error": {
    "status": 404,
    "code": "not_found",
    "message": "session not found"
  }
}

PreviousReplace waveform notes NextBring SessionDock forward and focus a session card