Skip to main content
GET
List the current company's Mists, newest first

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
  • mist.destroy to delete and restore Mists
  • mist.code for deployments and logs
  • mist.env_vars to read and manage environment variables Droplet installation tokens are refused.

Query Parameters

filter[state]
enum<string>

Return only Mists in this lifecycle state.

Available options:
provisioning,
live,
failed,
pending_destroy,
archived
filter[kind]
string

Return only Mists of this kind, such as next_app.

page[cursor]
string

Opaque cursor from meta.pagination.next_cursor or meta.pagination.prev_cursor of a previous response. Omit it to start from the first page.

page[limit]
integer

Number of Mists per page. Defaults to 25.

Required range: 1 <= x <= 100
sort
enum<string>

Sort order by creation time. -created_at (the default) returns the newest first; created_at returns the oldest first.

Available options:
created_at,
-created_at

Response

List of mists

mists
object[]
meta
object