Skip to main content
GET
Show one Mist

Authorizations

Authorization
string
header
required

Bearer token authentication. Accepts company admin tokens with the matching mist.* permission:

  • mist.view to list and show Mists
  • mist.create to create and rename Mists, and to turn on visitor numbers
  • mist.destroy to delete and restore Mists
  • mist.code for deployments, logs, and traffic
  • mist.env_vars to read and manage environment variables Droplet installation tokens are refused.

Path Parameters

id
string<uuid>
required

UUID of the company-owned Mist app.

Response

The mist

mist
object

One Mist hosting as GET /api/v202604/mists/{id} and a name-only PATCH /api/v202604/mists/{id} return it. A hosting a member site depends on has kind site_backend; the other operations never return one.