list_applications

Generated automatically from the published contract sources.

Build metadata: Registered in this build. Registration describes the default dispatcher in this build. It does not guarantee that a caller has the required credential or grant, that a tool is listed for that connection, or that the required service is configured.

A script calls this action over HTTPS at POST https://turnzero.ai/api/v1/actions/list_applications, with a bearer credential and the action's payload as the JSON body. It also accepts GET.

Contract description

List the account's applications: each with its id, its production version and state (`deployed`, `failed` after a failed first production deploy or promote, or `never_deployed`), and `environments`. The `environments` member holds one object per environment. Each carries its name, its state (`deploying`, `deployed`, `failed`, `never_deployed`, `halted`, or `deleting`, the words `read_status` answers), its serving version, its hostname, and its compute grain (`container`, its own container app, or `pod`, a pod on the hosting cell's cluster). The id is what every other tool takes as `application`.

Access and action metadata

{
  "name": "list_applications",
  "resource": "application",
  "tier": "observe",
  "clients": [
    "bearer",
    "browser_session"
  ],
  "summary": "The account's applications with environments, each environment's state (`deploying`, `deployed`, `failed`, `never_deployed`, `halted`, or `deleting`, the words `read_status` answers), serving version, hostname, and compute grain (`container` or `pod`).",
  "annotations": {
    "readOnlyHint": true,
    "destructiveHint": false,
    "openWorldHint": false,
    "idempotentHint": true
  }
}

MCP catalog entry

{
  "name": "list_applications",
  "tier": "observe",
  "scenario": "CHI-L0-09",
  "summary": "List the account's applications: each with its id, its production version and state (`deployed`, `failed` after a failed first production deploy or promote, or `never_deployed`), and `environments`. The `environments` member holds one object per environment. Each carries its name, its state (`deploying`, `deployed`, `failed`, `never_deployed`, `halted`, or `deleting`, the words `read_status` answers), its serving version, its hostname, and its compute grain (`container`, its own container app, or `pod`, a pod on the hosting cell's cluster). The id is what every other tool takes as `application`.",
  "owners": [
    "PLD-L0-62",
    "PLD-L0-40"
  ]
}

request

JSON pointer	Description and constraints
"" (root)	Type: object

response

JSON pointer	Description and constraints
"" (root)	Type: object Required fields: ["contract_version","applications"]
/properties/contract_version	Required value: 1
/properties/reference	The short reference the platform recorded this call under, ten lowercase hexadecimal characters, the value the call’s record row carries; quote it when reporting the call. Type: string Pattern: ^[0-9a-f]{10}$
/properties/applications	Type: array
/properties/applications/items	Type: object Required fields: ["id","name","label","created_at","plan","environments","state","version"]
/properties/applications/items/properties/id	Type: string
/properties/applications/items/properties/name	Type: string
/properties/applications/items/properties/label	Type: string
/properties/applications/items/properties/created_at	Type: string
/properties/applications/items/properties/plan	The application's plan: `free`, `standard`, or `pro`, or `unlimited`, the company's own plan, which no customer act selects yet. Type: string Allowed values: ["free","standard","pro","unlimited"]
/properties/applications/items/properties/environments	One object per environment, `development` then `production` (PLD-L0-40): the environment's name, its deploy state, its serving version, its hostname, and its compute grain. Type: array
/properties/applications/items/properties/environments/items	Type: object Required fields: ["name","state","version","hostname"]
/properties/applications/items/properties/environments/items/properties/name	Type: string Allowed values: ["development","production"]
/properties/applications/items/properties/environments/items/properties/state	The first of these that holds: `deleting` while a deletion of the application or of the environment is in flight (PLD-L0-66), `halted` where the environment's developer or the platform halted it (PLD-L0-41). Then `deploying` while a deploy, promote, or restart of the environment is in flight, `deployed` where a serving version stands, and `failed` where none serves and the environment's latest version row not retired by a deletion failed. It is `never_deployed` otherwise. These are the words `read_status` answers as the environment's `state`, read through one function (PLD-L0-40); the compute provider's own word is `read_status`'s `compute_state` (PLD-L0-63). Type: string Allowed values: ["deploying","deployed","failed","never_deployed","halted","deleting"]
/properties/applications/items/properties/environments/items/properties/version	The environment's serving version, or null. Type: ["integer","null"]
/properties/applications/items/properties/environments/items/properties/hostname	The environment's hostname as `read_status` answers it: the label under the serving suffix for production, the label with `-dev` appended for development (SVC-L0-07). Type: string
/properties/applications/items/properties/environments/items/properties/grain	The compute unit the environment runs as (PLD-L0-62): `container`, its own container app, or `pod`, one pod on the hosting cell's cluster in the cell's development group. Every production environment is `container`; a development environment is `pod` where its cell registers an admitting development group with headroom at its deploy, and `container` otherwise. Type: string Allowed values: ["container","pod"]
/properties/applications/items/properties/state	The application's own state: `failed` where production's environment reads `failed`, a first production deploy or promote having failed with nothing serving; otherwise `deployed` once production's compute stands and `never_deployed` before (WEB-L0-17). Type: string Pattern: ^(deployed\|failed\|never_deployed)$
/properties/applications/items/properties/version	Type: ["integer","null"]
/properties/detail	Type: string

Complete payload contract

{
  "request": {
    "type": "object",
    "properties": {}
  },
  "response": {
    "type": "object",
    "required": [
      "contract_version",
      "applications"
    ],
    "properties": {
      "contract_version": {
        "const": 1
      },
      "reference": {
        "type": "string",
        "pattern": "^[0-9a-f]{10}$",
        "description": "The short reference the platform recorded this call under, ten lowercase hexadecimal characters, the value the call’s record row carries; quote it when reporting the call."
      },
      "applications": {
        "type": "array",
        "items": {
          "type": "object",
          "required": [
            "id",
            "name",
            "label",
            "created_at",
            "plan",
            "environments",
            "state",
            "version"
          ],
          "properties": {
            "id": {
              "type": "string"
            },
            "name": {
              "type": "string"
            },
            "label": {
              "type": "string"
            },
            "created_at": {
              "type": "string"
            },
            "plan": {
              "type": "string",
              "enum": [
                "free",
                "standard",
                "pro",
                "unlimited"
              ],
              "description": "The application's plan: `free`, `standard`, or `pro`, or `unlimited`, the company's own plan, which no customer act selects yet."
            },
            "environments": {
              "type": "array",
              "description": "One object per environment, `development` then `production` (PLD-L0-40): the environment's name, its deploy state, its serving version, its hostname, and its compute grain.",
              "items": {
                "type": "object",
                "required": [
                  "name",
                  "state",
                  "version",
                  "hostname"
                ],
                "properties": {
                  "name": {
                    "type": "string",
                    "enum": [
                      "development",
                      "production"
                    ]
                  },
                  "state": {
                    "type": "string",
                    "enum": [
                      "deploying",
                      "deployed",
                      "failed",
                      "never_deployed",
                      "halted",
                      "deleting"
                    ],
                    "description": "The first of these that holds: `deleting` while a deletion of the application or of the environment is in flight (PLD-L0-66), `halted` where the environment's developer or the platform halted it (PLD-L0-41). Then `deploying` while a deploy, promote, or restart of the environment is in flight, `deployed` where a serving version stands, and `failed` where none serves and the environment's latest version row not retired by a deletion failed. It is `never_deployed` otherwise. These are the words `read_status` answers as the environment's `state`, read through one function (PLD-L0-40); the compute provider's own word is `read_status`'s `compute_state` (PLD-L0-63)."
                  },
                  "version": {
                    "type": [
                      "integer",
                      "null"
                    ],
                    "description": "The environment's serving version, or null."
                  },
                  "hostname": {
                    "type": "string",
                    "description": "The environment's hostname as `read_status` answers it: the label under the serving suffix for production, the label with `-dev` appended for development (SVC-L0-07)."
                  },
                  "grain": {
                    "type": "string",
                    "enum": [
                      "container",
                      "pod"
                    ],
                    "description": "The compute unit the environment runs as (PLD-L0-62): `container`, its own container app, or `pod`, one pod on the hosting cell's cluster in the cell's development group. Every production environment is `container`; a development environment is `pod` where its cell registers an admitting development group with headroom at its deploy, and `container` otherwise."
                  }
                }
              }
            },
            "state": {
              "type": "string",
              "pattern": "^(deployed|failed|never_deployed)$",
              "description": "The application's own state: `failed` where production's environment reads `failed`, a first production deploy or promote having failed with nothing serving; otherwise `deployed` once production's compute stands and `never_deployed` before (WEB-L0-17)."
            },
            "version": {
              "type": [
                "integer",
                "null"
              ]
            }
          }
        }
      },
      "detail": {
        "type": "string"
      }
    }
  }
}

Shared contracts

Refusals: every refusal, by surface, with its cause and its remedy
schemas/wire_error.schema.json
schemas/wire_errors.json
schemas/action_payloads.json (includes shared shapes)
management_api_contract.md