Miosa.BuilderSessions (Miosa v1.0.1)

Copy Markdown View Source

Builder UI session metadata — durable, cross-device Builder state.

Routes live under /api/v1/builder/sessions/ and accept msk_* API keys or JWT. Builder sessions are optimal_sessions with resource_type = "sandbox" and vm_context.template_type = "miosa-sandbox".

Summary

Functions

Delete a builder session (DELETE /builder/sessions/:session_id).

Get a single builder session by ID.

List builder sessions (GET /builder/sessions).

Update the title of a builder session (PATCH /builder/sessions/:session_id/title).

Functions

delete(client, session_id)

@spec delete(Miosa.Client.t(), String.t()) :: :ok | {:error, Miosa.Error.t()}

Delete a builder session (DELETE /builder/sessions/:session_id).

get(client, session_id)

@spec get(Miosa.Client.t(), String.t()) :: Miosa.Client.result(map() | nil)

Get a single builder session by ID.

Falls back to filtering list/2 since the platform router only exposes index + title-update + delete.

list(client, opts \\ [])

List builder sessions (GET /builder/sessions).

Options

  • :limit — Maximum sessions to return. Defaults to 50.
  • Any extra key is forwarded as a query param.

update_title(client, session_id, title)

@spec update_title(Miosa.Client.t(), String.t(), String.t()) ::
  Miosa.Client.result(map())

Update the title of a builder session (PATCH /builder/sessions/:session_id/title).