purge_development_applications #

{
  "name": "purge_development_applications",
  "resource": "account",
  "tier": "reversible",
  "grant": "super_admin",
  "summary": "Super-admin: delete your own account's applications you list, on the development estate alone, with no pending action and no browser approval. The call returns 202 at once with each id's state: `walking`, its deletion walk started in list order, or `not_held`, an id your account does not hold, unknown or another account's alike, left untouched. The walks then run detached, one application after another, and `read_platform_usage` shows each application gone. A failed walk leaves the application's deletion marker and its row listed, recorded under a reference. Where one of your listed applications already carries a deletion marker, the whole call is refused 409 `deletion_in_progress` and nothing starts; finish that deletion through `delete_application` and its approval. Every estate but development refuses the call 409 `development_estate_required` before it reads anything.",
  "annotations": {
    "readOnlyHint": false,
    "destructiveHint": true,
    "openWorldHint": true
  }
}

{
  "name": "purge_development_applications",
  "title": "Purge development applications",
  "tier": "reversible",
  "scenario": "API-L0-12",
  "summary": "Delete your own account's applications you list on the development estate, with no pending action and no browser approval: the bake start's step for the operator's standing applications. Super-admin (platform operator) only; a session calls it at the operator's word. Returns 202 at once with each id's state, `walking` or `not_held`, the second for an id your account does not hold; the walks then run detached, and `read_platform_usage` shows each application gone. A listed application whose deletion is already in flight refuses the whole call `deletion_in_progress`; finish it through `delete_application` and its approval. Production and every other estate refuse the call `development_estate_required`.",
  "owners": [
    "MAPI-27",
    "MAPI-04",
    "MAPI-06"
  ]
}

{
  "request": {
    "type": "object",
    "required": [
      "applications"
    ],
    "properties": {
      "applications": {
        "type": "array",
        "minItems": 1,
        "items": {
          "type": "string",
          "minLength": 1
        },
        "description": "The ids of your own account's applications to delete, from `list_applications`: one or more. An id your account does not hold, unknown or another account's, gets the state `not_held` and is left as it is."
      }
    },
    "additionalProperties": false
  },
  "response": {
    "type": "object",
    "required": [
      "contract_version",
      "applications"
    ],
    "properties": {
      "contract_version": {
        "const": 1
      },
      "applications": {
        "type": "array",
        "description": "One entry per distinct id you list, in the order you list them.",
        "items": {
          "type": "object",
          "required": [
            "application",
            "state"
          ],
          "properties": {
            "application": {
              "type": "string"
            },
            "state": {
              "enum": [
                "walking",
                "not_held"
              ],
              "description": "`walking`: your account's own application, its deletion walk started in list order; `read_platform_usage` shows it gone once the walk ends. `not_held`: your account holds no application under the id, unknown or another account's alike, and nothing was touched."
            }
          },
          "additionalProperties": false
        }
      }
    },
    "additionalProperties": false,
    "description": "Returns 202 at once; the walks run after the answer, one application after another."
  }
}