Public URLs

List a computer’s public URLs

A public URL serves a port inside the computer at https://<label>.<base_domain> (e.g. mandala.dev), on port 443 with no port in the address. The app must listen on 0.0.0.0:<port>, not 127.0.0.1.

enabled is false, with a reason, where public URLs are off here or the account’s plan includes none; the computer’s URLs are listed either way, so you can see and delete what you made. If the plan drops below the number a computer has, the oldest within the new limit keep answering and the rest answer 404 until the plan allows them again.

While a change of this computer’s workspace is unsettled, this is a 409 with code WORKSPACE_MOVING: reason: "contention" while the move is being made (try again once it has finished), or reason: "unsupported" when its outcome was lost (check the workspace change in the dashboard). How a URL answers, and who may open a private one, is set out under POST /computers/{id}/public-urls.

Requires the viewer role or higher.

get/computers/{id}/public-urls

Request

  • Base URL: https://app.mandala.computer/api/v1
  • URL: https://app.mandala.computer/api/v1/computers/{id}/public-urls
  • Auth: HTTP bearer

Path parameters

idstring required

The computer id.

Response

Whether they can answer, the limit, and the URLs, oldest first.

enabledboolean required

Whether this computer’s URLs can answer here: false where the feature is off or the account’s plan has no public URLs, with reason saying which.

reasonstring

Why enabled is false. Absent when it is true.

base_domainstring required

The domain every label sits under, e.g. mandala.dev.

limitinteger required

How many public URLs this computer may have on the account’s plan.

Changes

No recorded changes to this operation across all 1 revision of this API.