set_status_setting

{
  "name": "set_status_setting",
  "resource": "account",
  "tier": "reversible",
  "grant": "super_admin",
  "summary": "Super-admin: set one served value of the status record — `probe_hostname`, `probe_path`, `samples_to_open`, `samples_to_close`, `probe_timeout_ms`, `stale_minutes`, `certificate_floor_days`, `error_counter_per_day`, `schedule_platform_outcomes_per_hour`, `mark_redeploy_concurrency`, `console_live_tail`, `unlimited_allowance_daily_signal_units`, `deploy_code_seconds`, or `token_code_seconds` — read by the prober on its next minute, the four conditions' settings by the watched conditions' pass on its next run, the concurrency by the mark-redeploy pass at each of its runs, the live read's switch by read_logs, the deploy code's lifetime by each line-form deploy call as it mints its code, and the token code's lifetime by each mint_token call naming code_challenge as it mints its code; a value outside its bound or of the wrong type is refused `invalid_request`, an unknown name `status_setting_unknown`, and a repeated call with the same value writes the same row and answers it.",
  "annotations": {
    "readOnlyHint": false,
    "destructiveHint": true,
    "openWorldHint": false
  }
}

{
  "name": "set_status_setting",
  "tier": "reversible",
  "scenario": "API-L0-12",
  "summary": "Set one served value of the status record by name. Super-admin (platform operator) only. The serving probe's hostname and path, the samples to open and to close an incident, the probe timeout, and the stale bound are read by the prober on its next minute. The certificate floor, the error counter threshold, the schedule outcomes figure, and the unlimited plan's daily draw threshold are read by the watched conditions at their next run, and the mark-redeploy concurrency by the mark-redeploy pass at each run. The live console read's switch, `console_live_tail`, is read by `read_logs` within about 30 seconds. The deploy code's lifetime, `deploy_code_seconds`, is read at each mint.",
  "owners": []
}

{
  "request": {
    "type": "object",
    "required": [
      "name",
      "value"
    ],
    "properties": {
      "name": {
        "type": "string",
        "enum": [
          "probe_hostname",
          "probe_path",
          "samples_to_open",
          "samples_to_close",
          "probe_timeout_ms",
          "stale_minutes",
          "certificate_floor_days",
          "error_counter_per_day",
          "schedule_platform_outcomes_per_hour",
          "mark_redeploy_concurrency",
          "console_live_tail",
          "unlimited_allowance_daily_signal_units",
          "deploy_code_seconds",
          "token_code_seconds"
        ],
        "description": "one of the fourteen served values. Four are the watched conditions' settings: `certificate_floor_days` 1 to 400 (30 by default), `error_counter_per_day` 1 to 1,000 (1), `schedule_platform_outcomes_per_hour` 1 to 1,000 (3), and `unlimited_allowance_daily_signal_units` 1,000,000 to 1,000,000,000,000 (30,000,000). The last is the allowance units an operator account's application on the unlimited plan draws in the trailing 24 hours at which the draw condition fails. The value `mark_redeploy_concurrency` 0 to 8 (2) is the mark-redeploy pass's: the re-creations one run starts, less the restart rows in flight, 0 pausing the drain. The value `console_live_tail` 0 or 1 (0) is the console read's: at 1 the estate's `read_logs` also reads the replicas directly. The value `deploy_code_seconds` 30 to 300 (300) is the deploy code's lifetime, read as each line-form `deploy` call mints its code. The value `token_code_seconds` 30 to 300 (300) is the token code's lifetime, read as each `mint_token` call naming `code_challenge` mints its code. Any other name refuses status_setting_unknown"
      },
      "value": {
        "type": [
          "string",
          "integer"
        ],
        "description": "the value: `probe_hostname` an empty string or a hostname under the serving suffix; `probe_path` a string beginning with `/`; `samples_to_open` and `samples_to_close` an integer 1 to 60; `probe_timeout_ms` an integer 500 to 20000; `stale_minutes` an integer 2 to 60. The conditions' four: `certificate_floor_days` an integer 1 to 400, `error_counter_per_day` and `schedule_platform_outcomes_per_hour` an integer 1 to 1000, and `unlimited_allowance_daily_signal_units` an integer 1000000 to 1000000000000. The others: `mark_redeploy_concurrency` an integer 0 to 8, `console_live_tail` an integer 0 or 1, and `deploy_code_seconds` and `token_code_seconds` each an integer 30 to 300. A value outside its bound or of the wrong type refuses invalid_request with the bound in the detail."
      }
    }
  },
  "response": {
    "type": "object",
    "required": [
      "contract_version",
      "setting",
      "detail"
    ],
    "properties": {
      "contract_version": {
        "const": 1
      },
      "setting": {
        "type": "object",
        "required": [
          "name",
          "value",
          "set_at",
          "set_by"
        ],
        "properties": {
          "name": {
            "type": "string"
          },
          "value": {
            "type": [
              "string",
              "integer"
            ],
            "description": "the written form the record serves"
          },
          "set_at": {
            "type": "string",
            "description": "the write's instant, ISO 8601 in UTC"
          },
          "set_by": {
            "type": "string",
            "description": "the operator's account id"
          }
        },
        "description": "the row as written; a repeated call with the same value writes the same row and answers it"
      },
      "detail": {
        "type": "string",
        "description": "which reader reads the row and when, and what an absent row reads as"
      }
    },
    "additionalProperties": false
  }
}