Miosa.Sandbox.Previews (Miosa v1.0.1)

Copy Markdown View Source

Preview URL management for a sandbox.

Wraps /sandboxes/:id/previews/* — list, create, get, delete, share (mint token), and revoke share tokens.

Summary

Functions

Create a new preview for a port (POST /sandboxes/:sandbox_id/previews).

Delete a preview (DELETE /sandboxes/:sandbox_id/previews/:preview_id).

Get a preview by ID (GET /sandboxes/:sandbox_id/previews/:preview_id).

List preview records for a sandbox (GET /sandboxes/:sandbox_id/previews).

Invalidate every share token for a preview (DELETE /sandboxes/:sandbox_id/previews/:preview_id/share).

Mint a share token for a preview (POST /sandboxes/:sandbox_id/previews/:preview_id/share).

Functions

create(client, sandbox_id, port, opts \\ %{})

Create a new preview for a port (POST /sandboxes/:sandbox_id/previews).

port is required. Additional opts are merged into the body.

delete(client, sandbox_id, preview_id)

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

Delete a preview (DELETE /sandboxes/:sandbox_id/previews/:preview_id).

get(client, sandbox_id, preview_id)

Get a preview by ID (GET /sandboxes/:sandbox_id/previews/:preview_id).

list(client, sandbox_id)

List preview records for a sandbox (GET /sandboxes/:sandbox_id/previews).

revoke_share(client, sandbox_id, preview_id)

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

Invalidate every share token for a preview (DELETE /sandboxes/:sandbox_id/previews/:preview_id/share).

share(client, sandbox_id, preview_id, expires_in_sec \\ 3600)

Mint a share token for a preview (POST /sandboxes/:sandbox_id/previews/:preview_id/share).

expires_in_sec defaults to 3600 (one hour).