{
  "openapi": "3.1.0",
  "info": {
    "title": "Spinbox API",
    "description": "The control plane's API, spin.v1, generated from its protobuf schema. Every procedure is a Connect unary call: POST a JSON body to /\u003cservice\u003e/\u003cmethod\u003e with `Content-Type: application/json` and `Authorization: Bearer \u003cAPI key\u003e`.",
    "version": "v1"
  },
  "paths": {
    "/spin.v1.AdminService/AcceptThirdPartyTerms": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "AcceptThirdPartyTerms",
        "description": "Accept the terms, as the version shown, for the items named: this installation then\n downloads them - the releases this control plane pins at once, and the newest daily.",
        "operationId": "spin.v1.AdminService.AcceptThirdPartyTerms",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.AcceptThirdPartyTermsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.AcceptThirdPartyTermsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/AddAllowedEmail": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "AddAllowedEmail",
        "description": "Add allowed email/domain",
        "operationId": "spin.v1.AdminService.AddAllowedEmail",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.AddAllowedEmailRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.AddAllowedEmailResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/ClearUserPasskeys": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "ClearUserPasskeys",
        "description": "Clear a person's passkeys, for one who lost them all: their session registers a first again.\n Their keys and workspaces stay as they are.",
        "operationId": "spin.v1.AdminService.ClearUserPasskeys",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ClearUserPasskeysRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ClearUserPasskeysResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/CreateHostClass": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "CreateHostClass",
        "operationId": "spin.v1.AdminService.CreateHostClass",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.CreateHostClassRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.CreateHostClassResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/CreateNetworkPolicy": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "CreateNetworkPolicy",
        "operationId": "spin.v1.AdminService.CreateNetworkPolicy",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.CreateNetworkPolicyRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.CreateNetworkPolicyResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/CreateResourcePreset": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "CreateResourcePreset",
        "description": "Create a resource preset",
        "operationId": "spin.v1.AdminService.CreateResourcePreset",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.CreateResourcePresetRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.CreateResourcePresetResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/DecideConfigChange": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "DecideConfigChange",
        "description": "Apply a change the file proposes, or dismiss it. Either is remembered until the file says\n something else again. Audited with the admin who decided.",
        "operationId": "spin.v1.AdminService.DecideConfigChange",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.DecideConfigChangeRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.DecideConfigChangeResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/DeleteHostClass": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "DeleteHostClass",
        "operationId": "spin.v1.AdminService.DeleteHostClass",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.DeleteHostClassRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.DeleteHostClassResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/DeleteNetworkPolicy": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "DeleteNetworkPolicy",
        "description": "Refused while a workspace runs under the policy or it is the installation's default.",
        "operationId": "spin.v1.AdminService.DeleteNetworkPolicy",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.DeleteNetworkPolicyRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.DeleteNetworkPolicyResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/DeleteResourcePreset": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "DeleteResourcePreset",
        "description": "Delete a resource preset",
        "operationId": "spin.v1.AdminService.DeleteResourcePreset",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.DeleteResourcePresetRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.DeleteResourcePresetResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/ExplainStorageKey": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "ExplainStorageKey",
        "description": "What one key in the store is, and whose: a key read off the bucket's console says nothing\n a person can act on.",
        "operationId": "spin.v1.AdminService.ExplainStorageKey",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ExplainStorageKeyRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ExplainStorageKeyResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/GetBill": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "GetBill",
        "description": "What the installation cost in a month, as its cloud's bill says: by day and service, what the\n month is forecast to end at, and its budget. As the control plane last read the bill - a few\n times a day (internal/controlplane/domain/bill) - never the cloud itself, where every question\n to its billing is billed.",
        "operationId": "spin.v1.AdminService.GetBill",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GetBillRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GetBillResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/GetCosts": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "GetCosts",
        "description": "A month of the bill shared out to the workspaces that caused it: the runners' by what each\n workspace held of them, the volumes' bucket by what its volumes kept. What nobody caused is\n said apart and never spread: the runners' capacity nobody held, the bucket's bytes no\n workspace keeps, and the platform's own cost by role and service; and, from those, what the\n installation costs a day with nobody working (internal/controlplane/domain/finops).",
        "operationId": "spin.v1.AdminService.GetCosts",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GetCostsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GetCostsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/GetEmailSettings": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "GetEmailSettings",
        "description": "The SMTP server the installation tells people through. The password is never read back.",
        "operationId": "spin.v1.AdminService.GetEmailSettings",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GetEmailSettingsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GetEmailSettingsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/GetFleetVersions": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "GetFleetVersions",
        "description": "What is running where: this control plane, each host's runner and machine, and the\n extension releases workspaces are on. An installation is updated in halves, and this is\n the one page that says which halves it is in.",
        "operationId": "spin.v1.AdminService.GetFleetVersions",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GetFleetVersionsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GetFleetVersionsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/GetInstallationHealth": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "GetInstallationHealth",
        "description": "Whether anything is wrong with the installation, in one answer: each part from what the\n control plane already knows of it - its database, the database's archive, the log store,\n the collector, its jobs, its hosts and the workspaces waiting for one.",
        "operationId": "spin.v1.AdminService.GetInstallationHealth",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GetInstallationHealthRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GetInstallationHealthResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/GetMonitoring": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "GetMonitoring",
        "description": "The Grafana the control plane serves over the installation's metrics, and the release's\n dashboards in it.",
        "operationId": "spin.v1.AdminService.GetMonitoring",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GetMonitoringRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GetMonitoringResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/GetPlatformImages": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "GetPlatformImages",
        "description": "Whether the base image and the supervisor this control plane's image carries are\n published.",
        "operationId": "spin.v1.AdminService.GetPlatformImages",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GetPlatformImagesRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GetPlatformImagesResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/GetRunbook": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "GetRunbook",
        "description": "One runbook, its markdown and where its file is at the pinned commit. NOT_FOUND for an id\n this release's runbooks do not have.",
        "operationId": "spin.v1.AdminService.GetRunbook",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GetRunbookRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GetRunbookResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/GetSettings": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "GetSettings",
        "description": "Every setting of the installation as it is in force, and what each is: its type, its\n default, its bounds, what it reaches when saved and who writes it\n (internal/controlplane/settings, the one registry the file, the dashboard and the CLI are\n made from).",
        "operationId": "spin.v1.AdminService.GetSettings",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GetSettingsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GetSettingsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/GetStorageSettings": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "GetStorageSettings",
        "description": "Where the installation's object store is. The secret is never read back.",
        "operationId": "spin.v1.AdminService.GetStorageSettings",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GetStorageSettingsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GetStorageSettingsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/GetStorageUsage": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "GetStorageUsage",
        "description": "What the store holds, by what each object is for: every volume's objects and the layers its\n commits name, with the workspace, image or extension release it is. As the storage-gc job\n last read it - daily, or when an admin runs it - never the bucket itself.",
        "operationId": "spin.v1.AdminService.GetStorageUsage",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GetStorageUsageRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GetStorageUsageResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/GetTelemetryStatus": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "GetTelemetryStatus",
        "description": "What the collector has sent and failed to send over its last minute, as the watch on its\n machine read it from the collector itself.",
        "operationId": "spin.v1.AdminService.GetTelemetryStatus",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GetTelemetryStatusRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GetTelemetryStatusResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/GetThirdPartyTerms": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "GetThirdPartyTerms",
        "description": "The software this installation downloads from its makers, the terms it is used under, and\n which of it an administrator accepted the terms for: who, when, and which text. Nothing is\n downloaded of an item whose terms are not accepted (internal/controlplane/thirdparty).",
        "operationId": "spin.v1.AdminService.GetThirdPartyTerms",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GetThirdPartyTermsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GetThirdPartyTermsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/GetUserWorkspaceEgress": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "GetUserWorkspaceEgress",
        "description": "Where a workspace sends, as its owner's GetWorkspaceEgress answers it: the host's counters by\n destination, nothing of what was carried. Audited, as a reading of somebody else's.",
        "operationId": "spin.v1.AdminService.GetUserWorkspaceEgress",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GetUserWorkspaceEgressRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GetUserWorkspaceEgressResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/GetVSCodeServers": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "GetVSCodeServers",
        "description": "The VS Code servers workspaces are given (the vscode-server extension): each release, and\n the publish this control plane ran since it started, if it ran one.",
        "operationId": "spin.v1.AdminService.GetVSCodeServers",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GetVSCodeServersRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GetVSCodeServersResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/GetWorkspaceNames": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "GetWorkspaceNames",
        "description": "The names of the workspaces ids are, whoever owns them and whatever state they are in, a\n deleted one among them: a record of the platform's logs names a workspace by its id, and\n ListWorkspaces is the caller's own. An id the installation no longer holds a row for is\n left out of the answer.",
        "operationId": "spin.v1.AdminService.GetWorkspaceNames",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GetWorkspaceNamesRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GetWorkspaceNamesResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/ListAlerts": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "ListAlerts",
        "description": "What the release's alert rules said in the installation's Grafana, newest first: each\n firing and each resolution the control plane heard, with its runbook and how many\n administrators it reached.",
        "operationId": "spin.v1.AdminService.ListAlerts",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListAlertsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListAlertsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/ListAllowedEmails": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "ListAllowedEmails",
        "description": "List allowed emails/domains",
        "operationId": "spin.v1.AdminService.ListAllowedEmails",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListAllowedEmailsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListAllowedEmailsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/ListAuditLog": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "ListAuditLog",
        "description": "Read the audit log, newest first. There is no RPC that writes one: an entry is written\n by the operation it records, so a log an API could add to would be one an API could\n forge.",
        "operationId": "spin.v1.AdminService.ListAuditLog",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListAuditLogRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListAuditLogResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/ListConfigChanges": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "ListConfigChanges",
        "description": "What the config file says now and the installation does not, for an administrator to\n decide: the file seeds an installation once, and after that its changes are proposals.",
        "operationId": "spin.v1.AdminService.ListConfigChanges",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListConfigChangesRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListConfigChangesResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/ListHostClasses": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "ListHostClasses",
        "operationId": "spin.v1.AdminService.ListHostClasses",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListHostClassesRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListHostClassesResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/ListHostProblems": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "ListHostProblems",
        "description": "What is wrong with the fleet's hosts, one problem per host that is not connected or fails a\n check of its own: the same problems GetInstallationHealth's HOSTS part lists, for the pages\n that read one host or the fleet and nothing else of the installation.",
        "operationId": "spin.v1.AdminService.ListHostProblems",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListHostProblemsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListHostProblemsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/ListJobRuns": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "ListJobRuns",
        "description": "One job's runs, newest first.",
        "operationId": "spin.v1.AdminService.ListJobRuns",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListJobRunsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListJobRunsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/ListJobs": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "ListJobs",
        "description": "The control plane's periodic work - backups, cleanups, the object store's garbage\n collection - with how often each runs and how its last run went.",
        "operationId": "spin.v1.AdminService.ListJobs",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListJobsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListJobsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/ListRefusedVolumes": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "ListRefusedVolumes",
        "description": "The disks a host refuses to serve, each with the workspace it is the disk of and whose that\n is. Audited.",
        "operationId": "spin.v1.AdminService.ListRefusedVolumes",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListRefusedVolumesRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListRefusedVolumesResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/ListRekeys": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "ListRekeys",
        "description": "The disks being re-keyed, and the ones a revoked host's keys marked for it.",
        "operationId": "spin.v1.AdminService.ListRekeys",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListRekeysRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListRekeysResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/ListResourcePresets": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "ListResourcePresets",
        "description": "List resource presets",
        "operationId": "spin.v1.AdminService.ListResourcePresets",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListResourcePresetsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListResourcePresetsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/ListRunbooks": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "ListRunbooks",
        "description": "What an operator does when an alert fires, a job fails or an owner is told something went\n wrong: spin-stack/runbooks at the commit this release pins, served so it is read in the app.",
        "operationId": "spin.v1.AdminService.ListRunbooks",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListRunbooksRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListRunbooksResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/ListTimeline": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "ListTimeline",
        "description": "What happened, newest first, between two instants, to one workspace, host, team or project, or\n to the whole installation: read from the audit log, the workspaces' events, the jobs' failed\n runs and the projects' prebuilds as they are, never copied. Sign-ins and what is done inside a\n workspace (a session, a command) are the audit log's alone: they outnumber everything else.",
        "operationId": "spin.v1.AdminService.ListTimeline",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListTimelineRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListTimelineResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/ListUserAPIKeys": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "ListUserAPIKeys",
        "description": "List another user's API keys. The secret is never stored, so this is what an admin can\n know about a key: what it is called, when it was made, when it was last used.",
        "operationId": "spin.v1.AdminService.ListUserAPIKeys",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListUserAPIKeysRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListUserAPIKeysResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/ListUsers": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "ListUsers",
        "description": "List all users",
        "operationId": "spin.v1.AdminService.ListUsers",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListUsersRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListUsersResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/PublishVSCodeServers": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "PublishVSCodeServers",
        "description": "Publish the servers of the newest stable VS Code releases, or of the commits named, as a\n new release. Answers once the publish has begun - it downloads a gigabyte - and\n GetVSCodeServers says how it goes.",
        "operationId": "spin.v1.AdminService.PublishVSCodeServers",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.PublishVSCodeServersRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.PublishVSCodeServersResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/RecoverUserWorkspace": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "RecoverUserWorkspace",
        "description": "Move a workspace off a host that is gone, as its owner's RecoverWorkspace does, and with the\n same question first: without accept_data_loss it answers what the move would give up and\n changes nothing. The work given up is its owner's, so a reason is required, kept on the audit\n entry, and written with who asked on the workspace's history, which its owner reads\n (WORKSPACE_EVENT_TYPE_RECOVERED_BY_ADMIN). Refused for a workspace held in quarantine.",
        "operationId": "spin.v1.AdminService.RecoverUserWorkspace",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.RecoverUserWorkspaceRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.RecoverUserWorkspaceResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/RekeyVolume": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "RekeyVolume",
        "description": "Re-key a workspace's disk: copy it whole under a key of its own, point the workspace at the\n copy, and delete the disk - which shreds the key assumed taken and every snapshot of the disk,\n since those are what that key opens. The workspace must be stopped or quarantined. Refused for\n a disk something descends from. Audited.",
        "operationId": "spin.v1.AdminService.RekeyVolume",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.RekeyVolumeRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.RekeyVolumeResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/RemoveAllowedEmail": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "RemoveAllowedEmail",
        "description": "Remove allowed email/domain",
        "operationId": "spin.v1.AdminService.RemoveAllowedEmail",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.RemoveAllowedEmailRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.RemoveAllowedEmailResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/RemoveStoredVolume": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "RemoveStoredVolume",
        "description": "Remove an image, an extension release, an unclaimed volume or an orphan from the store: its\n row, then its volume, whose key is shredded; storage-gc collects its layers on its next run.\n Refused for one that is kept (StoredVolume.kept_because), one placed on a host, and a\n workspace's disk. Audited.",
        "operationId": "spin.v1.AdminService.RemoveStoredVolume",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.RemoveStoredVolumeRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.RemoveStoredVolumeResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/RetryPlatformImages": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "RetryPlatformImages",
        "description": "Look again now rather than when the next retry is due.",
        "operationId": "spin.v1.AdminService.RetryPlatformImages",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.RetryPlatformImagesRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.RetryPlatformImagesResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/RevokeThirdPartyTerms": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "RevokeThirdPartyTerms",
        "description": "Take the acceptance back for the items named: nothing more of them is downloaded. What was\n downloaded already stays until an administrator removes it.",
        "operationId": "spin.v1.AdminService.RevokeThirdPartyTerms",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.RevokeThirdPartyTermsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.RevokeThirdPartyTermsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/RevokeUserAPIKey": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "RevokeUserAPIKey",
        "description": "Revoke another user's API key - the offboarding an admin cannot do by asking the user,\n who may already be gone. It is audited with the admin who did it.",
        "operationId": "spin.v1.AdminService.RevokeUserAPIKey",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.RevokeUserAPIKeyRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.RevokeUserAPIKeyResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/RunJobNow": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "RunJobNow",
        "description": "Run a job now rather than when it is next due. Refused while it is running: a second run\n alongside the first would do the same work twice. Audited with the admin who asked.",
        "operationId": "spin.v1.AdminService.RunJobNow",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.RunJobNowRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.RunJobNowResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/SendTestAlert": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "SendTestAlert",
        "description": "Has Grafana test its contact point, which sends a test alert the whole way an alert goes:\n Grafana, the control plane, an email to every administrator who has not opted out.\n FAILED_PRECONDITION where this control plane serves no Grafana, or Grafana could not\n reach the control plane.",
        "operationId": "spin.v1.AdminService.SendTestAlert",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.SendTestAlertRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.SendTestAlertResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/SetSettings": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "SetSettings",
        "description": "Writes the settings named, each checked by its definition and all of them together before\n any is written: a refused one writes nothing.",
        "operationId": "spin.v1.AdminService.SetSettings",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.SetSettingsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.SetSettingsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/StopUserWorkspace": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "StopUserWorkspace",
        "description": "Stop a workspace, as its owner's StopWorkspace does: one whose stop could not publish its\n disk runs on and holds its host until somebody stops it. Audited.",
        "operationId": "spin.v1.AdminService.StopUserWorkspace",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.StopUserWorkspaceRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.StopUserWorkspaceResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/UntagImage": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "UntagImage",
        "description": "Take a ref off what it names: no new workspace gets those bytes by it, the disks cloned from\n them go on reading them, and a later publish under the ref tags the new bytes. Audited.",
        "operationId": "spin.v1.AdminService.UntagImage",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.UntagImageRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.UntagImageResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/UpdateEmailSettings": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "UpdateEmailSettings",
        "description": "Set the SMTP server, checked against it - connected to and signed in to - before it is\n written. An empty host turns email off.",
        "operationId": "spin.v1.AdminService.UpdateEmailSettings",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.UpdateEmailSettingsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.UpdateEmailSettingsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/UpdateHostClass": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "UpdateHostClass",
        "operationId": "spin.v1.AdminService.UpdateHostClass",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.UpdateHostClassRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.UpdateHostClassResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/UpdateNetworkPolicy": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "UpdateNetworkPolicy",
        "operationId": "spin.v1.AdminService.UpdateNetworkPolicy",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.UpdateNetworkPolicyRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.UpdateNetworkPolicyResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/UpdateResourcePreset": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "UpdateResourcePreset",
        "description": "Update a resource preset",
        "operationId": "spin.v1.AdminService.UpdateResourcePreset",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.UpdateResourcePresetRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.UpdateResourcePresetResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/UpdateStorageSettings": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "UpdateStorageSettings",
        "description": "Set where the object store is, checked against it before it is written; every control\n plane restarts within seconds to open it. Another store while volumes exist is refused.",
        "operationId": "spin.v1.AdminService.UpdateStorageSettings",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.UpdateStorageSettingsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.UpdateStorageSettingsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AdminService/UpdateUser": {
      "post": {
        "tags": [
          "AdminService"
        ],
        "summary": "UpdateUser",
        "description": "Update user (can toggle is_instance_admin, disable user)",
        "operationId": "spin.v1.AdminService.UpdateUser",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.UpdateUserRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.UpdateUserResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AuthService/ApproveWorkspaceSignIn": {
      "post": {
        "tags": [
          "AuthService"
        ],
        "summary": "ApproveWorkspaceSignIn",
        "operationId": "spin.v1.AuthService.ApproveWorkspaceSignIn",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ApproveWorkspaceSignInRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ApproveWorkspaceSignInResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AuthService/BeginWorkspaceSignIn": {
      "post": {
        "tags": [
          "AuthService"
        ],
        "summary": "BeginWorkspaceSignIn",
        "description": "A sign-in on a workspace's host, done by the dashboard. The proxy begins it and sends the\n browser to the dashboard, which approves it for whoever is signed in there and sends the\n browser back with a one-time code; the proxy completes it with that code and the binding\n it gave the same browser. The identity provider is only ever told the dashboard's callback.",
        "operationId": "spin.v1.AuthService.BeginWorkspaceSignIn",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.BeginWorkspaceSignInRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.BeginWorkspaceSignInResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AuthService/CheckDeviceLogin": {
      "post": {
        "tags": [
          "AuthService"
        ],
        "summary": "CheckDeviceLogin",
        "description": "Check device login status (CLI polls this)\n Returns session token once user has completed login and entered the code",
        "operationId": "spin.v1.AuthService.CheckDeviceLogin",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.CheckDeviceLoginRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.CheckDeviceLoginResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AuthService/CompleteLogin": {
      "post": {
        "tags": [
          "AuthService"
        ],
        "summary": "CompleteLogin",
        "description": "Complete login (callback from IdP)",
        "operationId": "spin.v1.AuthService.CompleteLogin",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.CompleteLoginRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.CompleteLoginResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AuthService/CompleteWorkspaceSignIn": {
      "post": {
        "tags": [
          "AuthService"
        ],
        "summary": "CompleteWorkspaceSignIn",
        "operationId": "spin.v1.AuthService.CompleteWorkspaceSignIn",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.CompleteWorkspaceSignInRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.CompleteWorkspaceSignInResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AuthService/ConfirmDeviceLogin": {
      "post": {
        "tags": [
          "AuthService"
        ],
        "summary": "ConfirmDeviceLogin",
        "description": "Complete device login (dashboard calls this after user enters code)\n Requires authentication - links the device code to the current user",
        "operationId": "spin.v1.AuthService.ConfirmDeviceLogin",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ConfirmDeviceLoginRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ConfirmDeviceLoginResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AuthService/CreateAPIKey": {
      "post": {
        "tags": [
          "AuthService"
        ],
        "summary": "CreateAPIKey",
        "description": "Create API key",
        "operationId": "spin.v1.AuthService.CreateAPIKey",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.CreateAPIKeyRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.CreateAPIKeyResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AuthService/ExchangeWorkloadToken": {
      "post": {
        "tags": [
          "AuthService"
        ],
        "summary": "ExchangeWorkloadToken",
        "description": "Exchanges a workload's JWT-SVID, for the control plane's audience (identity.ControlPlaneAudience),\n for a key delegated from the key that made its workspace: what an agent in a workspace drives\n others with. Verified by go-spiffe against the trust domain's bundle; the key holds no more than\n its parent (delegation.Within), lasts no longer than the token's workload needs, and goes with the\n workspace.",
        "operationId": "spin.v1.AuthService.ExchangeWorkloadToken",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ExchangeWorkloadTokenRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ExchangeWorkloadTokenResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AuthService/GetCurrentUser": {
      "post": {
        "tags": [
          "AuthService"
        ],
        "summary": "GetCurrentUser",
        "description": "Get current user info",
        "operationId": "spin.v1.AuthService.GetCurrentUser",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GetCurrentUserRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GetCurrentUserResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AuthService/ListAPIKeys": {
      "post": {
        "tags": [
          "AuthService"
        ],
        "summary": "ListAPIKeys",
        "description": "List API keys",
        "operationId": "spin.v1.AuthService.ListAPIKeys",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListAPIKeysRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListAPIKeysResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AuthService/ListIdentityProviders": {
      "post": {
        "tags": [
          "AuthService"
        ],
        "summary": "ListIdentityProviders",
        "description": "List available identity providers (for login page)\n Always includes built-in GitHub provider; additional OIDC providers from database",
        "operationId": "spin.v1.AuthService.ListIdentityProviders",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListIdentityProvidersRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListIdentityProvidersResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AuthService/Logout": {
      "post": {
        "tags": [
          "AuthService"
        ],
        "summary": "Logout",
        "description": "Logout (invalidate session)",
        "operationId": "spin.v1.AuthService.Logout",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.LogoutRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.LogoutResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AuthService/RevokeAPIKey": {
      "post": {
        "tags": [
          "AuthService"
        ],
        "summary": "RevokeAPIKey",
        "description": "Revoke API key",
        "operationId": "spin.v1.AuthService.RevokeAPIKey",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.RevokeAPIKeyRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.RevokeAPIKeyResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AuthService/SearchUsers": {
      "post": {
        "tags": [
          "AuthService"
        ],
        "summary": "SearchUsers",
        "description": "Search users by name or email (for team member selection, workspace sharing)",
        "operationId": "spin.v1.AuthService.SearchUsers",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.SearchUsersRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.SearchUsersResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AuthService/StartDeviceLogin": {
      "post": {
        "tags": [
          "AuthService"
        ],
        "summary": "StartDeviceLogin",
        "description": "Start device login flow (for CLI when OAuth redirect is not available)\n Returns a user code and verification URL. User visits URL and enters code.",
        "operationId": "spin.v1.AuthService.StartDeviceLogin",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.StartDeviceLoginRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.StartDeviceLoginResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.AuthService/StartLogin": {
      "post": {
        "tags": [
          "AuthService"
        ],
        "summary": "StartLogin",
        "description": "Start login flow with a specific identity provider\n Use \"github\" for built-in GitHub auth, or IdP ID for dynamic providers",
        "operationId": "spin.v1.AuthService.StartLogin",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.StartLoginRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.StartLoginResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.ExecService/Exec": {
      "post": {
        "tags": [
          "ExecService"
        ],
        "summary": "Exec",
        "description": "Runs command in the workspace's login shell and answers once it has exited, or once timeout\n has passed: stdin is all of it, given at once, and stdout and stderr are kept up to a bound\n each.",
        "operationId": "spin.v1.ExecService.Exec",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ExecRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ExecResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.ExecService/ReadFile": {
      "post": {
        "tags": [
          "ExecService"
        ],
        "summary": "ReadFile",
        "description": "Reads a file of the workspace's, whole, up to a bound.",
        "operationId": "spin.v1.ExecService.ReadFile",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ReadFileRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ReadFileResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.ExecService/WriteFile": {
      "post": {
        "tags": [
          "ExecService"
        ],
        "summary": "WriteFile",
        "description": "Writes a file of the workspace's, whole, making the directories it is in.",
        "operationId": "spin.v1.ExecService.WriteFile",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.WriteFileRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.WriteFileResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.ForgeService/CompleteAppCreation": {
      "post": {
        "tags": [
          "ForgeService"
        ],
        "summary": "CompleteAppCreation",
        "operationId": "spin.v1.ForgeService.CompleteAppCreation",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.CompleteAppCreationRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.CompleteAppCreationResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.ForgeService/CompleteConnect": {
      "post": {
        "tags": [
          "ForgeService"
        ],
        "summary": "CompleteConnect",
        "operationId": "spin.v1.ForgeService.CompleteConnect",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.CompleteConnectRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.CompleteConnectResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.ForgeService/DeleteForgeApp": {
      "post": {
        "tags": [
          "ForgeService"
        ],
        "summary": "DeleteForgeApp",
        "description": "Takes the app out of use at once. Every connection through it is revoked at the forge, and the\n app is gone when that is done.",
        "operationId": "spin.v1.ForgeService.DeleteForgeApp",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.DeleteForgeAppRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.DeleteForgeAppResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.ForgeService/Disconnect": {
      "post": {
        "tags": [
          "ForgeService"
        ],
        "summary": "Disconnect",
        "description": "Forgets the token and revokes it at the forge.",
        "operationId": "spin.v1.ForgeService.Disconnect",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.DisconnectRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.DisconnectResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.ForgeService/ListConnections": {
      "post": {
        "tags": [
          "ForgeService"
        ],
        "summary": "ListConnections",
        "operationId": "spin.v1.ForgeService.ListConnections",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListConnectionsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListConnectionsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.ForgeService/ListForgeApps": {
      "post": {
        "tags": [
          "ForgeService"
        ],
        "summary": "ListForgeApps",
        "description": "The installation's app on each forge: whether a person can connect, and where. Its secrets are\n never answered with.",
        "operationId": "spin.v1.ForgeService.ListForgeApps",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListForgeAppsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListForgeAppsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.ForgeService/PollDeviceConnect": {
      "post": {
        "tags": [
          "ForgeService"
        ],
        "summary": "PollDeviceConnect",
        "operationId": "spin.v1.ForgeService.PollDeviceConnect",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.PollDeviceConnectRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.PollDeviceConnectResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.ForgeService/SearchRepositories": {
      "post": {
        "tags": [
          "ForgeService"
        ],
        "summary": "SearchRepositories",
        "description": "The repositories the person's account reaches that match query, as the forge searches them\n with the person's token: what they can see there is what they can pick here.",
        "operationId": "spin.v1.ForgeService.SearchRepositories",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.SearchRepositoriesRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.SearchRepositoriesResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.ForgeService/SetForgeApp": {
      "post": {
        "tags": [
          "ForgeService"
        ],
        "summary": "SetForgeApp",
        "description": "Keeping an app that was made elsewhere. Refused while the forge has one: an app is never\n edited, because another client id could not revoke what this one granted.",
        "operationId": "spin.v1.ForgeService.SetForgeApp",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.SetForgeAppRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.SetForgeAppResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.ForgeService/StartAppCreation": {
      "post": {
        "tags": [
          "ForgeService"
        ],
        "summary": "StartAppCreation",
        "description": "Making the app, by an instance admin, through the forge's manifest flow: StartAppCreation\n answers the form the browser posts to the forge, which makes the app and sends the admin back\n with a code; CompleteAppCreation exchanges it for the app's credentials. Nobody copies a key.",
        "operationId": "spin.v1.ForgeService.StartAppCreation",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.StartAppCreationRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.StartAppCreationResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.ForgeService/StartConnect": {
      "post": {
        "tags": [
          "ForgeService"
        ],
        "summary": "StartConnect",
        "description": "Connecting: StartConnect answers where the person authorizes the app and a binding only this\n client keeps; the forge sends the browser back to redirect_uri with a code and the state, and\n CompleteConnect exchanges them, with the binding, for the person's token.",
        "operationId": "spin.v1.ForgeService.StartConnect",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.StartConnectRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.StartConnectResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.ForgeService/StartDeviceConnect": {
      "post": {
        "tags": [
          "ForgeService"
        ],
        "summary": "StartDeviceConnect",
        "description": "Connecting from somewhere with no browser to send back to, the CLI: the control plane asks the\n forge for a device code (RFC 8628) and keeps it, and answers with the code the person types on\n the forge's page and a handle only the caller can poll with. PollDeviceConnect asks the forge,\n at most once an interval, and on the person's approval keeps their token as CompleteConnect\n does: once, for the person who began it.",
        "operationId": "spin.v1.ForgeService.StartDeviceConnect",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.StartDeviceConnectRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.StartDeviceConnectResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.HostService/ActivateHost": {
      "post": {
        "tags": [
          "HostService"
        ],
        "summary": "ActivateHost",
        "description": "Activate a drained host (set to healthy, admin only)",
        "operationId": "spin.v1.HostService.ActivateHost",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ActivateHostRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ActivateHostResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.HostService/DrainHost": {
      "post": {
        "tags": [
          "HostService"
        ],
        "summary": "DrainHost",
        "description": "Set host to draining (admin only)",
        "operationId": "spin.v1.HostService.DrainHost",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.DrainHostRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.DrainHostResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.HostService/GetFleet": {
      "post": {
        "tags": [
          "HostService"
        ],
        "summary": "GetFleet",
        "description": "The fleet as a whole (admin only): how many hosts there are against how many the\n installation has asked its cloud for, and what it is waiting for. A fleet that scales from\n none looks broken without this - no hosts, no explanation, and a workspace that waits\n minutes for a machine to boot with nothing saying so.",
        "operationId": "spin.v1.HostService.GetFleet",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GetFleetRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GetFleetResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.HostService/GetHost": {
      "post": {
        "tags": [
          "HostService"
        ],
        "summary": "GetHost",
        "description": "Get host details (admin only)",
        "operationId": "spin.v1.HostService.GetHost",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GetHostRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GetHostResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.HostService/GetHostPolicy": {
      "post": {
        "tags": [
          "HostService"
        ],
        "summary": "GetHostPolicy",
        "description": "What a host may do, as against what it is (admin only). A host reads what it *is* from\n its own environment, before it can reach this; everything else it is told, on its\n heartbeat, and it reports back the revision it is running under.",
        "operationId": "spin.v1.HostService.GetHostPolicy",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GetHostPolicyRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GetHostPolicyResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.HostService/ListHosts": {
      "post": {
        "tags": [
          "HostService"
        ],
        "summary": "ListHosts",
        "description": "List all hosts (admin only)",
        "operationId": "spin.v1.HostService.ListHosts",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListHostsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListHostsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.HostService/RemoveHost": {
      "post": {
        "tags": [
          "HostService"
        ],
        "summary": "RemoveHost",
        "description": "Takes a machine of an autoscaling group out of the fleet (admin only), as Host.removal says:\n given back to its group (GIVE_BACK), or forgotten (FORGET). A host whose removal is REVOKE is\n refused: RevokeRunner is its removal. Asked with taken, the host leaves as one believed\n compromised: its credentials revoked and every team's disk whose key it was given marked for\n re-keying (ListRekeys), as RevokeRunner does, and its machine given back all the same.",
        "operationId": "spin.v1.HostService.RemoveHost",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.RemoveHostRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.RemoveHostResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.HostService/SetHostPolicy": {
      "post": {
        "tags": [
          "HostService"
        ],
        "summary": "SetHostPolicy",
        "operationId": "spin.v1.HostService.SetHostPolicy",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.SetHostPolicyRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.SetHostPolicyResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.HostService/TestHostWriteback": {
      "post": {
        "tags": [
          "HostService"
        ],
        "summary": "TestHostWriteback",
        "description": "Measures a host's disk under writeback thresholds no preset names, against the ones it holds\n (admin only). SetHostPolicy refuses such thresholds for a host until it has been tested with\n them; the test loads that host's disk for about forty seconds.",
        "operationId": "spin.v1.HostService.TestHostWriteback",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.TestHostWritebackRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.TestHostWritebackResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.HostShellService/ApproveHostShell": {
      "post": {
        "tags": [
          "HostShellService"
        ],
        "summary": "ApproveHostShell",
        "description": "Approves a shell another administrator asked for.",
        "operationId": "spin.v1.HostShellService.ApproveHostShell",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ApproveHostShellRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ApproveHostShellResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.HostShellService/CloseHostShell": {
      "post": {
        "tags": [
          "HostShellService"
        ],
        "summary": "CloseHostShell",
        "description": "Ends a shell: one not yet approved is refused, any other is ended and its host retired.",
        "operationId": "spin.v1.HostShellService.CloseHostShell",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.CloseHostShellRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.CloseHostShellResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.HostShellService/GetHostShellRecording": {
      "post": {
        "tags": [
          "HostShellService"
        ],
        "summary": "GetHostShellRecording",
        "description": "What a shell's sessions recorded, asciicast v2, each session's in turn.",
        "operationId": "spin.v1.HostShellService.GetHostShellRecording",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GetHostShellRecordingRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GetHostShellRecordingResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.HostShellService/ListHostShells": {
      "post": {
        "tags": [
          "HostShellService"
        ],
        "summary": "ListHostShells",
        "description": "The installation's host shells, newest first: all of them, or one host's.",
        "operationId": "spin.v1.HostShellService.ListHostShells",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListHostShellsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListHostShellsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.HostShellService/RequestHostShell": {
      "post": {
        "tags": [
          "HostShellService"
        ],
        "summary": "RequestHostShell",
        "description": "Asks for a shell on a host. Where the installation has a second administrator approve\n (host_shell_needs_approval), it waits for one; otherwise the host is emptied at once.",
        "operationId": "spin.v1.HostShellService.RequestHostShell",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.RequestHostShellRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.RequestHostShellResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.LogService/GetTrace": {
      "post": {
        "tags": [
          "LogService"
        ],
        "summary": "GetTrace",
        "description": "GetTrace is every span of one trace, in the order they began.",
        "operationId": "spin.v1.LogService.GetTrace",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GetTraceRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GetTraceResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.LogService/GetWorkspaceTrace": {
      "post": {
        "tags": [
          "LogService"
        ],
        "summary": "GetWorkspaceTrace",
        "description": "GetWorkspaceTrace is the spans of one trace marked as about one workspace, in the order they\n began, for its owner: the rest of the trace is left out, as SearchWorkspaceTraces leaves it.",
        "operationId": "spin.v1.LogService.GetWorkspaceTrace",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GetWorkspaceTraceRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GetWorkspaceTraceResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.LogService/HistogramPlatformLogs": {
      "post": {
        "tags": [
          "LogService"
        ],
        "summary": "HistogramPlatformLogs",
        "description": "HistogramPlatformLogs is how many of those records each interval of the window holds, by\n severity: the chart above them.",
        "operationId": "spin.v1.LogService.HistogramPlatformLogs",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.HistogramPlatformLogsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.HistogramLogsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.LogService/HistogramWorkspaceLogs": {
      "post": {
        "tags": [
          "LogService"
        ],
        "summary": "HistogramWorkspaceLogs",
        "description": "HistogramWorkspaceLogs is how many of those records each interval of the window holds.",
        "operationId": "spin.v1.LogService.HistogramWorkspaceLogs",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.HistogramWorkspaceLogsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.HistogramWorkspaceLogsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.LogService/KeptTraces": {
      "post": {
        "tags": [
          "LogService"
        ],
        "summary": "KeptTraces",
        "description": "KeptTraces is which of the trace ids a page shows the store holds: those, and only those,\n are links. A trace id is written where its span began, before the collector decides whether\n to keep the trace, and it stays after the store's retention has deleted it.",
        "operationId": "spin.v1.LogService.KeptTraces",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.KeptTracesRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.KeptTracesResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.LogService/ListLogIndexes": {
      "post": {
        "tags": [
          "LogService"
        ],
        "summary": "ListLogIndexes",
        "description": "ListLogIndexes is every index the store keeps, as the store itself reports it: its fields,\n how long it keeps what it holds and how much it holds. An administrator's: how much each\n index holds is how busy the installation and its workspaces are.",
        "operationId": "spin.v1.LogService.ListLogIndexes",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListLogIndexesRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListLogIndexesResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.LogService/PlatformLogFieldValues": {
      "post": {
        "tags": [
          "LogService"
        ],
        "summary": "PlatformLogFieldValues",
        "description": "PlatformLogFieldValues is what one field most often is in the records a search of the\n platform's logs finds: service_name, severity_text, attributes.* or resource_attributes.*.",
        "operationId": "spin.v1.LogService.PlatformLogFieldValues",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.PlatformLogFieldValuesRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.PlatformLogFieldValuesResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.LogService/SearchPlatformLogs": {
      "post": {
        "tags": [
          "LogService"
        ],
        "summary": "SearchPlatformLogs",
        "description": "SearchPlatformLogs is what the installation's own processes logged - the control plane, the\n proxy, the runners. An administrator's: a platform's log names every workspace it touched.",
        "operationId": "spin.v1.LogService.SearchPlatformLogs",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.SearchPlatformLogsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.SearchLogsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.LogService/SearchTraces": {
      "post": {
        "tags": [
          "LogService"
        ],
        "summary": "SearchTraces",
        "description": "SearchTraces is the installation's traces whose first span matches, newest first. An\n administrator's, as the platform's logs are.",
        "operationId": "spin.v1.LogService.SearchTraces",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.SearchTracesRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.SearchTracesResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.LogService/SearchWorkspaceLogs": {
      "post": {
        "tags": [
          "LogService"
        ],
        "summary": "SearchWorkspaceLogs",
        "description": "SearchWorkspaceLogs is what one workspace's machine wrote to its console, where the\n installation collects it: whoever may read the workspace's console may search it.",
        "operationId": "spin.v1.LogService.SearchWorkspaceLogs",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.SearchWorkspaceLogsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.SearchWorkspaceLogsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.LogService/SearchWorkspaceTraces": {
      "post": {
        "tags": [
          "LogService"
        ],
        "summary": "SearchWorkspaceTraces",
        "description": "SearchWorkspaceTraces is the spans marked as about one workspace - its creation, its starts\n and stops, what its host did for it - newest first, for its owner. A trace names every\n workspace it touched, so a span not marked as this one's is never answered, whichever trace\n it is in.",
        "operationId": "spin.v1.LogService.SearchWorkspaceTraces",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.SearchWorkspaceTracesRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.SearchWorkspaceTracesResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.LogService/ServiceHealth": {
      "post": {
        "tags": [
          "LogService"
        ],
        "summary": "ServiceHealth",
        "description": "ServiceHealth is how each of the installation's services did over a window, as its traces\n and logs say it. An administrator's, as the traces are.",
        "operationId": "spin.v1.LogService.ServiceHealth",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ServiceHealthRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ServiceHealthResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.LogService/WorkspaceLogFieldValues": {
      "post": {
        "tags": [
          "LogService"
        ],
        "summary": "WorkspaceLogFieldValues",
        "description": "WorkspaceLogFieldValues is the same of one workspace's, for whoever may read it.",
        "operationId": "spin.v1.LogService.WorkspaceLogFieldValues",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.WorkspaceLogFieldValuesRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.WorkspaceLogFieldValuesResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.PasskeyService/BeginPasskeyCeremony": {
      "post": {
        "tags": [
          "PasskeyService"
        ],
        "summary": "BeginPasskeyCeremony",
        "description": "A challenge for one ceremony of the caller's, bound to what it is for: a passkey registered, a\n key added, a passkey deleted. Taken once, by the call it is answered in, within minutes.",
        "operationId": "spin.v1.PasskeyService.BeginPasskeyCeremony",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.BeginPasskeyCeremonyRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.BeginPasskeyCeremonyResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.PasskeyService/DeletePasskey": {
      "post": {
        "tags": [
          "PasskeyService"
        ],
        "summary": "DeletePasskey",
        "description": "Deletes a passkey of the caller's, with an assertion of one of theirs.",
        "operationId": "spin.v1.PasskeyService.DeletePasskey",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.DeletePasskeyRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.DeletePasskeyResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.PasskeyService/ListPasskeys": {
      "post": {
        "tags": [
          "PasskeyService"
        ],
        "summary": "ListPasskeys",
        "operationId": "spin.v1.PasskeyService.ListPasskeys",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListPasskeysRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListPasskeysResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.PasskeyService/RegisterPasskey": {
      "post": {
        "tags": [
          "PasskeyService"
        ],
        "summary": "RegisterPasskey",
        "description": "Registers a passkey to the caller's account. The first is registered on their session alone;\n another takes an assertion of one they have, so a session cannot add a passkey of its own.",
        "operationId": "spin.v1.PasskeyService.RegisterPasskey",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.RegisterPasskeyRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.RegisterPasskeyResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.ProjectService/CreateProject": {
      "post": {
        "tags": [
          "ProjectService"
        ],
        "summary": "CreateProject",
        "operationId": "spin.v1.ProjectService.CreateProject",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.CreateProjectRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.CreateProjectResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.ProjectService/DeleteProject": {
      "post": {
        "tags": [
          "ProjectService"
        ],
        "summary": "DeleteProject",
        "operationId": "spin.v1.ProjectService.DeleteProject",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.DeleteProjectRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.DeleteProjectResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.ProjectService/GetPrebuild": {
      "post": {
        "tags": [
          "ProjectService"
        ],
        "summary": "GetPrebuild",
        "description": "One of them whole, with what its build's create tasks wrote, to whoever sees the project.",
        "operationId": "spin.v1.ProjectService.GetPrebuild",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GetPrebuildRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GetPrebuildResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.ProjectService/GetProject": {
      "post": {
        "tags": [
          "ProjectService"
        ],
        "summary": "GetProject",
        "operationId": "spin.v1.ProjectService.GetProject",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GetProjectRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GetProjectResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.ProjectService/GetProjectCosts": {
      "post": {
        "tags": [
          "ProjectService"
        ],
        "summary": "GetProjectCosts",
        "description": "What a project cost in the month in progress, to its admins and nobody else, as\n ListProjectWorkspaces: everybody's workspaces of it summed, its prebuilds' builds included,\n and a month of what its prebuilds keep. A sum, never by workspace: one workspace's cost says\n how much its owner works, which a project's admin who is not their team's is not told. Read\n from the bill as the installation last read it, never from the cloud.",
        "operationId": "spin.v1.ProjectService.GetProjectCosts",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GetProjectCostsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GetProjectCostsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.ProjectService/ListPrebuilds": {
      "post": {
        "tags": [
          "ProjectService"
        ],
        "summary": "ListPrebuilds",
        "description": "A project's prebuilds, to whoever sees it; and a build of one of its refs now, by its admins,\n rather than at the next look.",
        "operationId": "spin.v1.ProjectService.ListPrebuilds",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListPrebuildsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListPrebuildsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.ProjectService/ListProjectWorkspaces": {
      "post": {
        "tags": [
          "ProjectService"
        ],
        "summary": "ListProjectWorkspaces",
        "description": "Everybody's workspaces open on a project, to its admins and nobody else: a person it is only\n shared with is refused, and reads their own with ListWorkspaces.",
        "operationId": "spin.v1.ProjectService.ListProjectWorkspaces",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListProjectWorkspacesRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListProjectWorkspacesResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.ProjectService/ListProjects": {
      "post": {
        "tags": [
          "ProjectService"
        ],
        "summary": "ListProjects",
        "operationId": "spin.v1.ProjectService.ListProjects",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListProjectsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListProjectsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.ProjectService/RunPrebuild": {
      "post": {
        "tags": [
          "ProjectService"
        ],
        "summary": "RunPrebuild",
        "operationId": "spin.v1.ProjectService.RunPrebuild",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.RunPrebuildRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.RunPrebuildResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.ProjectService/ShareProject": {
      "post": {
        "tags": [
          "ProjectService"
        ],
        "summary": "ShareProject",
        "operationId": "spin.v1.ProjectService.ShareProject",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ShareProjectRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ShareProjectResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.ProjectService/UpdateProject": {
      "post": {
        "tags": [
          "ProjectService"
        ],
        "summary": "UpdateProject",
        "description": "Changed, shared and deleted by its admins. A project with a workspace open on it is not\n deleted.",
        "operationId": "spin.v1.ProjectService.UpdateProject",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.UpdateProjectRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.UpdateProjectResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.RunnerTokenService/CreateRegistrationToken": {
      "post": {
        "tags": [
          "RunnerTokenService"
        ],
        "summary": "CreateRegistrationToken",
        "description": "Generate a one-time registration token (admin only)",
        "operationId": "spin.v1.RunnerTokenService.CreateRegistrationToken",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.CreateRegistrationTokenRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.CreateRegistrationTokenResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.RunnerTokenService/ListRegistrationTokens": {
      "post": {
        "tags": [
          "RunnerTokenService"
        ],
        "summary": "ListRegistrationTokens",
        "description": "List active registration tokens (admin only)",
        "operationId": "spin.v1.RunnerTokenService.ListRegistrationTokens",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListRegistrationTokensRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListRegistrationTokensResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.RunnerTokenService/RevokeRegistrationToken": {
      "post": {
        "tags": [
          "RunnerTokenService"
        ],
        "summary": "RevokeRegistrationToken",
        "description": "Revoke a registration token (admin only)",
        "operationId": "spin.v1.RunnerTokenService.RevokeRegistrationToken",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.RevokeRegistrationTokenRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.RevokeRegistrationTokenResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.RunnerTokenService/RevokeRunner": {
      "post": {
        "tags": [
          "RunnerTokenService"
        ],
        "summary": "RevokeRunner",
        "description": "Revoke a runner (admin only)",
        "operationId": "spin.v1.RunnerTokenService.RevokeRunner",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.RevokeRunnerRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.RevokeRunnerResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.SSHKeyService/AddSSHKey": {
      "post": {
        "tags": [
          "SSHKeyService"
        ],
        "summary": "AddSSHKey",
        "description": "Adds a key, with an assertion of a passkey of the caller's over a PASSKEY_PURPOSE_ADD_SSH_KEY\n challenge naming it.",
        "operationId": "spin.v1.SSHKeyService.AddSSHKey",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.AddSSHKeyRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.AddSSHKeyResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.SSHKeyService/DeleteSSHKey": {
      "post": {
        "tags": [
          "SSHKeyService"
        ],
        "summary": "DeleteSSHKey",
        "description": "Delete an SSH key from user's account",
        "operationId": "spin.v1.SSHKeyService.DeleteSSHKey",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.DeleteSSHKeyRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.DeleteSSHKeyResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.SSHKeyService/ListSSHKeys": {
      "post": {
        "tags": [
          "SSHKeyService"
        ],
        "summary": "ListSSHKeys",
        "description": "List user's SSH public keys",
        "operationId": "spin.v1.SSHKeyService.ListSSHKeys",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListSSHKeysRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListSSHKeysResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.SettingsService/GetNotificationPreferences": {
      "post": {
        "tags": [
          "SettingsService"
        ],
        "summary": "GetNotificationPreferences",
        "description": "Which of those the caller is emailed about, and for an administrator which of the\n installation's events besides.",
        "operationId": "spin.v1.SettingsService.GetNotificationPreferences",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GetNotificationPreferencesRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GetNotificationPreferencesResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.SettingsService/GetUserSettings": {
      "post": {
        "tags": [
          "SettingsService"
        ],
        "summary": "GetUserSettings",
        "description": "User settings",
        "operationId": "spin.v1.SettingsService.GetUserSettings",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GetUserSettingsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GetUserSettingsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.SettingsService/ListNotifications": {
      "post": {
        "tags": [
          "SettingsService"
        ],
        "summary": "ListNotifications",
        "description": "What happened to the caller's workspaces that they are told of, newest first, with whether\n each was sent and how. Recorded whether or not the installation can send email.",
        "operationId": "spin.v1.SettingsService.ListNotifications",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListNotificationsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListNotificationsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.SettingsService/UpdateNotificationPreferences": {
      "post": {
        "tags": [
          "SettingsService"
        ],
        "summary": "UpdateNotificationPreferences",
        "operationId": "spin.v1.SettingsService.UpdateNotificationPreferences",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.UpdateNotificationPreferencesRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.UpdateNotificationPreferencesResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.SettingsService/UpdateUserSettings": {
      "post": {
        "tags": [
          "SettingsService"
        ],
        "summary": "UpdateUserSettings",
        "operationId": "spin.v1.SettingsService.UpdateUserSettings",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.UpdateUserSettingsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.UpdateUserSettingsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.SettingsService/ValidateTaskfile": {
      "post": {
        "tags": [
          "SettingsService"
        ],
        "summary": "ValidateTaskfile",
        "description": "Validate Taskfile syntax",
        "operationId": "spin.v1.SettingsService.ValidateTaskfile",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ValidateTaskfileRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ValidateTaskfileResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.SetupService/ChangePassword": {
      "post": {
        "tags": [
          "SetupService"
        ],
        "summary": "ChangePassword",
        "description": "Change admin password (requires auth)\n Called after initial login when force_password_change is true",
        "operationId": "spin.v1.SetupService.ChangePassword",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ChangePasswordRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ChangePasswordResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.SetupService/CompleteSetup": {
      "post": {
        "tags": [
          "SetupService"
        ],
        "summary": "CompleteSetup",
        "description": "Mark setup wizard as complete (requires admin)",
        "operationId": "spin.v1.SetupService.CompleteSetup",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.CompleteSetupRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.CompleteSetupResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.SetupService/ConfigureGitHubOAuth": {
      "post": {
        "tags": [
          "SetupService"
        ],
        "summary": "ConfigureGitHubOAuth",
        "description": "Configure GitHub OAuth credentials (requires admin)\n Encrypts and stores client_secret in the database",
        "operationId": "spin.v1.SetupService.ConfigureGitHubOAuth",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ConfigureGitHubOAuthRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ConfigureGitHubOAuthResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.SetupService/DisableBootstrapAdmin": {
      "post": {
        "tags": [
          "SetupService"
        ],
        "summary": "DisableBootstrapAdmin",
        "description": "Disable the bootstrap admin account (requires admin + OAuth must be configured)\n This removes password login capability for the bootstrap user",
        "operationId": "spin.v1.SetupService.DisableBootstrapAdmin",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.DisableBootstrapAdminRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.DisableBootstrapAdminResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.SetupService/EnableDevMode": {
      "post": {
        "tags": [
          "SetupService"
        ],
        "summary": "EnableDevMode",
        "description": "Enable dev mode (requires admin)\n Creates a \"dev\" identity provider that allows login without real OAuth\n Only use for local development - not for production",
        "operationId": "spin.v1.SetupService.EnableDevMode",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.EnableDevModeRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.EnableDevModeResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.SetupService/GetSetupStatus": {
      "post": {
        "tags": [
          "SetupService"
        ],
        "summary": "GetSetupStatus",
        "description": "Get current setup status (public - no auth required)\n Returns whether setup wizard needs to be completed",
        "operationId": "spin.v1.SetupService.GetSetupStatus",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GetSetupStatusRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GetSetupStatusResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.SetupService/PasswordLogin": {
      "post": {
        "tags": [
          "SetupService"
        ],
        "summary": "PasswordLogin",
        "description": "Login with email/password (public - for admin bootstrap)\n Only works for users with admin_credentials",
        "operationId": "spin.v1.SetupService.PasswordLogin",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.PasswordLoginRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.PasswordLoginResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.ShareService/ListSharedSnapshots": {
      "post": {
        "tags": [
          "ShareService"
        ],
        "summary": "ListSharedSnapshots",
        "description": "List snapshots shared with the current user (or public)",
        "operationId": "spin.v1.ShareService.ListSharedSnapshots",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListSharedSnapshotsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListSharedSnapshotsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.ShareService/ListSnapshotShares": {
      "post": {
        "tags": [
          "ShareService"
        ],
        "summary": "ListSnapshotShares",
        "description": "List users who have access to a snapshot",
        "operationId": "spin.v1.ShareService.ListSnapshotShares",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListSnapshotSharesRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListSnapshotSharesResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.ShareService/SetSnapshotVisibility": {
      "post": {
        "tags": [
          "ShareService"
        ],
        "summary": "SetSnapshotVisibility",
        "description": "Set snapshot visibility (public/private)",
        "operationId": "spin.v1.ShareService.SetSnapshotVisibility",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.SetSnapshotVisibilityRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.SetSnapshotVisibilityResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.ShareService/ShareSnapshot": {
      "post": {
        "tags": [
          "ShareService"
        ],
        "summary": "ShareSnapshot",
        "description": "Share a snapshot with a specific user",
        "operationId": "spin.v1.ShareService.ShareSnapshot",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ShareSnapshotRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ShareSnapshotResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.ShareService/UnshareSnapshot": {
      "post": {
        "tags": [
          "ShareService"
        ],
        "summary": "UnshareSnapshot",
        "description": "Remove a user's access to a snapshot",
        "operationId": "spin.v1.ShareService.UnshareSnapshot",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.UnshareSnapshotRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.UnshareSnapshotResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.TeamService/AddMember": {
      "post": {
        "tags": [
          "TeamService"
        ],
        "summary": "AddMember",
        "operationId": "spin.v1.TeamService.AddMember",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.AddTeamMemberRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.AddTeamMemberResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.TeamService/CreateIdentityProvider": {
      "post": {
        "tags": [
          "TeamService"
        ],
        "summary": "CreateIdentityProvider",
        "operationId": "spin.v1.TeamService.CreateIdentityProvider",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.CreateTeamIdentityProviderRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.CreateTeamIdentityProviderResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.TeamService/CreateTeam": {
      "post": {
        "tags": [
          "TeamService"
        ],
        "summary": "CreateTeam",
        "description": "Create a new team (can be nested under parent_id)",
        "operationId": "spin.v1.TeamService.CreateTeam",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.CreateTeamRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.CreateTeamResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.TeamService/DeleteIdentityProvider": {
      "post": {
        "tags": [
          "TeamService"
        ],
        "summary": "DeleteIdentityProvider",
        "operationId": "spin.v1.TeamService.DeleteIdentityProvider",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.DeleteTeamIdentityProviderRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.DeleteTeamIdentityProviderResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.TeamService/DeleteNetworkPolicy": {
      "post": {
        "tags": [
          "TeamService"
        ],
        "summary": "DeleteNetworkPolicy",
        "operationId": "spin.v1.TeamService.DeleteNetworkPolicy",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.DeleteTeamNetworkPolicyRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.DeleteTeamNetworkPolicyResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.TeamService/DeleteSecret": {
      "post": {
        "tags": [
          "TeamService"
        ],
        "summary": "DeleteSecret",
        "operationId": "spin.v1.TeamService.DeleteSecret",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.DeleteTeamSecretRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.DeleteTeamSecretResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.TeamService/DeleteTeam": {
      "post": {
        "tags": [
          "TeamService"
        ],
        "summary": "DeleteTeam",
        "description": "Delete team (owner only, must have no children)",
        "operationId": "spin.v1.TeamService.DeleteTeam",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.DeleteTeamRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.DeleteTeamResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.TeamService/GetTeam": {
      "post": {
        "tags": [
          "TeamService"
        ],
        "summary": "GetTeam",
        "description": "Get team by ID or path",
        "operationId": "spin.v1.TeamService.GetTeam",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GetTeamRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GetTeamResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.TeamService/GetTeamCosts": {
      "post": {
        "tags": [
          "TeamService"
        ],
        "summary": "GetTeamCosts",
        "description": "What the team's workspaces cost in the month in progress, each and summed, for the team's\n admins: a member reads their own workspace's (WorkspaceService.GetWorkspaceCost) and nobody\n else's. A workspace is the team's whose it was on the last day it cost anything; a team below\n this one is not counted in it.",
        "operationId": "spin.v1.TeamService.GetTeamCosts",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GetTeamCostsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GetTeamCostsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.TeamService/ListIdentityProviders": {
      "post": {
        "tags": [
          "TeamService"
        ],
        "summary": "ListIdentityProviders",
        "description": "Identity provider management (admin only)",
        "operationId": "spin.v1.TeamService.ListIdentityProviders",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListTeamIdentityProvidersRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListTeamIdentityProvidersResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.TeamService/ListMembers": {
      "post": {
        "tags": [
          "TeamService"
        ],
        "summary": "ListMembers",
        "description": "Member management",
        "operationId": "spin.v1.TeamService.ListMembers",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListTeamMembersRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListTeamMembersResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.TeamService/ListSecrets": {
      "post": {
        "tags": [
          "TeamService"
        ],
        "summary": "ListSecrets",
        "operationId": "spin.v1.TeamService.ListSecrets",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListTeamSecretsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListTeamSecretsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.TeamService/ListTeams": {
      "post": {
        "tags": [
          "TeamService"
        ],
        "summary": "ListTeams",
        "description": "List teams (optionally filtered by parent)",
        "operationId": "spin.v1.TeamService.ListTeams",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListTeamsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListTeamsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.TeamService/RemoveMember": {
      "post": {
        "tags": [
          "TeamService"
        ],
        "summary": "RemoveMember",
        "operationId": "spin.v1.TeamService.RemoveMember",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.RemoveTeamMemberRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.RemoveTeamMemberResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.TeamService/SetNetworkPolicy": {
      "post": {
        "tags": [
          "TeamService"
        ],
        "summary": "SetNetworkPolicy",
        "description": "A team's egress policies: named, and only allowing - no rule brokers - for the workspaces of\n the team and the teams below it. Set and deleted by its admins where the installation lets\n teams declare them (team_network_policies); listed by WorkspaceService.ListNetworkPolicies.",
        "operationId": "spin.v1.TeamService.SetNetworkPolicy",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.SetTeamNetworkPolicyRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.SetTeamNetworkPolicyResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.TeamService/SetSecret": {
      "post": {
        "tags": [
          "TeamService"
        ],
        "summary": "SetSecret",
        "description": "A team's secrets: what a brokered network rule has the host's egress proxy add to a request,\n so a workspace of the team uses a key it never holds. Set and deleted by the team's admins,\n listed by name to its members; a value is never answered with again.",
        "operationId": "spin.v1.TeamService.SetSecret",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.SetTeamSecretRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.SetTeamSecretResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.TeamService/UpdateIdentityProvider": {
      "post": {
        "tags": [
          "TeamService"
        ],
        "summary": "UpdateIdentityProvider",
        "operationId": "spin.v1.TeamService.UpdateIdentityProvider",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.UpdateTeamIdentityProviderRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.UpdateTeamIdentityProviderResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.TeamService/UpdateMemberRole": {
      "post": {
        "tags": [
          "TeamService"
        ],
        "summary": "UpdateMemberRole",
        "operationId": "spin.v1.TeamService.UpdateMemberRole",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.UpdateTeamMemberRoleRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.UpdateTeamMemberRoleResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.TeamService/UpdateTeam": {
      "post": {
        "tags": [
          "TeamService"
        ],
        "summary": "UpdateTeam",
        "description": "Update team settings",
        "operationId": "spin.v1.TeamService.UpdateTeam",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.UpdateTeamRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.UpdateTeamResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/AddWorkspaceGuest": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "AddWorkspaceGuest",
        "description": "Invite a person to log in to a workspace as its guest, by their email: the owner's to ask, with\n an assertion of a passkey of theirs - a guest is root in the workspace, so a session alone\n lets nobody in. They log in from then on.",
        "operationId": "spin.v1.WorkspaceService.AddWorkspaceGuest",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.AddWorkspaceGuestRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.AddWorkspaceGuestResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/AttachVSCodeServer": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "AttachVSCodeServer",
        "description": "Give a running workspace the VS Code server of a client's commit, while it runs: published\n first when this installation has not got it and an administrator accepted the VS Code\n server's terms (AdminService.AcceptThirdPartyTerms), refused as FAILED_PRECONDITION, saying\n so, when nobody did. Asked again until it answers attached.",
        "operationId": "spin.v1.WorkspaceService.AttachVSCodeServer",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.AttachVSCodeServerRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.AttachVSCodeServerResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/CheckPortAccess": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "CheckPortAccess",
        "description": "Whether one request may reach one published port. The gate in front of them.",
        "operationId": "spin.v1.WorkspaceService.CheckPortAccess",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.CheckPortAccessRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.CheckPortAccessResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/CheckPortPublished": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "CheckPortPublished",
        "description": "Whether a published port's name is one this installation serves, whoever may reach it: the\n proxy's on-demand TLS question, asked before any browser has a session to send.",
        "operationId": "spin.v1.WorkspaceService.CheckPortPublished",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.CheckPortPublishedRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.CheckPortPublishedResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/CloneWorkspace": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "CloneWorkspace",
        "description": "Clone a running workspace: a snapshot of its disk, published, and a workspace created from it\n with the source's team, project and ref, size, network policies and environment, owned by the\n caller. Disk only: a clone has an identity of its own, so no memory goes with it. The snapshot\n stays, as the clone's floor. Answers once the clone exists, which takes as long as publishing\n the source's disk.",
        "operationId": "spin.v1.WorkspaceService.CloneWorkspace",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.CloneWorkspaceRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.CloneWorkspaceResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/CreateSnapshot": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "CreateSnapshot",
        "description": "Create a snapshot of the current workspace state",
        "operationId": "spin.v1.WorkspaceService.CreateSnapshot",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.CreateSnapshotRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.CreateSnapshotResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/CreateWorkspace": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "CreateWorkspace",
        "description": "Create a new workspace",
        "operationId": "spin.v1.WorkspaceService.CreateWorkspace",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.CreateWorkspaceRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.CreateWorkspaceResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/DeleteAgentVolume": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "DeleteAgentVolume",
        "description": "Erase an agent home no workspace mounts: its volume, its key and its bytes.",
        "operationId": "spin.v1.WorkspaceService.DeleteAgentVolume",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.DeleteAgentVolumeRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.DeleteAgentVolumeResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/DeleteSnapshot": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "DeleteSnapshot",
        "description": "Delete a snapshot",
        "operationId": "spin.v1.WorkspaceService.DeleteSnapshot",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.DeleteSnapshotRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.DeleteSnapshotResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/DeleteWorkspace": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "DeleteWorkspace",
        "description": "Delete a workspace: into the trash, where the installation keeps one, or erased.",
        "operationId": "spin.v1.WorkspaceService.DeleteWorkspace",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.DeleteWorkspaceRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.DeleteWorkspaceResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/DiffSnapshots": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "DiffSnapshots",
        "description": "Compare two of a workspace's snapshots file by file.",
        "operationId": "spin.v1.WorkspaceService.DiffSnapshots",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.DiffSnapshotsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.DiffSnapshotsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/ExposePort": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "ExposePort",
        "description": "Port exposure",
        "operationId": "spin.v1.WorkspaceService.ExposePort",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ExposePortRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ExposePortResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/GetWorkspace": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "GetWorkspace",
        "description": "Get a specific workspace",
        "operationId": "spin.v1.WorkspaceService.GetWorkspace",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GetWorkspaceRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GetWorkspaceResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/GetWorkspaceConsole": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "GetWorkspaceConsole",
        "description": "The tail of the workspace's serial console: the kernel, vminit, then the supervisor. It is\n where a machine that never came up says why, and it is read on demand from the host that\n holds it. An installation that collects consoles also keeps them, searchable for their\n retention (LogService.SearchWorkspaceLogs); one that does not keeps them on the host, since\n the console also carries what the tenant's own programs print.",
        "operationId": "spin.v1.WorkspaceService.GetWorkspaceConsole",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GetWorkspaceConsoleRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GetWorkspaceConsoleResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/GetWorkspaceCost": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "GetWorkspaceCost",
        "description": "What the workspace cost in the month in progress and what it costs while it runs, for whoever\n reads the workspace itself: its owner, and a guest its owner let in. Nobody else is answered -\n one workspace's cost says how much another person works. Read from the bill as the\n installation last read it, never from the cloud.",
        "operationId": "spin.v1.WorkspaceService.GetWorkspaceCost",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GetWorkspaceCostRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GetWorkspaceCostResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/GetWorkspaceDeletion": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "GetWorkspaceDeletion",
        "description": "What deleting a workspace would do, asked before it is done: what goes to the trash and for\n how long, what is erased at once, and what outlives it. It changes nothing.",
        "operationId": "spin.v1.WorkspaceService.GetWorkspaceDeletion",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GetWorkspaceDeletionRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GetWorkspaceDeletionResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/GetWorkspaceEgress": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "GetWorkspaceEgress",
        "description": "What a running workspace has actually reached beyond the node.",
        "operationId": "spin.v1.WorkspaceService.GetWorkspaceEgress",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GetWorkspaceEgressRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GetWorkspaceEgressResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/GetWorkspaceHistory": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "GetWorkspaceHistory",
        "description": "Get workspace history (snapshots/state changes timeline)",
        "operationId": "spin.v1.WorkspaceService.GetWorkspaceHistory",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GetWorkspaceHistoryRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GetWorkspaceHistoryResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/GetWorkspaceIdentity": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "GetWorkspaceIdentity",
        "description": "Who the workspace is outside spin: the identity its tokens and signatures carry, the issuer a\n relying party trusts it by, and what it was cloned from.",
        "operationId": "spin.v1.WorkspaceService.GetWorkspaceIdentity",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GetWorkspaceIdentityRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GetWorkspaceIdentityResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/GetWorkspaceStatus": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "GetWorkspaceStatus",
        "description": "What every party believes about one workspace, and where they disagree.",
        "operationId": "spin.v1.WorkspaceService.GetWorkspaceStatus",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GetWorkspaceStatusRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GetWorkspaceStatusResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/GetWorkspaceUsage": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "GetWorkspaceUsage",
        "description": "What the workspace's machine used of what it held, over the last hour at most, as its host\n sampled it: a running machine's up to now, a stopped or failed one's up to when it ended.\n The samples live on that host, so the series begins where the machine began there, and goes\n with a restart of the host, a move, the workspace's next start or its removal.",
        "operationId": "spin.v1.WorkspaceService.GetWorkspaceUsage",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GetWorkspaceUsageRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GetWorkspaceUsageResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/GrantPortAccess": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "GrantPortAccess",
        "operationId": "spin.v1.WorkspaceService.GrantPortAccess",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GrantPortAccessRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GrantPortAccessResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/GrantWorkspaceResources": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "GrantWorkspaceResources",
        "description": "Give a workspace more cores and memory of its own, up to its preset's ceiling: its host\n reserves them and its machine is grown while it runs. The grant lasts until it is released\n or the workspace is deleted.",
        "operationId": "spin.v1.WorkspaceService.GrantWorkspaceResources",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.GrantWorkspaceResourcesRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.GrantWorkspaceResourcesResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/KeepWorkspace": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "KeepWorkspace",
        "description": "Keep a running workspace awake for a while: neither the idle suspension nor the running cap\n fires before kept_until, and the question asked before one (suspends_at) is withdrawn. An\n answer with an end, never permanent: at most a day at a time (MaxKeepMinutes).",
        "operationId": "spin.v1.WorkspaceService.KeepWorkspace",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.KeepWorkspaceRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.KeepWorkspaceResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/ListAgentThreads": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "ListAgentThreads",
        "description": "The agent's threads - T3 Code's chats - as the workspace's supervisor last reported them.\n Titles, paths and\n times, never a message: the chat itself is read in T3 Code, over the owner's own session\n (`spin agent`).",
        "operationId": "spin.v1.WorkspaceService.ListAgentThreads",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListAgentThreadsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListAgentThreadsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/ListAgentVolumes": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "ListAgentVolumes",
        "description": "The caller's agent homes: the volume each workspace of theirs mounts at /home/spin-agent-t3,\n which outlives the workspace - its chats, its sessions - and which another workspace mounts\n at its creation (CreateWorkspaceRequest.agent_volume_id).",
        "operationId": "spin.v1.WorkspaceService.ListAgentVolumes",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListAgentVolumesRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListAgentVolumesResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/ListDeletedWorkspaces": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "ListDeletedWorkspaces",
        "description": "The caller's workspaces in the trash, and until when each can be undeleted.",
        "operationId": "spin.v1.WorkspaceService.ListDeletedWorkspaces",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListDeletedWorkspacesRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListDeletedWorkspacesResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/ListExposedPorts": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "ListExposedPorts",
        "operationId": "spin.v1.WorkspaceService.ListExposedPorts",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListExposedPortsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListExposedPortsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/ListImages": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "ListImages",
        "description": "The images a workspace can actually be created from. A client that offers a name from\n anywhere else - a constant it ships, a container registry it knows of - offers a create\n that fails, because a workspace's disk is cloned from a published image and nothing else.",
        "operationId": "spin.v1.WorkspaceService.ListImages",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListImagesRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListImagesResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/ListNetworkPolicies": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "ListNetworkPolicies",
        "description": "The network policies a workspace can be created with, as the hosts report them.",
        "operationId": "spin.v1.WorkspaceService.ListNetworkPolicies",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListNetworkPoliciesRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListNetworkPoliciesResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/ListOwnAgentThreads": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "ListOwnAgentThreads",
        "description": "The caller's own chats across every workspace of theirs, each workspace's as its supervisor\n last reported them: what the dashboard's chat mode lists in one rail. Selected by the caller's\n id, never one from the request, and a key bound to a team or projects lists theirs alone.",
        "operationId": "spin.v1.WorkspaceService.ListOwnAgentThreads",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListOwnAgentThreadsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListOwnAgentThreadsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/ListSnapshots": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "ListSnapshots",
        "description": "List snapshots for a workspace",
        "operationId": "spin.v1.WorkspaceService.ListSnapshots",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListSnapshotsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListSnapshotsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/ListWorkspaceGuests": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "ListWorkspaceGuests",
        "description": "The people who log in to a workspace besides its owner, oldest invitation first.",
        "operationId": "spin.v1.WorkspaceService.ListWorkspaceGuests",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListWorkspaceGuestsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListWorkspaceGuestsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/ListWorkspaceQuarantineDenials": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "ListWorkspaceQuarantineDenials",
        "description": "What a workspace attempted past its policy: the refusals its supervisor reported, newest\n first - an administrator's reading of what was tried while it was held.",
        "operationId": "spin.v1.WorkspaceService.ListWorkspaceQuarantineDenials",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListWorkspaceQuarantineDenialsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListWorkspaceQuarantineDenialsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/ListWorkspaceTimeline": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "ListWorkspaceTimeline",
        "description": "What happened to a workspace, newest first, between two instants: its own events and what\n the audit log records of it and its snapshots, each with who did it - for its owner, read as\n GetWorkspaceHistory is. AdminService.ListTimeline is the same reading of any workspace, a host,\n a team, a project or the whole installation.",
        "operationId": "spin.v1.WorkspaceService.ListWorkspaceTimeline",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListWorkspaceTimelineRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListWorkspaceTimelineResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/ListWorkspaces": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "ListWorkspaces",
        "description": "List workspaces for the authenticated user",
        "operationId": "spin.v1.WorkspaceService.ListWorkspaces",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ListWorkspacesRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ListWorkspacesResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/MoveWorkspace": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "MoveWorkspace",
        "description": "Move a running workspace to another host: suspended where it runs, its processes as they\n are, and resumed there from the checkpoint, holding what it holds. Placement chooses the host,\n as it does at a start. A workspace that is not running is refused: placement decides where it\n runs at its next start.",
        "operationId": "spin.v1.WorkspaceService.MoveWorkspace",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.MoveWorkspaceRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.MoveWorkspaceResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/OpenWorkspaceProxySession": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "OpenWorkspaceProxySession",
        "description": "One connection into a published port, for the proxy, when it needs a new one.",
        "operationId": "spin.v1.WorkspaceService.OpenWorkspaceProxySession",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.OpenWorkspaceProxySessionRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.OpenWorkspaceProxySessionResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/QuarantineWorkspace": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "QuarantineWorkspace",
        "description": "Hold a workspace in quarantine: an administrator's decision, held until one releases it.\n A stopped workspace is held at once; one whose machine runs is stopped first, forced, and\n held when its host says it stopped. Its disk is kept as it was, and meanwhile its own\n person cannot start, move or delete it.",
        "operationId": "spin.v1.WorkspaceService.QuarantineWorkspace",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.QuarantineWorkspaceRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.QuarantineWorkspaceResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/RecoverWorkspace": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "RecoverWorkspace",
        "description": "Re-home a workspace whose host is gone, at a cost its owner accepts.",
        "operationId": "spin.v1.WorkspaceService.RecoverWorkspace",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.RecoverWorkspaceRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.RecoverWorkspaceResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/ReleaseWorkspaceQuarantine": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "ReleaseWorkspaceQuarantine",
        "description": "Release what was quarantined: stopped, with its disk as it was - or, where the stop a\n quarantine asked for ended FAILED, failed as it is, and no longer held.",
        "operationId": "spin.v1.WorkspaceService.ReleaseWorkspaceQuarantine",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ReleaseWorkspaceQuarantineRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ReleaseWorkspaceQuarantineResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/ReleaseWorkspaceResources": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "ReleaseWorkspaceResources",
        "description": "Give a grant back: the workspace holds its floor again, and its machine is shrunk while it runs.",
        "operationId": "spin.v1.WorkspaceService.ReleaseWorkspaceResources",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.ReleaseWorkspaceResourcesRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.ReleaseWorkspaceResourcesResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/RemoveWorkspaceGuest": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "RemoveWorkspaceGuest",
        "description": "Take a guest out: the next session they ask for is refused, and the one they hold ends with\n its certificate.",
        "operationId": "spin.v1.WorkspaceService.RemoveWorkspaceGuest",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.RemoveWorkspaceGuestRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.RemoveWorkspaceGuestResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/RestoreWorkspace": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "RestoreWorkspace",
        "description": "Put a stopped workspace's disk back to one of its snapshots, or to what it was created from.",
        "operationId": "spin.v1.WorkspaceService.RestoreWorkspace",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.RestoreWorkspaceRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.RestoreWorkspaceResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/RevokePortAccess": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "RevokePortAccess",
        "operationId": "spin.v1.WorkspaceService.RevokePortAccess",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.RevokePortAccessRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.RevokePortAccessResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/SetPortAccess": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "SetPortAccess",
        "description": "Who may reach a published port, and who it is shared with.",
        "operationId": "spin.v1.WorkspaceService.SetPortAccess",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.SetPortAccessRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.SetPortAccessResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/SetWorkspaceBandwidth": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "SetWorkspaceBandwidth",
        "description": "Set what a workspace's network carries each way, an instance admin's to change: the limit\n bounds the installation's egress bill. A running machine is brought to it where it runs, with\n its connections open; any other takes it at its next start.",
        "operationId": "spin.v1.WorkspaceService.SetWorkspaceBandwidth",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.SetWorkspaceBandwidthRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.SetWorkspaceBandwidthResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/SetWorkspaceNetworkTags": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "SetWorkspaceNetworkTags",
        "description": "Change which egress policies a workspace runs under, while it runs.",
        "operationId": "spin.v1.WorkspaceService.SetWorkspaceNetworkTags",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.SetWorkspaceNetworkTagsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.SetWorkspaceNetworkTagsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/SetWorkspaceNetworkWatch": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "SetWorkspaceNetworkWatch",
        "description": "Watch where a workspace connects: its host records each lookup, each destination it is let\n through to and each it is refused, with the time, into the workspace's logs.",
        "operationId": "spin.v1.WorkspaceService.SetWorkspaceNetworkWatch",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.SetWorkspaceNetworkWatchRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.SetWorkspaceNetworkWatchResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/StartWorkspace": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "StartWorkspace",
        "description": "Start a stopped workspace on its own disk, or resume a suspended one from the memory it kept.",
        "operationId": "spin.v1.WorkspaceService.StartWorkspace",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.StartWorkspaceRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.StartWorkspaceResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/StopWorkspace": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "StopWorkspace",
        "description": "Stop a running workspace. Its disk is its volume, kept as it is; no snapshot is taken.",
        "operationId": "spin.v1.WorkspaceService.StopWorkspace",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.StopWorkspaceRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.StopWorkspaceResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/SuspendWorkspace": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "SuspendWorkspace",
        "description": "Put a running workspace down with its processes where they are: its memory and its disk\n are checkpointed and the machine is stopped, and its next start resumes that instant - on\n any host carrying the same machine. The same thing a drained host does to what it runs.\n The guest is paused from the checkpoint until it is resumed: it does nothing in between, and\n nothing it did is given up. Answered once the memory is stored and the disk published. One\n that fails after the checkpoint lets the guest run on where it was.",
        "operationId": "spin.v1.WorkspaceService.SuspendWorkspace",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.SuspendWorkspaceRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.SuspendWorkspaceResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/UndeleteWorkspace": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "UndeleteWorkspace",
        "description": "Take a workspace out of the trash, stopped, with its disk and snapshots as they were.",
        "operationId": "spin.v1.WorkspaceService.UndeleteWorkspace",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.UndeleteWorkspaceRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.UndeleteWorkspaceResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/UnexposePort": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "UnexposePort",
        "operationId": "spin.v1.WorkspaceService.UnexposePort",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.UnexposePortRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.UnexposePortResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/UpdateWorkspace": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "UpdateWorkspace",
        "description": "Update workspace properties (name, env)",
        "operationId": "spin.v1.WorkspaceService.UpdateWorkspace",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.UpdateWorkspaceRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.UpdateWorkspaceResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/WaitSnapshot": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "WaitSnapshot",
        "description": "Wait for a snapshot to be published: until then it cannot be restored, cloned or diffed.",
        "operationId": "spin.v1.WorkspaceService.WaitSnapshot",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.WaitSnapshotRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.WaitSnapshotResponse"
                }
              }
            }
          }
        }
      }
    },
    "/spin.v1.WorkspaceService/WaitWorkspace": {
      "post": {
        "tags": [
          "WorkspaceService"
        ],
        "summary": "WaitWorkspace",
        "description": "Wait for a workspace to reach a state: create, start and stop are answered once they are\n asked for, and this is how a caller learns they are done without polling.",
        "operationId": "spin.v1.WorkspaceService.WaitWorkspace",
        "parameters": [
          {
            "name": "Connect-Protocol-Version",
            "in": "header",
            "description": "Define the version of the Connect protocol",
            "schema": {
              "$ref": "#/components/schemas/connect-protocol-version"
            },
            "example": 1
          },
          {
            "name": "Connect-Timeout-Ms",
            "in": "header",
            "description": "Define the timeout, in ms",
            "schema": {
              "$ref": "#/components/schemas/connect-timeout-header"
            },
            "example": 1000
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spin.v1.WaitWorkspaceRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/connect.error"
                }
              }
            }
          },
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spin.v1.WaitWorkspaceResponse"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "connect-protocol-version": {
        "type": "number",
        "examples": [
          1
        ],
        "title": "Connect-Protocol-Version",
        "description": "Define the version of the Connect protocol",
        "const": 1
      },
      "connect-timeout-header": {
        "type": "number",
        "examples": [
          1000
        ],
        "title": "Connect-Timeout-Ms",
        "description": "Define the timeout, in ms"
      },
      "connect.error": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "examples": [
              "not_found"
            ],
            "enum": [
              "canceled",
              "unknown",
              "invalid_argument",
              "deadline_exceeded",
              "not_found",
              "already_exists",
              "permission_denied",
              "resource_exhausted",
              "failed_precondition",
              "aborted",
              "out_of_range",
              "unimplemented",
              "internal",
              "unavailable",
              "data_loss",
              "unauthenticated"
            ],
            "description": "The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]."
          },
          "message": {
            "type": "string",
            "description": "A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client."
          },
          "details": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/connect.error_details.Any"
            },
            "description": "A list of messages that carry the error details. There is no limit on the number of messages."
          }
        },
        "title": "Connect Error",
        "additionalProperties": true,
        "description": "Error type returned by Connect: https://connectrpc.com/docs/go/errors/#http-representation"
      },
      "connect.error_details.Any": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "A URL that acts as a globally unique identifier for the type of the serialized message. For example: `type.googleapis.com/google.rpc.ErrorInfo`."
          },
          "value": {
            "type": "string",
            "format": "byte",
            "description": "The Protobuf message, serialized as bytes and base64-encoded. The specific message type is identified by the `type` field."
          },
          "debug": {
            "type": "object",
            "title": "Debug",
            "additionalProperties": true,
            "description": "Deserialized error detail payload. The 'type' field indicates the schema. This field is for easier debugging and should not be relied upon for application logic."
          }
        },
        "additionalProperties": true,
        "description": "Contains an arbitrary serialized message along with a @type that describes the type of the serialized message, with an additional debug field for ConnectRPC error details."
      },
      "google.protobuf.Duration": {
        "type": "string",
        "format": "duration",
        "description": "A signed duration in seconds, with up to nine fractional digits and an `s` suffix (for example, `3s` or `-0.001s`)."
      },
      "google.protobuf.ListValue": {
        "type": "array",
        "items": {
          "$ref": "#/components/schemas/google.protobuf.Value"
        },
        "description": "A JSON array whose elements may be any JSON value."
      },
      "google.protobuf.NullValue": {
        "type": "string",
        "title": "NullValue",
        "enum": [
          "NULL_VALUE"
        ],
        "description": "Represents a JSON `null`.\n\n `NullValue` is a sentinel, using an enum with only one value to represent\n the null value for the `Value` type union.\n\n A field of type `NullValue` with any value other than `0` is considered\n invalid. Most ProtoJSON serializers will emit a `Value` with a `null_value`\n set as a JSON `null` regardless of the integer value, and so will round trip\n to a `0` value.\n\n- `NULL_VALUE`: Null value.",
        "x-enum-descriptions": [
          "Null value."
        ]
      },
      "google.protobuf.Struct": {
        "type": "object",
        "additionalProperties": {
          "$ref": "#/components/schemas/google.protobuf.Value"
        },
        "description": "A JSON object whose property values may be any JSON value."
      },
      "google.protobuf.Timestamp": {
        "type": "string",
        "examples": [
          "2023-01-15T01:30:15.01Z",
          "2024-12-25T12:00:00Z"
        ],
        "format": "date-time",
        "description": "A point in time in RFC 3339 format, with up to nanosecond precision. Output uses UTC (`Z`); input may use an offset from UTC."
      },
      "google.protobuf.Value": {
        "oneOf": [
          {
            "type": "null"
          },
          {
            "type": "number"
          },
          {
            "type": "string"
          },
          {
            "type": "boolean"
          },
          {
            "type": "array"
          },
          {
            "type": "object",
            "additionalProperties": true
          }
        ],
        "description": "Any JSON value: `null`, number, string, boolean, array, or object."
      },
      "spin.v1.APIKey": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          },
          "name": {
            "type": "string",
            "title": "name"
          },
          "prefix": {
            "type": "string",
            "title": "prefix",
            "description": "First 8 chars for identification"
          },
          "scopes": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "scopes"
          },
          "createdAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "created_at"
          },
          "expiresAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "expires_at"
          },
          "lastUsedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "last_used_at"
          },
          "parentId": {
            "type": "string",
            "title": "parent_id",
            "description": "The key it was delegated from, and how far down the chain (0: made by its person)."
          },
          "depth": {
            "type": "integer",
            "title": "depth",
            "format": "int32"
          },
          "teamId": {
            "type": "string",
            "title": "team_id",
            "description": "The one team it reaches; empty for every team its person is in. Of that team, the projects it\n reaches; empty for any."
          },
          "projectIds": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "project_ids"
          },
          "maxWorkspaces": {
            "type": [
              "integer",
              "null"
            ],
            "title": "max_workspaces",
            "format": "int32",
            "description": "How many of the workspaces its tree made - this key and every key delegated from it - may be\n on a runner at once, and how many cores those may hold: bounds on what runs, unset for none\n past its person's. A workspace counts while it is being made or started, runs, is stopping or\n waits for a runner. One that is stopped, suspended or in the trash counts for nothing,\n whatever disk it keeps, and is counted again when it is started: a start past the bound is\n refused as a create is, naming the workspaces that hold it."
          },
          "maxCores": {
            "type": [
              "integer",
              "null"
            ],
            "title": "max_cores",
            "format": "int32"
          }
        },
        "title": "APIKey",
        "additionalProperties": false
      },
      "spin.v1.AcceptThirdPartyTermsRequest": {
        "type": "object",
        "properties": {
          "termsVersion": {
            "type": "string",
            "title": "terms_version",
            "description": "The version of the text the administrator was shown: one that is not the current one is\n refused, so nobody accepts a text they did not read."
          },
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.ThirdPartyItem"
            },
            "title": "items"
          }
        },
        "title": "AcceptThirdPartyTermsRequest",
        "additionalProperties": false
      },
      "spin.v1.AcceptThirdPartyTermsResponse": {
        "type": "object",
        "title": "AcceptThirdPartyTermsResponse",
        "additionalProperties": false
      },
      "spin.v1.ActivateHostRequest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          }
        },
        "title": "ActivateHostRequest",
        "additionalProperties": false
      },
      "spin.v1.ActivateHostResponse": {
        "type": "object",
        "properties": {
          "host": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.Host"
              }
            ],
            "title": "host"
          }
        },
        "title": "ActivateHostResponse",
        "additionalProperties": false
      },
      "spin.v1.AddAllowedEmailRequest": {
        "type": "object",
        "properties": {
          "pattern": {
            "type": "string",
            "title": "pattern",
            "description": "Email address (user@example.com) or domain (example.com)"
          },
          "type": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.AllowedEmailType"
              }
            ],
            "title": "type"
          },
          "description": {
            "type": "string",
            "title": "description",
            "description": "Optional description"
          }
        },
        "title": "AddAllowedEmailRequest",
        "additionalProperties": false
      },
      "spin.v1.AddAllowedEmailResponse": {
        "type": "object",
        "properties": {
          "entry": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.AllowedEmail"
              }
            ],
            "title": "entry"
          }
        },
        "title": "AddAllowedEmailResponse",
        "additionalProperties": false
      },
      "spin.v1.AddSSHKeyRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "title": "name",
            "description": "Human-readable name"
          },
          "publicKey": {
            "type": "string",
            "title": "public_key",
            "description": "SSH public key content"
          },
          "stepUp": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PasskeyAssertion"
              }
            ],
            "title": "step_up"
          },
          "forSession": {
            "type": "boolean",
            "title": "for_session",
            "description": "A key enrolled for twelve hours - a browser's, a CLI's - rather than for good."
          }
        },
        "title": "AddSSHKeyRequest",
        "additionalProperties": false,
        "description": "Add user SSH key"
      },
      "spin.v1.AddSSHKeyResponse": {
        "type": "object",
        "properties": {
          "sshKey": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.SSHKey"
              }
            ],
            "title": "ssh_key"
          }
        },
        "title": "AddSSHKeyResponse",
        "additionalProperties": false
      },
      "spin.v1.AddTeamMemberRequest": {
        "type": "object",
        "properties": {
          "teamId": {
            "type": "string",
            "title": "team_id"
          },
          "email": {
            "type": "string",
            "title": "email"
          },
          "role": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.TeamRole"
              }
            ],
            "title": "role"
          }
        },
        "title": "AddTeamMemberRequest",
        "additionalProperties": false
      },
      "spin.v1.AddTeamMemberResponse": {
        "type": "object",
        "properties": {
          "member": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.TeamMember"
              }
            ],
            "title": "member"
          }
        },
        "title": "AddTeamMemberResponse",
        "additionalProperties": false
      },
      "spin.v1.AddWorkspaceGuestRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "email": {
            "type": "string",
            "title": "email"
          },
          "stepUp": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PasskeyAssertion"
              }
            ],
            "title": "step_up",
            "description": "An assertion of a passkey of the owner's over a PASSKEY_PURPOSE_ADD_GUEST challenge naming\n \"\u003cworkspace_id\u003e \u003cemail\u003e\"."
          }
        },
        "title": "AddWorkspaceGuestRequest",
        "additionalProperties": false
      },
      "spin.v1.AddWorkspaceGuestResponse": {
        "type": "object",
        "title": "AddWorkspaceGuestResponse",
        "additionalProperties": false
      },
      "spin.v1.AffectedWorkspace": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          },
          "name": {
            "type": "string",
            "title": "name"
          },
          "state": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.WorkspaceState"
              }
            ],
            "title": "state"
          }
        },
        "title": "AffectedWorkspace",
        "additionalProperties": false
      },
      "spin.v1.AgentThread": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          },
          "title": {
            "type": "string",
            "title": "title"
          },
          "project": {
            "type": "string",
            "title": "project",
            "description": "project is the directory the thread works in."
          },
          "model": {
            "type": "string",
            "title": "model"
          },
          "updatedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "updated_at"
          },
          "archived": {
            "type": "boolean",
            "title": "archived"
          }
        },
        "title": "AgentThread",
        "additionalProperties": false,
        "description": "AgentThread is one of the agent's threads as T3 Code names it: what a person is shown of a\n chat without opening it."
      },
      "spin.v1.AgentVolume": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          },
          "sizeBytes": {
            "type": "string",
            "title": "size_bytes",
            "format": "int64"
          },
          "createdAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "created_at"
          },
          "workspaceId": {
            "type": "string",
            "title": "workspace_id",
            "description": "The workspace mounting it, or empty for one no workspace mounts - which a new workspace may."
          },
          "workspaceName": {
            "type": "string",
            "title": "workspace_name",
            "description": "The name of the workspace that mounts it, or mounted it last."
          }
        },
        "title": "AgentVolume",
        "additionalProperties": false,
        "description": "AgentVolume is one agent home of the caller's."
      },
      "spin.v1.Alert": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id",
            "description": "The installation event's id."
          },
          "event": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.InstallationEventType"
              }
            ],
            "title": "event"
          },
          "name": {
            "type": "string",
            "title": "name",
            "description": "The rule's title (Grafana's alertname)."
          },
          "summary": {
            "type": "string",
            "title": "summary",
            "description": "The rule's summary, rendered for what fired; empty where it has none."
          },
          "description": {
            "type": "string",
            "title": "description"
          },
          "severity": {
            "type": "string",
            "title": "severity",
            "description": "critical, warning; empty where the rule says none."
          },
          "runbookUrl": {
            "type": "string",
            "title": "runbook_url",
            "description": "Where the dashboard's runbook for it is, as the rule names it: /admin/runbooks/\u003cid\u003e."
          },
          "labels": {
            "type": "object",
            "title": "labels",
            "additionalProperties": {
              "type": "string",
              "title": "value"
            },
            "description": "What else the alert's series is labelled with: which host, which volume."
          },
          "startsAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "starts_at",
            "description": "When it began firing, and for a resolution when it stopped."
          },
          "endsAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "ends_at"
          },
          "createdAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "created_at",
            "description": "When the control plane heard it."
          },
          "sent": {
            "type": "integer",
            "title": "sent",
            "format": "int32",
            "description": "How many administrators it was emailed to, is waiting for, and failed every attempt for."
          },
          "pending": {
            "type": "integer",
            "title": "pending",
            "format": "int32"
          },
          "failed": {
            "type": "integer",
            "title": "failed",
            "format": "int32"
          }
        },
        "title": "Alert",
        "additionalProperties": false,
        "description": "Alert is one firing or one resolution of an alert rule, as Grafana sent it."
      },
      "spin.v1.AllowedEmail": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          },
          "pattern": {
            "type": "string",
            "title": "pattern",
            "description": "Email address or domain"
          },
          "type": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.AllowedEmailType"
              }
            ],
            "title": "type"
          },
          "description": {
            "type": "string",
            "title": "description",
            "description": "Optional description"
          },
          "createdAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "created_at"
          }
        },
        "title": "AllowedEmail",
        "additionalProperties": false,
        "description": "Allowed email/domain entry"
      },
      "spin.v1.AllowedEmailType": {
        "type": "string",
        "title": "AllowedEmailType",
        "enum": [
          "ALLOWED_EMAIL_TYPE_UNSPECIFIED",
          "ALLOWED_EMAIL_TYPE_EMAIL",
          "ALLOWED_EMAIL_TYPE_DOMAIN"
        ],
        "description": "Allowed email type enum\n\n- `ALLOWED_EMAIL_TYPE_EMAIL`: Exact email address match\n- `ALLOWED_EMAIL_TYPE_DOMAIN`: Domain suffix match (@domain.com)",
        "x-enum-descriptions": [
          "",
          "Exact email address match",
          "Domain suffix match (@domain.com)"
        ]
      },
      "spin.v1.ApproveHostShellRequest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          }
        },
        "title": "ApproveHostShellRequest",
        "additionalProperties": false
      },
      "spin.v1.ApproveHostShellResponse": {
        "type": "object",
        "properties": {
          "shell": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.HostShell"
              }
            ],
            "title": "shell"
          }
        },
        "title": "ApproveHostShellResponse",
        "additionalProperties": false
      },
      "spin.v1.ApproveWorkspaceSignInRequest": {
        "type": "object",
        "properties": {
          "request": {
            "type": "string",
            "title": "request",
            "description": "From BeginWorkspaceSignInResponse.approve_url."
          }
        },
        "title": "ApproveWorkspaceSignInRequest",
        "additionalProperties": false
      },
      "spin.v1.ApproveWorkspaceSignInResponse": {
        "type": "object",
        "properties": {
          "callbackUrl": {
            "type": "string",
            "title": "callback_url",
            "description": "The workspace host's callback with the one-time code, for the browser to be sent to."
          }
        },
        "title": "ApproveWorkspaceSignInResponse",
        "additionalProperties": false
      },
      "spin.v1.AttachVSCodeServerRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "commit": {
            "type": "string",
            "title": "commit",
            "description": "commit is 40 hex digits."
          },
          "publish": {
            "type": "boolean",
            "title": "publish",
            "description": "publish tries a publish of commit again when the last one failed; without it, that\n failure is the answer. A client sets it on its first ask, and not on those that follow."
          }
        },
        "title": "AttachVSCodeServerRequest",
        "additionalProperties": false,
        "description": "AttachVSCodeServerRequest names the server a VS Code client runs: the second line of its\n `code --version`. A publish takes minutes, far past a request, so the answer is where it\n stands, and a client asks again until the server is attached."
      },
      "spin.v1.AttachVSCodeServerResponse": {
        "type": "object",
        "properties": {
          "attached": {
            "type": "boolean",
            "title": "attached",
            "description": "attached: the workspace has the server now. Otherwise it is being published, and step says\n where that is."
          },
          "step": {
            "type": "string",
            "title": "step"
          },
          "detached": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "detached",
            "description": "detached are the servers the workspace gave up to make room, asked for longest ago."
          }
        },
        "title": "AttachVSCodeServerResponse",
        "additionalProperties": false
      },
      "spin.v1.AuditEntry": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          },
          "actorId": {
            "type": "string",
            "title": "actor_id",
            "description": "actor_id is empty for an operation nobody was signed in for - a failed login, a runner\n registering itself - and for one whose user has since been deleted."
          },
          "actorEmail": {
            "type": "string",
            "title": "actor_email",
            "description": "actor_email is empty for the same reasons, and is what the user's row says now rather\n than what it said then."
          },
          "action": {
            "type": "string",
            "title": "action"
          },
          "resourceType": {
            "type": "string",
            "title": "resource_type"
          },
          "resourceId": {
            "type": "string",
            "title": "resource_id",
            "description": "resource_id is empty for an operation with no row to point at - a failed login, a\n change to the installation's settings. resource_type still says what kind of thing it\n was about."
          },
          "details": {
            "type": "string",
            "title": "details",
            "description": "details is the JSON the operation recorded, verbatim. It has no schema: what a login\n records and what a team membership change records have nothing in common, and a reader\n that insists on a shape would have to be changed by every new action."
          },
          "ipAddress": {
            "type": "string",
            "title": "ip_address"
          },
          "createdAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "created_at"
          }
        },
        "title": "AuditEntry",
        "additionalProperties": false,
        "description": "AuditEntry is one recorded operation, as it was recorded: the log is append-only and\n nothing here is derived at read time except the actor's email, which is joined so a\n reader is not handed a UUID to look up by hand."
      },
      "spin.v1.BaseImage": {
        "type": "object",
        "properties": {
          "ref": {
            "type": "string",
            "title": "ref"
          },
          "version": {
            "type": "string",
            "title": "version",
            "description": "The machine release it was taken from."
          },
          "publishedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "published_at"
          },
          "clones": {
            "type": "string",
            "title": "clones",
            "format": "int64",
            "description": "How many volumes were cloned from it: every workspace disk that began as it, and still is."
          },
          "untagged": {
            "type": "boolean",
            "title": "untagged",
            "description": "Its ref was taken off it: no new workspace gets it, the disks cloned from it go on reading it."
          },
          "given": {
            "type": "boolean",
            "title": "given",
            "description": "What a workspace that names no image is given now."
          },
          "pinned": {
            "type": "boolean",
            "title": "pinned",
            "description": "The one this control plane's release pins; given once it is published."
          },
          "volumeId": {
            "type": "string",
            "title": "volume_id",
            "description": "Its volume in the store, which RemoveStoredVolume takes when removable."
          },
          "removable": {
            "type": "boolean",
            "title": "removable",
            "description": "No disk was cloned from it and it is not the one given: RemoveStoredVolume untags it on the\n way and removes it."
          },
          "keptBecause": {
            "type": "string",
            "title": "kept_because",
            "description": "Why it stays, in words, where it may not go."
          }
        },
        "title": "BaseImage",
        "additionalProperties": false,
        "description": "BaseImage is the base image of one machine release, as published."
      },
      "spin.v1.BeginPasskeyCeremonyRequest": {
        "type": "object",
        "properties": {
          "purpose": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PasskeyPurpose"
              }
            ],
            "title": "purpose"
          },
          "subject": {
            "type": "string",
            "title": "subject"
          }
        },
        "title": "BeginPasskeyCeremonyRequest",
        "additionalProperties": false
      },
      "spin.v1.BeginPasskeyCeremonyResponse": {
        "type": "object",
        "properties": {
          "challenge": {
            "type": "string",
            "title": "challenge",
            "format": "byte"
          },
          "rpId": {
            "type": "string",
            "title": "rp_id",
            "description": "The relying party a credential is made for and asserted under: the installation's base domain."
          },
          "credentialIds": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "byte"
            },
            "title": "credential_ids",
            "description": "The caller's passkeys' credential ids, for an assertion's allowCredentials."
          }
        },
        "title": "BeginPasskeyCeremonyResponse",
        "additionalProperties": false
      },
      "spin.v1.BeginWorkspaceSignInRequest": {
        "type": "object",
        "properties": {
          "host": {
            "type": "string",
            "title": "host",
            "description": "The workspace's host the browser asked for, as the proxy received it: \u003cname\u003e.ws.\u003cdomain\u003e.\n The code comes back to this host and to no other."
          },
          "returnPath": {
            "type": "string",
            "title": "return_path",
            "description": "Where on that host the browser goes once it is signed in: a path, never a URL."
          }
        },
        "title": "BeginWorkspaceSignInRequest",
        "additionalProperties": false
      },
      "spin.v1.BeginWorkspaceSignInResponse": {
        "type": "object",
        "properties": {
          "approveUrl": {
            "type": "string",
            "title": "approve_url",
            "description": "The dashboard's page that approves this sign-in, for the browser to be sent to."
          },
          "binding": {
            "type": "string",
            "title": "binding",
            "description": "A secret for the browser that began this sign-in, kept where only the proxy reads it:\n CompleteWorkspaceSignIn requires it with the code, so a code opened in another browser -\n one somebody was sent a link to - signs nobody in."
          }
        },
        "title": "BeginWorkspaceSignInResponse",
        "additionalProperties": false
      },
      "spin.v1.BillDay": {
        "type": "object",
        "properties": {
          "day": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "day",
            "description": "The day's first instant, UTC."
          },
          "services": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.ServiceCost"
            },
            "title": "services",
            "description": "Costliest first."
          }
        },
        "title": "BillDay",
        "additionalProperties": false
      },
      "spin.v1.BrokeredRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "title": "name"
          },
          "method": {
            "type": "string",
            "title": "method"
          },
          "path": {
            "type": "string",
            "title": "path",
            "description": "As the machine sent it, without the query."
          },
          "status": {
            "type": "integer",
            "title": "status",
            "format": "int32",
            "description": "What the real host answered; what the proxy answered for a refusal."
          },
          "bytesSent": {
            "type": "string",
            "title": "bytes_sent",
            "format": "int64"
          },
          "bytesReceived": {
            "type": "string",
            "title": "bytes_received",
            "format": "int64"
          },
          "at": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "at"
          },
          "refused": {
            "type": "string",
            "title": "refused",
            "description": "Empty for a request passed on. Otherwise why the proxy refused it: credentials (a secret or\n token the team does not hold), host (a request for another name), upgrade, method (TRACE or\n TRACK), scope (a method or path the injecting rule does not allow), authority (the cloud\n principal refused to sign it)."
          },
          "principal": {
            "type": "string",
            "title": "principal",
            "description": "Who asked: \"user\" or \"agent\", by the listener the proxy read it on."
          }
        },
        "title": "BrokeredRequest",
        "additionalProperties": false,
        "description": "BrokeredRequest is one request the egress proxy read from the workspace's machine to a brokered\n name. No header and no body: what the proxy set is the team's secret, and what the machine\n sent is its own."
      },
      "spin.v1.BurstMode": {
        "type": "string",
        "title": "BurstMode",
        "enum": [
          "BURST_MODE_UNSPECIFIED",
          "BURST_MODE_FIXED",
          "BURST_MODE_TO_PRESET",
          "BURST_MODE_TO_HOST"
        ],
        "description": "BurstMode is how a workspace of a preset may grow past what it starts with.\n\n- `BURST_MODE_FIXED`: FIXED starts at the preset's size and stays there.\n- `BURST_MODE_TO_PRESET`: TO_PRESET starts at the preset's burst floor and may grow to its size.\n- `BURST_MODE_TO_HOST`: TO_HOST starts at the preset's burst floor and may grow to everything its host has.",
        "x-enum-descriptions": [
          "",
          "FIXED starts at the preset's size and stays there.",
          "TO_PRESET starts at the preset's burst floor and may grow to its size.",
          "TO_HOST starts at the preset's burst floor and may grow to everything its host has."
        ]
      },
      "spin.v1.ChangePasswordRequest": {
        "type": "object",
        "properties": {
          "currentPassword": {
            "type": "string",
            "title": "current_password"
          },
          "newPassword": {
            "type": "string",
            "title": "new_password"
          }
        },
        "title": "ChangePasswordRequest",
        "additionalProperties": false
      },
      "spin.v1.ChangePasswordResponse": {
        "type": "object",
        "title": "ChangePasswordResponse",
        "additionalProperties": false
      },
      "spin.v1.CheckDeviceLoginRequest": {
        "type": "object",
        "properties": {
          "deviceCode": {
            "type": "string",
            "title": "device_code",
            "description": "The device_code from StartDeviceLogin"
          }
        },
        "title": "CheckDeviceLoginRequest",
        "additionalProperties": false
      },
      "spin.v1.CheckDeviceLoginResponse": {
        "type": "object",
        "properties": {
          "status": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.DeviceLoginStatus"
              }
            ],
            "title": "status",
            "description": "Status of the device login"
          },
          "user": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.User"
              }
            ],
            "title": "user",
            "description": "Only set when status is DEVICE_LOGIN_STATUS_COMPLETE"
          },
          "sessionToken": {
            "type": "string",
            "title": "session_token"
          },
          "expiresAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "expires_at"
          }
        },
        "title": "CheckDeviceLoginResponse",
        "additionalProperties": false
      },
      "spin.v1.CheckPortAccessRequest": {
        "type": "object",
        "properties": {
          "workspaceName": {
            "type": "string",
            "title": "workspace_name",
            "description": "From the subdomain"
          },
          "port": {
            "type": "integer",
            "title": "port",
            "format": "int32"
          },
          "sessionToken": {
            "type": "string",
            "title": "session_token",
            "description": "The session token as the proxy received it, empty for a request with no session at all.\n Only a PUBLIC port is reachable that way."
          },
          "httpsBackend": {
            "type": "boolean",
            "title": "https_backend",
            "description": "As in OpenWorkspaceProxySessionRequest"
          }
        },
        "title": "CheckPortAccessRequest",
        "additionalProperties": false,
        "description": "Whether one request may reach one published port.\n\n This is the gate in front of a workspace's published ports, and it lives in the control\n plane rather than in the proxy because the levels only mean something if the party that\n decides also holds the facts. The proxy forwards the browser's session token and the\n control plane *validates* it - it does not take a user id the proxy asserts, which would\n make the proxy's word the credential."
      },
      "spin.v1.CheckPortAccessResponse": {
        "type": "object",
        "properties": {
          "status": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.WorkspaceProxyStatus"
              }
            ],
            "title": "status"
          },
          "allowed": {
            "type": "boolean",
            "title": "allowed"
          },
          "access": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PortAccess"
              }
            ],
            "title": "access",
            "description": "What the port's level is, so the proxy can tell a refusal that a login would fix from\n one it would not: an anonymous request to a PRIVATE port is a redirect, and a signed-in\n request to the same port is a 403 no amount of signing in changes."
          },
          "workspaceId": {
            "type": "string",
            "title": "workspace_id",
            "description": "The workspace the name was decided about, when allowed. The proxy pools connections by\n it and opens sessions for it: a name is freed by a rename and taken by someone else's\n workspace, and a connection pooled by name would carry the next request into the old one."
          },
          "sessionRefused": {
            "type": "boolean",
            "title": "session_refused",
            "description": "The session asked with is no good here: it has ended, or is another workspace's. The proxy\n drops the cookie, which would otherwise be sent and refused until it expires."
          }
        },
        "title": "CheckPortAccessResponse",
        "additionalProperties": false
      },
      "spin.v1.CheckPortPublishedRequest": {
        "type": "object",
        "properties": {
          "workspaceName": {
            "type": "string",
            "title": "workspace_name",
            "description": "From the subdomain"
          },
          "port": {
            "type": "integer",
            "title": "port",
            "format": "int32"
          },
          "httpsBackend": {
            "type": "boolean",
            "title": "https_backend",
            "description": "As in CheckPortAccessRequest: 3000s- is not 3000-"
          }
        },
        "title": "CheckPortPublishedRequest",
        "additionalProperties": false,
        "description": "Whether a certificate may be obtained for one workspace port's hostname.\n\n Not CheckPortAccess with no session: that asks whether an anonymous request may reach the\n port, and the answer is no for every PRIVATE and WHITELIST port, and for every PUBLIC one while\n the installation keeps ports closed to everybody - each of them a name with no certificate,\n and so no handshake for the owner or a grantee to sign in over. A certificate is for the name,\n so the question is whether the name is published at all."
      },
      "spin.v1.CheckPortPublishedResponse": {
        "type": "object",
        "properties": {
          "published": {
            "type": "boolean",
            "title": "published",
            "description": "The port is published on a workspace that is not deleted, at any level and in any state."
          }
        },
        "title": "CheckPortPublishedResponse",
        "additionalProperties": false
      },
      "spin.v1.ClearUserPasskeysRequest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          }
        },
        "title": "ClearUserPasskeysRequest",
        "additionalProperties": false
      },
      "spin.v1.ClearUserPasskeysResponse": {
        "type": "object",
        "properties": {
          "cleared": {
            "type": "integer",
            "title": "cleared",
            "format": "int32",
            "description": "cleared is how many passkeys the person had."
          }
        },
        "title": "ClearUserPasskeysResponse",
        "additionalProperties": false
      },
      "spin.v1.CloneWorkspaceRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "name": {
            "type": "string",
            "title": "name",
            "description": "The clone's name; generated when empty."
          }
        },
        "title": "CloneWorkspaceRequest",
        "additionalProperties": false
      },
      "spin.v1.CloneWorkspaceResponse": {
        "type": "object",
        "properties": {
          "workspace": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.Workspace"
              }
            ],
            "title": "workspace"
          },
          "snapshot": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.Snapshot"
              }
            ],
            "title": "snapshot",
            "description": "The source's snapshot the clone was made from, which stays as the clone's floor."
          }
        },
        "title": "CloneWorkspaceResponse",
        "additionalProperties": false
      },
      "spin.v1.CloseHostShellRequest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          }
        },
        "title": "CloseHostShellRequest",
        "additionalProperties": false
      },
      "spin.v1.CloseHostShellResponse": {
        "type": "object",
        "properties": {
          "shell": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.HostShell"
              }
            ],
            "title": "shell"
          }
        },
        "title": "CloseHostShellResponse",
        "additionalProperties": false
      },
      "spin.v1.CloudAccess": {
        "type": "object",
        "properties": {
          "cloud": {
            "type": "string",
            "title": "cloud",
            "description": "The cloud: \"aws\", whose principal is an IAM role's ARN and whose requests are signed with\n SigV4."
          },
          "principal": {
            "type": "string",
            "title": "principal"
          }
        },
        "title": "CloudAccess",
        "additionalProperties": false,
        "description": "CloudAccess is a principal on a cloud a brokered rule's requests are authorized as."
      },
      "spin.v1.CompleteAppCreationRequest": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "title": "code"
          },
          "state": {
            "type": "string",
            "title": "state"
          },
          "binding": {
            "type": "string",
            "title": "binding"
          }
        },
        "title": "CompleteAppCreationRequest",
        "additionalProperties": false
      },
      "spin.v1.CompleteAppCreationResponse": {
        "type": "object",
        "properties": {
          "app": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.ForgeApp"
              }
            ],
            "title": "app"
          }
        },
        "title": "CompleteAppCreationResponse",
        "additionalProperties": false
      },
      "spin.v1.CompleteConnectRequest": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "title": "code"
          },
          "state": {
            "type": "string",
            "title": "state"
          },
          "binding": {
            "type": "string",
            "title": "binding"
          }
        },
        "title": "CompleteConnectRequest",
        "additionalProperties": false
      },
      "spin.v1.CompleteConnectResponse": {
        "type": "object",
        "properties": {
          "connection": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.ForgeConnection"
              }
            ],
            "title": "connection"
          }
        },
        "title": "CompleteConnectResponse",
        "additionalProperties": false
      },
      "spin.v1.CompleteLoginRequest": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "title": "code",
            "description": "OAuth/OIDC code"
          },
          "state": {
            "type": "string",
            "title": "state",
            "description": "CSRF state token (contains provider info)"
          },
          "binding": {
            "type": "string",
            "title": "binding",
            "description": "StartLoginResponse.binding for this state"
          }
        },
        "title": "CompleteLoginRequest",
        "additionalProperties": false
      },
      "spin.v1.CompleteLoginResponse": {
        "type": "object",
        "properties": {
          "user": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.User"
              }
            ],
            "title": "user"
          },
          "sessionToken": {
            "type": "string",
            "title": "session_token"
          },
          "expiresAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "expires_at"
          }
        },
        "title": "CompleteLoginResponse",
        "additionalProperties": false
      },
      "spin.v1.CompleteSetupRequest": {
        "type": "object",
        "title": "CompleteSetupRequest",
        "additionalProperties": false
      },
      "spin.v1.CompleteSetupResponse": {
        "type": "object",
        "title": "CompleteSetupResponse",
        "additionalProperties": false
      },
      "spin.v1.CompleteWorkspaceSignInRequest": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "title": "code"
          },
          "binding": {
            "type": "string",
            "title": "binding",
            "description": "BeginWorkspaceSignInResponse.binding, as the browser presented it."
          },
          "host": {
            "type": "string",
            "title": "host",
            "description": "The host the callback arrived on, which must be the one the sign-in began on."
          }
        },
        "title": "CompleteWorkspaceSignInRequest",
        "additionalProperties": false
      },
      "spin.v1.CompleteWorkspaceSignInResponse": {
        "type": "object",
        "properties": {
          "sessionToken": {
            "type": "string",
            "title": "session_token"
          },
          "expiresAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "expires_at"
          },
          "returnPath": {
            "type": "string",
            "title": "return_path"
          }
        },
        "title": "CompleteWorkspaceSignInResponse",
        "additionalProperties": false
      },
      "spin.v1.ConfigChange": {
        "type": "object",
        "properties": {
          "kind": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.ConfigItemKind"
              }
            ],
            "title": "kind"
          },
          "name": {
            "type": "string",
            "title": "name"
          },
          "fileSays": {
            "type": "string",
            "title": "file_says",
            "description": "What the file says, as a person reads it; empty where the file no longer declares the item,\n and applying the change removes it."
          },
          "installationHas": {
            "type": "string",
            "title": "installation_has",
            "description": "What the installation has, the same way; empty where it has none."
          },
          "says": {
            "type": "string",
            "title": "says",
            "description": "The file's declaration this change is about, sent back as it came: a decision about one the\n file has changed since is refused rather than taken as about the newer one."
          },
          "since": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "since",
            "description": "When the file started saying it."
          }
        },
        "title": "ConfigChange",
        "additionalProperties": false,
        "description": "One thing the config file says differently from the installation."
      },
      "spin.v1.ConfigItemKind": {
        "type": "string",
        "title": "ConfigItemKind",
        "enum": [
          "CONFIG_ITEM_KIND_UNSPECIFIED",
          "CONFIG_ITEM_KIND_SETTING",
          "CONFIG_ITEM_KIND_EMAIL",
          "CONFIG_ITEM_KIND_PRESET",
          "CONFIG_ITEM_KIND_POLICY",
          "CONFIG_ITEM_KIND_HOST_CLASS"
        ],
        "description": "What one item of the installation's config file is.\n\n- `CONFIG_ITEM_KIND_SETTING`: A setting, by its key: registration_mode, default_network_tags, allowed_images...\n- `CONFIG_ITEM_KIND_EMAIL`: An address or domain registration admits, by itself.\n- `CONFIG_ITEM_KIND_HOST_CLASS`: A host class, by its name: the shape of a group of runners (HostClass).",
        "x-enum-descriptions": [
          "",
          "A setting, by its key: registration_mode, default_network_tags, allowed_images...",
          "An address or domain registration admits, by itself.",
          "",
          "",
          "A host class, by its name: the shape of a group of runners (HostClass)."
        ]
      },
      "spin.v1.ConfigureGitHubOAuthRequest": {
        "type": "object",
        "properties": {
          "clientId": {
            "type": "string",
            "title": "client_id"
          },
          "clientSecret": {
            "type": "string",
            "title": "client_secret"
          }
        },
        "title": "ConfigureGitHubOAuthRequest",
        "additionalProperties": false
      },
      "spin.v1.ConfigureGitHubOAuthResponse": {
        "type": "object",
        "properties": {
          "callbackUrl": {
            "type": "string",
            "title": "callback_url",
            "description": "The callback URL to configure in GitHub OAuth app settings"
          }
        },
        "title": "ConfigureGitHubOAuthResponse",
        "additionalProperties": false
      },
      "spin.v1.ConfirmDeviceLoginRequest": {
        "type": "object",
        "properties": {
          "userCode": {
            "type": "string",
            "title": "user_code",
            "description": "The user code entered by the user (e.g., \"ABCD-1234\")"
          }
        },
        "title": "ConfirmDeviceLoginRequest",
        "additionalProperties": false
      },
      "spin.v1.ConfirmDeviceLoginResponse": {
        "type": "object",
        "title": "ConfirmDeviceLoginResponse",
        "additionalProperties": false,
        "description": "Empty on success"
      },
      "spin.v1.CostEstimate": {
        "type": "object",
        "properties": {
          "day": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "day",
            "description": "The billed day the rate is from: its first instant, UTC."
          },
          "runningHourMicros": {
            "type": [
              "string",
              "null"
            ],
            "title": "running_hour_micros",
            "format": "int64",
            "description": "An hour of its machine running, for the cores and memory it holds; unset where that day billed\n no runner."
          },
          "stoppedMonthMicros": {
            "type": [
              "string",
              "null"
            ],
            "title": "stopped_month_micros",
            "format": "int64",
            "description": "A month of its disk kept while it is stopped, for the bytes it kept that day; unset where that\n day billed no volume, or the workspace was made since."
          }
        },
        "title": "CostEstimate",
        "additionalProperties": false,
        "description": "What a workspace would cost at what the last billed day charged. An estimate: that day is over\n and the next may be charged otherwise, so it is never said without the day it is from."
      },
      "spin.v1.CostMonth": {
        "type": "object",
        "properties": {
          "month": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "month",
            "description": "Its first instant, UTC."
          },
          "readAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "read_at",
            "description": "The reading its costs are from."
          },
          "currency": {
            "type": "string",
            "title": "currency",
            "description": "ISO 4217."
          },
          "totalMicros": {
            "type": "string",
            "title": "total_micros",
            "format": "int64",
            "description": "Every cost of its days; idle and unstored are parts of it."
          },
          "idleMicros": {
            "type": "string",
            "title": "idle_micros",
            "format": "int64",
            "description": "What the runners cost that no workspace held."
          },
          "unstoredMicros": {
            "type": "string",
            "title": "unstored_micros",
            "format": "int64",
            "description": "What the volumes' bucket cost for bytes no workspace keeps."
          },
          "budgetLimitMicros": {
            "type": [
              "string",
              "null"
            ],
            "title": "budget_limit_micros",
            "format": "int64",
            "description": "The installation's budget as the month's last reading in it said; unset where it had none."
          }
        },
        "title": "CostMonth",
        "additionalProperties": false,
        "description": "One month of the trend on Admin → Costs, in millionths of the bill's currency. An estimate of\n what nobody caused, from the reading it names: a month's last days are revised by the cloud\n into the next, and read again until they settle."
      },
      "spin.v1.CostShare": {
        "type": "object",
        "properties": {
          "computeMicros": {
            "type": "string",
            "title": "compute_micros",
            "format": "int64",
            "description": "Of the runners: what was held of them."
          },
          "storageMicros": {
            "type": "string",
            "title": "storage_micros",
            "format": "int64",
            "description": "Of the volumes' bucket: what the volumes kept."
          },
          "sentBytes": {
            "type": "string",
            "title": "sent_bytes",
            "format": "int64",
            "description": "What the traffic came to in the month: the machine's network out and back, and its sessions\n through the relay, both ways. Counted, not costed."
          },
          "receivedBytes": {
            "type": "string",
            "title": "received_bytes",
            "format": "int64"
          },
          "forwardedBytes": {
            "type": "string",
            "title": "forwarded_bytes",
            "format": "int64"
          }
        },
        "title": "CostShare",
        "additionalProperties": false,
        "description": "What was caused in a month of the cloud's bill, as the installation shares it out\n (AdminService.GetCosts): by one workspace, or by several summed. In millionths of the bill's\n currency. A share is of days already billed, never of this hour: the bill is read from the\n cloud a few times a day."
      },
      "spin.v1.CpuUsagePoint": {
        "type": "object",
        "properties": {
          "start": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "start"
          },
          "usedCores": {
            "type": "number",
            "title": "used_cores",
            "format": "double"
          },
          "heldCores": {
            "type": "integer",
            "title": "held_cores",
            "format": "int32"
          },
          "cpuCores": {
            "type": "integer",
            "title": "cpu_cores",
            "format": "int32"
          },
          "maxCpuCores": {
            "type": "integer",
            "title": "max_cpu_cores",
            "format": "int32"
          }
        },
        "title": "CpuUsagePoint",
        "additionalProperties": false,
        "description": "CpuUsagePoint is the cores the machine used over a step, on average, against what it held:\n held_cores attached, lent ones included; cpu_cores its own; max_cpu_cores what it may be lent."
      },
      "spin.v1.CreateAPIKeyRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "title": "name"
          },
          "scopes": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "scopes",
            "description": "e.g., [\"workspace:read\", \"workspace:write\"]"
          },
          "expiresAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "expires_at"
          },
          "stepUp": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PasskeyAssertion"
              }
            ],
            "title": "step_up",
            "description": "An assertion of a passkey of the caller's over a PASSKEY_PURPOSE_CREATE_EXEC_KEY challenge\n naming the key, asked for a key with workspace:exec alone: that key is a shell, which a session\n alone does not open."
          },
          "teamId": {
            "type": "string",
            "title": "team_id",
            "description": "What it reaches and what its tree may have running at once: as APIKey's, where what is counted\n is said. Asked by a key holding keys:delegate, it is that key's child, and holds no more than it\n (delegation.Within)."
          },
          "projectIds": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "project_ids"
          },
          "maxWorkspaces": {
            "type": [
              "integer",
              "null"
            ],
            "title": "max_workspaces",
            "format": "int32"
          },
          "maxCores": {
            "type": [
              "integer",
              "null"
            ],
            "title": "max_cores",
            "format": "int32"
          }
        },
        "title": "CreateAPIKeyRequest",
        "additionalProperties": false
      },
      "spin.v1.CreateAPIKeyResponse": {
        "type": "object",
        "properties": {
          "apiKey": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.APIKey"
              }
            ],
            "title": "api_key"
          },
          "secret": {
            "type": "string",
            "title": "secret",
            "description": "Only shown once"
          }
        },
        "title": "CreateAPIKeyResponse",
        "additionalProperties": false
      },
      "spin.v1.CreateHostClassRequest": {
        "type": "object",
        "properties": {
          "class": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.HostClass"
              }
            ],
            "title": "class"
          }
        },
        "title": "CreateHostClassRequest",
        "additionalProperties": false
      },
      "spin.v1.CreateHostClassResponse": {
        "type": "object",
        "properties": {
          "class": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.HostClass"
              }
            ],
            "title": "class"
          }
        },
        "title": "CreateHostClassResponse",
        "additionalProperties": false
      },
      "spin.v1.CreateNetworkPolicyRequest": {
        "type": "object",
        "properties": {
          "policy": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.NetworkPolicyRule"
              }
            ],
            "title": "policy"
          }
        },
        "title": "CreateNetworkPolicyRequest",
        "additionalProperties": false
      },
      "spin.v1.CreateNetworkPolicyResponse": {
        "type": "object",
        "title": "CreateNetworkPolicyResponse",
        "additionalProperties": false
      },
      "spin.v1.CreateProjectRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "title": "name"
          },
          "slug": {
            "type": "string",
            "title": "slug",
            "description": "Made from the name when empty"
          },
          "description": {
            "type": "string",
            "title": "description"
          },
          "repository": {
            "type": "string",
            "title": "repository"
          },
          "ref": {
            "type": "string",
            "title": "ref"
          },
          "image": {
            "type": "string",
            "title": "image"
          },
          "preset": {
            "type": "string",
            "title": "preset"
          },
          "networkTags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "network_tags"
          },
          "prebuildRefs": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "prebuild_refs"
          },
          "prebuildRebaseEvery": {
            "type": "integer",
            "title": "prebuild_rebase_every",
            "format": "int32",
            "description": "Zero is the installation's default"
          },
          "prebuildKeep": {
            "type": "integer",
            "title": "prebuild_keep",
            "format": "int32",
            "description": "Zero is one: the newest of each ref"
          }
        },
        "title": "CreateProjectRequest",
        "additionalProperties": false
      },
      "spin.v1.CreateProjectResponse": {
        "type": "object",
        "properties": {
          "project": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.Project"
              }
            ],
            "title": "project"
          }
        },
        "title": "CreateProjectResponse",
        "additionalProperties": false
      },
      "spin.v1.CreateRegistrationTokenRequest": {
        "type": "object",
        "properties": {
          "description": {
            "type": "string",
            "title": "description",
            "description": "e.g., \"Runner for host-us-east-1\""
          },
          "teamId": {
            "type": "string",
            "title": "team_id",
            "description": "Optional: scope to team (host joins team's pool)"
          },
          "expiresAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "expires_at",
            "description": "Default: 24h"
          },
          "reusable": {
            "type": "boolean",
            "title": "reusable",
            "description": "A pool's token, for an autoscaling group whose machines register with nobody at them: it\n is not spent by the host it registers. Short-lived and rotated is the intended use."
          },
          "hostPolicy": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.HostPolicy"
              }
            ],
            "title": "host_policy",
            "description": "The policy each host it registers starts with, under SetHostPolicy's rules; host_id must\n be empty, since the hosts do not exist yet."
          }
        },
        "title": "CreateRegistrationTokenRequest",
        "additionalProperties": false,
        "description": "Admin: Create registration token"
      },
      "spin.v1.CreateRegistrationTokenResponse": {
        "type": "object",
        "properties": {
          "tokenInfo": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.RegistrationToken"
              }
            ],
            "title": "token_info"
          },
          "token": {
            "type": "string",
            "title": "token",
            "description": "Full token, shown only once"
          }
        },
        "title": "CreateRegistrationTokenResponse",
        "additionalProperties": false
      },
      "spin.v1.CreateResourcePresetRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "title": "name",
            "description": "Required: display name"
          },
          "description": {
            "type": "string",
            "title": "description",
            "description": "Optional: description"
          },
          "cpuCores": {
            "type": "integer",
            "title": "cpu_cores",
            "format": "int32",
            "description": "Required: CPU cores"
          },
          "memoryMb": {
            "type": "integer",
            "title": "memory_mb",
            "format": "int32",
            "description": "Required: memory in MB"
          },
          "diskGb": {
            "type": "integer",
            "title": "disk_gb",
            "format": "int32",
            "description": "Required: disk in GB"
          },
          "burst": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.BurstMode"
              }
            ],
            "title": "burst",
            "description": "Required"
          },
          "isDefault": {
            "type": "boolean",
            "title": "is_default",
            "description": "Optional: make this the default"
          },
          "enabled": {
            "type": "boolean",
            "title": "enabled",
            "description": "Optional: enable the preset (default true)"
          },
          "sortOrder": {
            "type": "integer",
            "title": "sort_order",
            "format": "int32",
            "description": "Optional: display order"
          },
          "burstFloorCpuCores": {
            "type": "integer",
            "title": "burst_floor_cpu_cores",
            "format": "int32",
            "description": "Required for a burst mode: what its workspaces start with, at most the preset's size."
          },
          "burstFloorMemoryMb": {
            "type": "integer",
            "title": "burst_floor_memory_mb",
            "format": "int32"
          },
          "bandwidthMbps": {
            "type": [
              "integer",
              "null"
            ],
            "title": "bandwidth_mbps",
            "format": "int32",
            "description": "What a workspace of it may carry each way, in megabits a second. Present, since 0 - unshaped -\n is an answer; absent, the installation's default."
          },
          "rpoSeconds": {
            "type": "integer",
            "title": "rpo_seconds",
            "format": "int32",
            "description": "How far behind the object store a workspace of it may fall, in seconds; 0 is the\n installation's."
          },
          "hostClass": {
            "type": "string",
            "title": "host_class",
            "description": "The host class its workspaces run on; empty is the default."
          }
        },
        "title": "CreateResourcePresetRequest",
        "additionalProperties": false
      },
      "spin.v1.CreateResourcePresetResponse": {
        "type": "object",
        "properties": {
          "preset": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.ResourcePreset"
              }
            ],
            "title": "preset"
          }
        },
        "title": "CreateResourcePresetResponse",
        "additionalProperties": false
      },
      "spin.v1.CreateSnapshotRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "description": {
            "type": "string",
            "title": "description",
            "description": "Optional description"
          },
          "withMemory": {
            "type": "boolean",
            "title": "with_memory",
            "description": "with_memory keeps the machine's memory too, taken at the instant the disk is sealed; the\n guest is paused for tens of milliseconds, and the call returns once the memory is written."
          }
        },
        "title": "CreateSnapshotRequest",
        "additionalProperties": false
      },
      "spin.v1.CreateSnapshotResponse": {
        "type": "object",
        "properties": {
          "snapshot": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.Snapshot"
              }
            ],
            "title": "snapshot"
          }
        },
        "title": "CreateSnapshotResponse",
        "additionalProperties": false
      },
      "spin.v1.CreateTeamIdentityProviderRequest": {
        "type": "object",
        "properties": {
          "teamId": {
            "type": "string",
            "title": "team_id",
            "description": "Optional: team-specific IdP (empty = system-wide)"
          },
          "name": {
            "type": "string",
            "title": "name"
          },
          "providerType": {
            "type": "string",
            "title": "provider_type",
            "description": "oidc, github, google, azure-ad"
          },
          "issuerUrl": {
            "type": "string",
            "title": "issuer_url",
            "description": "For OIDC discovery"
          },
          "clientId": {
            "type": "string",
            "title": "client_id"
          },
          "clientSecret": {
            "type": "string",
            "title": "client_secret"
          },
          "scopes": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "scopes"
          },
          "autoJoinCelExpression": {
            "type": "string",
            "title": "auto_join_cel_expression",
            "description": "Optional: auto-add users matching this"
          },
          "roleCelExpression": {
            "type": "string",
            "title": "role_cel_expression",
            "description": "Optional: determine role from claims"
          }
        },
        "title": "CreateTeamIdentityProviderRequest",
        "additionalProperties": false
      },
      "spin.v1.CreateTeamIdentityProviderResponse": {
        "type": "object",
        "properties": {
          "provider": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.TeamIdentityProvider"
              }
            ],
            "title": "provider"
          }
        },
        "title": "CreateTeamIdentityProviderResponse",
        "additionalProperties": false
      },
      "spin.v1.CreateTeamRequest": {
        "type": "object",
        "properties": {
          "parentId": {
            "type": "string",
            "title": "parent_id",
            "description": "Optional: parent team ID (empty = root team)"
          },
          "name": {
            "type": "string",
            "title": "name"
          },
          "slug": {
            "type": "string",
            "title": "slug",
            "description": "Optional, generated from name if empty"
          },
          "description": {
            "type": "string",
            "title": "description"
          },
          "displayName": {
            "type": "string",
            "title": "display_name",
            "description": "Optional: human-friendly name"
          }
        },
        "title": "CreateTeamRequest",
        "additionalProperties": false,
        "description": "Team CRUD"
      },
      "spin.v1.CreateTeamResponse": {
        "type": "object",
        "properties": {
          "team": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.Team"
              }
            ],
            "title": "team"
          }
        },
        "title": "CreateTeamResponse",
        "additionalProperties": false
      },
      "spin.v1.CreateWorkspaceRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "title": "name",
            "description": "Optional, generated if empty"
          },
          "teamId": {
            "type": "string",
            "title": "team_id",
            "description": "Optional: team ID (personal workspace if empty)"
          },
          "image": {
            "type": "string",
            "title": "image",
            "description": "A published image (ListImages); required unless from_snapshot_id is set"
          },
          "preset": {
            "type": "string",
            "title": "preset",
            "description": "The preset it is sized by, by name (AdminService.ListResourcePresets): its cores, memory,\n disk and how it grows. Empty is the project's preset when project_id names one, otherwise\n the installation's default preset, or with none marked 1 core, 2048 MB and 10 GB free. A\n disabled preset is refused."
          },
          "env": {
            "type": "object",
            "title": "env",
            "additionalProperties": {
              "type": "string",
              "title": "value"
            },
            "description": "Environment variables"
          },
          "fromSnapshotId": {
            "type": "string",
            "title": "from_snapshot_id",
            "description": "Create workspace from a shared snapshot"
          },
          "networkTags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "network_tags",
            "description": "network_tags are the network policies this workspace runs under, by name - the same\n idea as a GCP instance's network tags. The host's ruleset names the tag and holds the\n set of machines carrying it, so this decides which rules apply without naming a rule.\n\n Empty runs the workspace under the installation's default, and under \"offline\" where it\n declares none: a create that names nothing reaches nothing, rather than everything.\n A tag the host has no policy for fails the start rather than being ignored: a workspace\n asking for a policy the node does not have is a question with two answers, and quietly\n choosing \"run it without\" is how one ends up less contained than whoever launched it\n believes."
          },
          "projectId": {
            "type": "string",
            "title": "project_id",
            "description": "A project the caller sees: the workspace is the project's - its image and tags, which the\n request then names neither of, and its preset unless preset names another - in team_id, the\n caller's personal team when empty, and its\n guest clones the project's repository at ref, the project's own when empty. Refused while the\n repository is on a forge the installation connects to (ForgeService) and the caller has not\n connected their account there."
          },
          "ref": {
            "type": "string",
            "title": "ref"
          },
          "requestId": {
            "type": "string",
            "title": "request_id",
            "description": "Optional, at most 128 bytes: the client's key for this create, so a retry after an answer\n it never got is answered with the workspace the first attempt made. The same key with\n another request is refused (FAILED_PRECONDITION)."
          },
          "agentVolumeId": {
            "type": "string",
            "title": "agent_volume_id",
            "description": "Optional: an agent's home of the caller's to mount (ListAgentVolumes), one no workspace\n mounts now - the history of a workspace since erased, found again in this one. Empty makes\n the workspace a new one. Refused while no host has room: a workspace that waits for a host\n gets its new home when it is placed, and mounts none it was named."
          }
        },
        "title": "CreateWorkspaceRequest",
        "additionalProperties": false
      },
      "spin.v1.CreateWorkspaceResponse": {
        "type": "object",
        "properties": {
          "workspace": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.Workspace"
              }
            ],
            "title": "workspace"
          }
        },
        "title": "CreateWorkspaceResponse",
        "additionalProperties": false
      },
      "spin.v1.DecideConfigChangeRequest": {
        "type": "object",
        "properties": {
          "kind": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.ConfigItemKind"
              }
            ],
            "title": "kind"
          },
          "name": {
            "type": "string",
            "title": "name"
          },
          "says": {
            "type": "string",
            "title": "says",
            "description": "ConfigChange.says, as listed."
          },
          "apply": {
            "type": "boolean",
            "title": "apply",
            "description": "True writes what the file says; false keeps what the installation has."
          }
        },
        "title": "DecideConfigChangeRequest",
        "additionalProperties": false
      },
      "spin.v1.DecideConfigChangeResponse": {
        "type": "object",
        "title": "DecideConfigChangeResponse",
        "additionalProperties": false
      },
      "spin.v1.DeleteAgentVolumeRequest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          }
        },
        "title": "DeleteAgentVolumeRequest",
        "additionalProperties": false
      },
      "spin.v1.DeleteAgentVolumeResponse": {
        "type": "object",
        "title": "DeleteAgentVolumeResponse",
        "additionalProperties": false
      },
      "spin.v1.DeleteForgeAppRequest": {
        "type": "object",
        "properties": {
          "forge": {
            "type": "string",
            "title": "forge"
          }
        },
        "title": "DeleteForgeAppRequest",
        "additionalProperties": false
      },
      "spin.v1.DeleteForgeAppResponse": {
        "type": "object",
        "title": "DeleteForgeAppResponse",
        "additionalProperties": false
      },
      "spin.v1.DeleteHostClassRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "title": "name"
          }
        },
        "title": "DeleteHostClassRequest",
        "additionalProperties": false,
        "description": "Refused while a preset or a workspace not deleted runs on it, and for the default. Its group is\n emptied and taken away by the autoscaler."
      },
      "spin.v1.DeleteHostClassResponse": {
        "type": "object",
        "title": "DeleteHostClassResponse",
        "additionalProperties": false
      },
      "spin.v1.DeleteNetworkPolicyRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "title": "name"
          }
        },
        "title": "DeleteNetworkPolicyRequest",
        "additionalProperties": false
      },
      "spin.v1.DeleteNetworkPolicyResponse": {
        "type": "object",
        "title": "DeleteNetworkPolicyResponse",
        "additionalProperties": false
      },
      "spin.v1.DeletePasskeyRequest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          },
          "stepUp": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PasskeyAssertion"
              }
            ],
            "title": "step_up"
          }
        },
        "title": "DeletePasskeyRequest",
        "additionalProperties": false
      },
      "spin.v1.DeletePasskeyResponse": {
        "type": "object",
        "title": "DeletePasskeyResponse",
        "additionalProperties": false
      },
      "spin.v1.DeleteProjectRequest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          }
        },
        "title": "DeleteProjectRequest",
        "additionalProperties": false
      },
      "spin.v1.DeleteProjectResponse": {
        "type": "object",
        "title": "DeleteProjectResponse",
        "additionalProperties": false
      },
      "spin.v1.DeleteResourcePresetRequest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id",
            "description": "Required: preset ID to delete"
          }
        },
        "title": "DeleteResourcePresetRequest",
        "additionalProperties": false
      },
      "spin.v1.DeleteResourcePresetResponse": {
        "type": "object",
        "title": "DeleteResourcePresetResponse",
        "additionalProperties": false
      },
      "spin.v1.DeleteSSHKeyRequest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          }
        },
        "title": "DeleteSSHKeyRequest",
        "additionalProperties": false,
        "description": "Delete user SSH key"
      },
      "spin.v1.DeleteSSHKeyResponse": {
        "type": "object",
        "title": "DeleteSSHKeyResponse",
        "additionalProperties": false
      },
      "spin.v1.DeleteSnapshotRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "snapshotId": {
            "type": "string",
            "title": "snapshot_id"
          }
        },
        "title": "DeleteSnapshotRequest",
        "additionalProperties": false
      },
      "spin.v1.DeleteSnapshotResponse": {
        "type": "object",
        "title": "DeleteSnapshotResponse",
        "additionalProperties": false
      },
      "spin.v1.DeleteTeamIdentityProviderRequest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          }
        },
        "title": "DeleteTeamIdentityProviderRequest",
        "additionalProperties": false
      },
      "spin.v1.DeleteTeamIdentityProviderResponse": {
        "type": "object",
        "title": "DeleteTeamIdentityProviderResponse",
        "additionalProperties": false
      },
      "spin.v1.DeleteTeamNetworkPolicyRequest": {
        "type": "object",
        "properties": {
          "teamId": {
            "type": "string",
            "title": "team_id"
          },
          "name": {
            "type": "string",
            "title": "name"
          }
        },
        "title": "DeleteTeamNetworkPolicyRequest",
        "additionalProperties": false
      },
      "spin.v1.DeleteTeamNetworkPolicyResponse": {
        "type": "object",
        "title": "DeleteTeamNetworkPolicyResponse",
        "additionalProperties": false
      },
      "spin.v1.DeleteTeamRequest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          },
          "recursive": {
            "type": "boolean",
            "title": "recursive",
            "description": "If true, delete children too (dangerous!)"
          }
        },
        "title": "DeleteTeamRequest",
        "additionalProperties": false
      },
      "spin.v1.DeleteTeamResponse": {
        "type": "object",
        "title": "DeleteTeamResponse",
        "additionalProperties": false
      },
      "spin.v1.DeleteTeamSecretRequest": {
        "type": "object",
        "properties": {
          "teamId": {
            "type": "string",
            "title": "team_id"
          },
          "name": {
            "type": "string",
            "title": "name"
          }
        },
        "title": "DeleteTeamSecretRequest",
        "additionalProperties": false
      },
      "spin.v1.DeleteTeamSecretResponse": {
        "type": "object",
        "title": "DeleteTeamSecretResponse",
        "additionalProperties": false
      },
      "spin.v1.DeleteWorkspaceRequest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          },
          "force": {
            "type": "boolean",
            "title": "force",
            "description": "Force delete regardless of state (skips state validation)"
          },
          "permanently": {
            "type": "boolean",
            "title": "permanently",
            "description": "permanently erases the workspace now - its disk, snapshots and keys - rather than putting it\n in the trash; a workspace already in the trash is erased only this way. What is erased\n cannot be undeleted: the store expires its bytes when its retention ends."
          }
        },
        "title": "DeleteWorkspaceRequest",
        "additionalProperties": false
      },
      "spin.v1.DeleteWorkspaceResponse": {
        "type": "object",
        "properties": {
          "trashedUntil": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "trashed_until",
            "description": "Until when it can be undeleted; unset when it was erased."
          }
        },
        "title": "DeleteWorkspaceResponse",
        "additionalProperties": false
      },
      "spin.v1.DeletedWorkspace": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          },
          "name": {
            "type": "string",
            "title": "name",
            "description": "The name it had; another workspace may have taken it since, and an undelete then gives it\n another."
          },
          "deletedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "deleted_at"
          },
          "trashedUntil": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "trashed_until"
          },
          "agentVolumeId": {
            "type": "string",
            "title": "agent_volume_id",
            "description": "The agent's home it mounts, which its erase keeps for another workspace (ListAgentVolumes);\n empty for a workspace with none."
          }
        },
        "title": "DeletedWorkspace",
        "additionalProperties": false,
        "description": "DeletedWorkspace is a workspace in the trash."
      },
      "spin.v1.DeletionEffect": {
        "type": "object",
        "properties": {
          "fate": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.DeletionFate"
              }
            ],
            "title": "fate"
          },
          "what": {
            "type": "string",
            "title": "what",
            "description": "What it is: \"Its disk\", \"2 snapshots\"."
          },
          "detail": {
            "type": "string",
            "title": "detail",
            "description": "What happens to it and what follows from that, one sentence."
          }
        },
        "title": "DeletionEffect",
        "additionalProperties": false,
        "description": "DeletionEffect is one thing a workspace has and what a delete does to it, in words its owner\n reads before confirming."
      },
      "spin.v1.DeletionFate": {
        "type": "string",
        "title": "DeletionFate",
        "enum": [
          "DELETION_FATE_UNSPECIFIED",
          "DELETION_FATE_ERASED",
          "DELETION_FATE_TRASHED",
          "DELETION_FATE_KEPT"
        ],
        "description": "DeletionFate is what a delete does to one thing a workspace has.\n\n- `DELETION_FATE_ERASED`: Gone when the delete is done, and not undeleted.\n- `DELETION_FATE_TRASHED`: In the trash for GetWorkspaceDeletionResponse.trash_days, restored by an undelete, erased\n  when they are up.\n- `DELETION_FATE_KEPT`: Outlives the workspace, the trash's days included.",
        "x-enum-descriptions": [
          "",
          "Gone when the delete is done, and not undeleted.",
          "In the trash for GetWorkspaceDeletionResponse.trash_days, restored by an undelete, erased\n when they are up.",
          "Outlives the workspace, the trash's days included."
        ]
      },
      "spin.v1.DepartureFate": {
        "type": "string",
        "title": "DepartureFate",
        "enum": [
          "DEPARTURE_FATE_UNSPECIFIED",
          "DEPARTURE_FATE_MOVES",
          "DEPARTURE_FATE_STAYS",
          "DEPARTURE_FATE_LOSES_PLACE",
          "DEPARTURE_FATE_HOLDS",
          "DEPARTURE_FATE_STOPS"
        ],
        "description": "DepartureFate is what taking a host out does to one workspace on it.\n\n- `DEPARTURE_FATE_MOVES`: Suspended with its memory and resumed on another runner with room.\n- `DEPARTURE_FATE_STAYS`: Keeps its place on this runner: a drain moves only what runs.\n- `DEPARTURE_FATE_LOSES_PLACE`: Suspended at a published snapshot: its disk is let go of here, and its next start is on\n  another runner, from what it published.\n- `DEPARTURE_FATE_HOLDS`: It keeps the host: the removal is refused while it is here. A group's machine is held by a\n  disk only here, until it is stopped, which publishes it, or moved; a revoked host by any\n  workspace that names it.\n- `DEPARTURE_FATE_STOPS`: Its disk is only here and is left here: it runs again only once recovered onto another\n  runner, giving up what this one had not published.",
        "x-enum-descriptions": [
          "",
          "Suspended with its memory and resumed on another runner with room.",
          "Keeps its place on this runner: a drain moves only what runs.",
          "Suspended at a published snapshot: its disk is let go of here, and its next start is on\n another runner, from what it published.",
          "It keeps the host: the removal is refused while it is here. A group's machine is held by a\n disk only here, until it is stopped, which publishes it, or moved; a revoked host by any\n workspace that names it.",
          "Its disk is only here and is left here: it runs again only once recovered onto another\n runner, giving up what this one had not published."
        ]
      },
      "spin.v1.DeviceLoginStatus": {
        "type": "string",
        "title": "DeviceLoginStatus",
        "enum": [
          "DEVICE_LOGIN_STATUS_UNSPECIFIED",
          "DEVICE_LOGIN_STATUS_PENDING",
          "DEVICE_LOGIN_STATUS_COMPLETE",
          "DEVICE_LOGIN_STATUS_EXPIRED",
          "DEVICE_LOGIN_STATUS_DENIED"
        ],
        "description": "- `DEVICE_LOGIN_STATUS_PENDING`: User hasn't completed login yet\n- `DEVICE_LOGIN_STATUS_COMPLETE`: Login complete, token available\n- `DEVICE_LOGIN_STATUS_EXPIRED`: Device code expired\n- `DEVICE_LOGIN_STATUS_DENIED`: User denied the request",
        "x-enum-descriptions": [
          "",
          "User hasn't completed login yet",
          "Login complete, token available",
          "Device code expired",
          "User denied the request"
        ]
      },
      "spin.v1.DiffSnapshotsRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "fromSnapshotId": {
            "type": "string",
            "title": "from_snapshot_id",
            "description": "Empty compares from what the workspace was created from."
          },
          "toSnapshotId": {
            "type": "string",
            "title": "to_snapshot_id"
          },
          "under": {
            "type": "string",
            "title": "under",
            "description": "under narrows the comparison to one path of the filesystem, from its root; empty is all of\n it. The walk starts there rather than filtering, so what is outside it costs nothing and\n does not fill the answer."
          }
        },
        "title": "DiffSnapshotsRequest",
        "additionalProperties": false,
        "description": "DiffSnapshotsRequest names two published snapshots of one workspace. The comparison runs in a\n machine of its own on a host of the control plane's choosing; the workspace need not be\n running, or on any host."
      },
      "spin.v1.DiffSnapshotsResponse": {
        "type": "object",
        "properties": {
          "changes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.FileChange"
            },
            "title": "changes",
            "description": "Every change from one snapshot to the other, a directory before what is under it."
          },
          "truncated": {
            "type": "boolean",
            "title": "truncated",
            "description": "truncated says there are more changes than one answer carries."
          }
        },
        "title": "DiffSnapshotsResponse",
        "additionalProperties": false
      },
      "spin.v1.DisableBootstrapAdminRequest": {
        "type": "object",
        "title": "DisableBootstrapAdminRequest",
        "additionalProperties": false
      },
      "spin.v1.DisableBootstrapAdminResponse": {
        "type": "object",
        "title": "DisableBootstrapAdminResponse",
        "additionalProperties": false
      },
      "spin.v1.DisconnectRequest": {
        "type": "object",
        "properties": {
          "forge": {
            "type": "string",
            "title": "forge"
          }
        },
        "title": "DisconnectRequest",
        "additionalProperties": false
      },
      "spin.v1.DisconnectResponse": {
        "type": "object",
        "title": "DisconnectResponse",
        "additionalProperties": false
      },
      "spin.v1.DotfilesConfig": {
        "type": "object",
        "properties": {
          "repo": {
            "type": "string",
            "title": "repo",
            "description": "Git URL: https://github.com/user/dotfiles"
          },
          "branch": {
            "type": "string",
            "title": "branch",
            "description": "Branch to clone (default: main)"
          },
          "installCommand": {
            "type": "string",
            "title": "install_command",
            "description": "Command to run after clone (default: ./install.sh)"
          }
        },
        "title": "DotfilesConfig",
        "additionalProperties": false
      },
      "spin.v1.DrainHostRequest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          },
          "suspend": {
            "type": "boolean",
            "title": "suspend",
            "description": "Suspend every running workspace off the host: its memory and disk go to the object store,\n and it is resumed on whichever other host has room, on its own - or, suspended without its\n memory, on its owner's next start. Answered once each is suspended or has failed to be; a\n workspace that failed runs on as it was."
          },
          "leaveStopped": {
            "type": "boolean",
            "title": "leave_stopped",
            "description": "leave_stopped is for a drain that shrinks the fleet: the workspaces it suspends stay stopped,\n and each resumes on another host when its owner starts it. Without it they are resumed\n elsewhere at once, waiting for a host where the installation is bringing one up."
          }
        },
        "title": "DrainHostRequest",
        "additionalProperties": false
      },
      "spin.v1.DrainHostResponse": {
        "type": "object",
        "properties": {
          "host": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.Host"
              }
            ],
            "title": "host"
          },
          "suspendedWorkspaceIds": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "suspended_workspace_ids"
          },
          "failures": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.WorkspaceSuspendFailure"
            },
            "title": "failures"
          }
        },
        "title": "DrainHostResponse",
        "additionalProperties": false
      },
      "spin.v1.EmailSettings": {
        "type": "object",
        "properties": {
          "host": {
            "type": "string",
            "title": "host"
          },
          "port": {
            "type": "integer",
            "title": "port",
            "format": "int32",
            "description": "465 is TLS from the first byte; any other port is upgraded with STARTTLS where the server\n offers it, and a username is refused over a connection that is not encrypted."
          },
          "username": {
            "type": "string",
            "title": "username"
          },
          "passwordSet": {
            "type": "boolean",
            "title": "password_set"
          },
          "from": {
            "type": "string",
            "title": "from",
            "description": "The address mail is sent from, as the server allows this account to send."
          }
        },
        "title": "EmailSettings",
        "additionalProperties": false,
        "description": "EmailSettings is the SMTP server the installation sends its notifications through. No host is\n email off: what would have been sent is still recorded, and shown on each person's page."
      },
      "spin.v1.EnableDevModeRequest": {
        "type": "object",
        "title": "EnableDevModeRequest",
        "additionalProperties": false
      },
      "spin.v1.EnableDevModeResponse": {
        "type": "object",
        "title": "EnableDevModeResponse",
        "additionalProperties": false
      },
      "spin.v1.ExchangeWorkloadTokenRequest": {
        "type": "object",
        "properties": {
          "token": {
            "type": "string",
            "title": "token",
            "description": "A JWT-SVID the workspace's Workload API issued for the control plane's audience."
          }
        },
        "title": "ExchangeWorkloadTokenRequest",
        "additionalProperties": false
      },
      "spin.v1.ExchangeWorkloadTokenResponse": {
        "type": "object",
        "properties": {
          "apiKey": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.APIKey"
              }
            ],
            "title": "api_key"
          },
          "secret": {
            "type": "string",
            "title": "secret",
            "description": "Only shown once"
          }
        },
        "title": "ExchangeWorkloadTokenResponse",
        "additionalProperties": false
      },
      "spin.v1.ExecRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "command": {
            "type": "string",
            "title": "command",
            "description": "command is a line for the workspace's shell, as `ssh \u003cworkspace\u003e \u003ccommand\u003e` takes one."
          },
          "stdin": {
            "type": "string",
            "title": "stdin",
            "format": "byte"
          },
          "timeout": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Duration"
              }
            ],
            "title": "timeout",
            "description": "timeout bounds the command, past which it is ended and answered as timed out; unset is a\n minute, and more than ten is refused."
          }
        },
        "title": "ExecRequest",
        "additionalProperties": false
      },
      "spin.v1.ExecResponse": {
        "type": "object",
        "properties": {
          "exitCode": {
            "type": "integer",
            "title": "exit_code",
            "format": "int32",
            "description": "exit_code is the command's exit status; -1 when it ended on a signal or was ended for its\n timeout."
          },
          "stdout": {
            "type": "string",
            "title": "stdout",
            "format": "byte"
          },
          "stderr": {
            "type": "string",
            "title": "stderr",
            "format": "byte"
          },
          "truncated": {
            "type": "boolean",
            "title": "truncated",
            "description": "truncated says stdout or stderr ran past the bound kept of each, and the rest is not here."
          },
          "timedOut": {
            "type": "boolean",
            "title": "timed_out",
            "description": "timed_out says the command was ended for its timeout."
          }
        },
        "title": "ExecResponse",
        "additionalProperties": false
      },
      "spin.v1.ExplainStorageKeyRequest": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string",
            "title": "key"
          }
        },
        "title": "ExplainStorageKeyRequest",
        "additionalProperties": false
      },
      "spin.v1.ExplainStorageKeyResponse": {
        "type": "object",
        "properties": {
          "what": {
            "type": "string",
            "title": "what",
            "description": "What the object is, in words."
          },
          "volume": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.StoredVolume"
              }
            ],
            "title": "volume",
            "description": "Whose it is, when it is a volume's."
          }
        },
        "title": "ExplainStorageKeyResponse",
        "additionalProperties": false
      },
      "spin.v1.ExposePortRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "port": {
            "type": "integer",
            "title": "port",
            "format": "int32"
          },
          "httpsBackend": {
            "type": "boolean",
            "title": "https_backend",
            "description": "See ExposedPort.https_backend"
          },
          "description": {
            "type": "string",
            "title": "description"
          },
          "access": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PortAccess"
              }
            ],
            "title": "access",
            "description": "Left unset, this is PRIVATE. Exposing a port is not the same as publishing it."
          }
        },
        "title": "ExposePortRequest",
        "additionalProperties": false
      },
      "spin.v1.ExposePortResponse": {
        "type": "object",
        "properties": {
          "exposedPort": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.ExposedPort"
              }
            ],
            "title": "exposed_port"
          }
        },
        "title": "ExposePortResponse",
        "additionalProperties": false
      },
      "spin.v1.ExposedPort": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          },
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "port": {
            "type": "integer",
            "title": "port",
            "format": "int32"
          },
          "httpsBackend": {
            "type": "boolean",
            "title": "https_backend",
            "description": "The proxy speaks TLS to this port without verifying its certificate, and only under the\n {port}s- hostname: 3000-ws and 3000s-ws are different names, and one refuses."
          },
          "description": {
            "type": "string",
            "title": "description"
          },
          "createdAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "created_at"
          },
          "url": {
            "type": "string",
            "title": "url",
            "description": "Output only: computed URL (e.g., https://3000-dev.ws.spinbox.dev)"
          },
          "access": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PortAccess"
              }
            ],
            "title": "access"
          },
          "grants": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.PortGrant"
            },
            "title": "grants",
            "description": "Who this port is granted to, when access is WHITELIST. Output only, and populated only\n for the workspace's owner - who a port is shared with is the owner's business and not\n the grantees'."
          }
        },
        "title": "ExposedPort",
        "additionalProperties": false
      },
      "spin.v1.ExtensionRelease": {
        "type": "object",
        "properties": {
          "version": {
            "type": "string",
            "title": "version",
            "description": "The release's own name: the control plane's version for the supervisor; for the VS Code\n servers, the versions it carries joined with +, unless it was named otherwise."
          },
          "releasedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "released_at"
          },
          "newest": {
            "type": "boolean",
            "title": "newest",
            "description": "Whether a start is given this one."
          },
          "volumeId": {
            "type": "string",
            "title": "volume_id",
            "description": "Its volume in the store, which RemoveStoredVolume takes when removable."
          },
          "removable": {
            "type": "boolean",
            "title": "removable",
            "description": "Not the newest, and open in no machine and no suspended memory: RemoveStoredVolume removes\n it, and so does the collect-releases job on its own. A release only stopped workspaces last\n ran is removable, since their next start is given the newest."
          },
          "keptBecause": {
            "type": "string",
            "title": "kept_because",
            "description": "Why it stays, in words, where it may not go: how many machines and suspended memories have\n it open, or that it is the newest."
          }
        },
        "title": "ExtensionRelease",
        "additionalProperties": false,
        "description": "ExtensionRelease is one release of an extension: the supervisor, or the VS Code servers."
      },
      "spin.v1.ExtensionVersion": {
        "type": "object",
        "properties": {
          "extension": {
            "type": "string",
            "title": "extension"
          },
          "version": {
            "type": "string",
            "title": "version"
          },
          "workspaces": {
            "type": "string",
            "title": "workspaces",
            "format": "int64",
            "description": "The machines that have it open and the suspended memories that do: a stopped workspace is\n given the newest at its next start, and is on none."
          },
          "newest": {
            "type": "boolean",
            "title": "newest",
            "description": "Whether a start now would choose this release."
          }
        },
        "title": "ExtensionVersion",
        "additionalProperties": false,
        "description": "ExtensionVersion is a release and how many workspaces are on it: what an update leaves\n behind until each workspace is next started."
      },
      "spin.v1.FieldValue": {
        "type": "object",
        "properties": {
          "value": {
            "type": "string",
            "title": "value"
          },
          "count": {
            "type": "string",
            "title": "count",
            "format": "int64"
          }
        },
        "title": "FieldValue",
        "additionalProperties": false,
        "description": "FieldValue is one value a field has, and how many of a search's records have it."
      },
      "spin.v1.FileChange": {
        "type": "object",
        "properties": {
          "path": {
            "type": "string",
            "title": "path",
            "description": "From the filesystem's root, with a leading slash. A name holding bytes that are not UTF-8\n has them replaced here, and path_bytes holds the name as it is."
          },
          "pathBytes": {
            "type": "string",
            "title": "path_bytes",
            "format": "byte"
          },
          "kind": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.FileChangeKind"
              }
            ],
            "title": "kind"
          },
          "from": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.FileState"
              }
            ],
            "title": "from",
            "description": "Unset on the side the path is not on."
          },
          "to": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.FileState"
              }
            ],
            "title": "to"
          }
        },
        "title": "FileChange",
        "additionalProperties": false
      },
      "spin.v1.FileChangeKind": {
        "type": "string",
        "title": "FileChangeKind",
        "enum": [
          "FILE_CHANGE_KIND_UNSPECIFIED",
          "FILE_CHANGE_KIND_ADDED",
          "FILE_CHANGE_KIND_REMOVED",
          "FILE_CHANGE_KIND_MODIFIED",
          "FILE_CHANGE_KIND_TYPE_CHANGED"
        ],
        "description": "- `FILE_CHANGE_KIND_MODIFIED`: The same type on both sides, and a different content, mode, owner or symlink target.",
        "x-enum-descriptions": [
          "",
          "",
          "",
          "The same type on both sides, and a different content, mode, owner or symlink target.",
          ""
        ]
      },
      "spin.v1.FileState": {
        "type": "object",
        "properties": {
          "type": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.FileType"
              }
            ],
            "title": "type"
          },
          "mode": {
            "type": "integer",
            "title": "mode",
            "description": "Permission bits, setuid, setgid and sticky included."
          },
          "uid": {
            "type": "integer",
            "title": "uid"
          },
          "gid": {
            "type": "integer",
            "title": "gid"
          },
          "size": {
            "type": "string",
            "title": "size",
            "format": "int64"
          },
          "symlinkTarget": {
            "type": "string",
            "title": "symlink_target",
            "description": "A symlink's target as stored, never followed; replaced and in symlink_target_bytes as path is."
          },
          "symlinkTargetBytes": {
            "type": "string",
            "title": "symlink_target_bytes",
            "format": "byte"
          },
          "sha256": {
            "type": "string",
            "title": "sha256",
            "description": "A regular file's content hash in lowercase hex, where its content is what changed."
          },
          "modifiedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "modified_at"
          }
        },
        "title": "FileState",
        "additionalProperties": false
      },
      "spin.v1.FileType": {
        "type": "string",
        "title": "FileType",
        "enum": [
          "FILE_TYPE_UNSPECIFIED",
          "FILE_TYPE_REGULAR",
          "FILE_TYPE_DIRECTORY",
          "FILE_TYPE_SYMLINK",
          "FILE_TYPE_OTHER"
        ],
        "description": "- `FILE_TYPE_OTHER`: A device, a FIFO or a socket.",
        "x-enum-descriptions": [
          "",
          "",
          "",
          "",
          "A device, a FIFO or a socket."
        ]
      },
      "spin.v1.FleetClass": {
        "type": "object",
        "properties": {
          "class": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.HostClass"
              }
            ],
            "title": "class"
          },
          "desired": {
            "type": "integer",
            "title": "desired",
            "format": "int32",
            "description": "What it last asked the group for, and the most it may ask now - the class's own limit, or\n what the installation's leaves it: zero of one is a group at rest."
          },
          "most": {
            "type": "integer",
            "title": "most",
            "format": "int32"
          },
          "waiting": {
            "type": "integer",
            "title": "waiting",
            "format": "int32",
            "description": "Workspaces of the class that have nowhere to run yet, and when the first of them started\n waiting: this is what makes the control plane ask for a machine."
          },
          "oldestWaiting": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "oldest_waiting"
          },
          "busy": {
            "type": "integer",
            "title": "busy",
            "format": "int32",
            "description": "Workspaces of the class, and hosts a root shell holds, keeping its group up."
          },
          "launchFailure": {
            "type": "string",
            "title": "launch_failure",
            "description": "Why the group has fewer machines running than it was asked for, in its cloud's own words -\n \"AWS could not start a runner: \u003cmessage\u003e\" - and when the cloud said it. Empty while it has\n as many, or while the cloud said nothing that explains it."
          },
          "launchFailedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "launch_failed_at"
          },
          "giveBackRefused": {
            "type": "string",
            "title": "give_back_refused",
            "description": "A machine of the group the cloud would not take back, in its own words - a role or a policy\n somebody has to change - and when; it is asked again every quarter hour until it is taken.\n Empty while none is refused."
          },
          "giveBackRefusedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "give_back_refused_at"
          },
          "capacityRefused": {
            "type": "boolean",
            "title": "capacity_refused",
            "description": "launch_failure is the cloud having no machine of the kind the class asks for - no spot\n capacity, or the spot quota spent - which the class's spot setting, or its fallback, is what\n changes; false for any other failure, and while there is none."
          },
          "onDemandUntil": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "on_demand_until",
            "description": "Set while a spot class's group starts on-demand machines because the cloud refused it spot\n (HostClass.fallback_on_demand): until this, and spot again after. Its class still says spot."
          }
        },
        "title": "FleetClass",
        "additionalProperties": false,
        "description": "One host class's group, as the control plane last saw it."
      },
      "spin.v1.FleetHostVersion": {
        "type": "object",
        "properties": {
          "hostId": {
            "type": "string",
            "title": "host_id"
          },
          "state": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.HostState"
              }
            ],
            "title": "state"
          },
          "agentVersion": {
            "type": "string",
            "title": "agent_version"
          },
          "machineVersion": {
            "type": "string",
            "title": "machine_version",
            "description": "Empty on a host with no machine, such as the mock runner."
          },
          "supported": {
            "type": "boolean",
            "title": "supported",
            "description": "Whether this control plane serves a host of that version. An unsupported host is refused\n at its next registration, with note saying why."
          },
          "note": {
            "type": "string",
            "title": "note"
          },
          "lastHeartbeat": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "last_heartbeat"
          }
        },
        "title": "FleetHostVersion",
        "additionalProperties": false,
        "description": "FleetHostVersion is one host's halves: the runner binary and the machine under it."
      },
      "spin.v1.ForgeApp": {
        "type": "object",
        "properties": {
          "forge": {
            "type": "string",
            "title": "forge",
            "description": "netpolicy.Forges: \"github\"."
          },
          "appId": {
            "type": "string",
            "title": "app_id",
            "format": "int64"
          },
          "slug": {
            "type": "string",
            "title": "slug"
          },
          "clientId": {
            "type": "string",
            "title": "client_id"
          },
          "apiUrl": {
            "type": "string",
            "title": "api_url"
          },
          "webUrl": {
            "type": "string",
            "title": "web_url"
          },
          "hosts": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "hosts",
            "description": "The exact names a person's token may be sent to."
          },
          "installUrl": {
            "type": "string",
            "title": "install_url",
            "description": "Where the app is installed on an account, which is what lets a token reach its repositories."
          },
          "deleting": {
            "type": "boolean",
            "title": "deleting",
            "description": "Being deleted: it takes no connection, and goes once what it granted has been revoked."
          },
          "updatedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "updated_at"
          }
        },
        "title": "ForgeApp",
        "additionalProperties": false
      },
      "spin.v1.ForgeConnection": {
        "type": "object",
        "properties": {
          "forge": {
            "type": "string",
            "title": "forge"
          },
          "login": {
            "type": "string",
            "title": "login",
            "description": "The account, as the forge names it."
          },
          "expiresAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "expires_at",
            "description": "When the token ends: it is refreshed before then."
          },
          "connectedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "connected_at"
          }
        },
        "title": "ForgeConnection",
        "additionalProperties": false
      },
      "spin.v1.ForgeRepository": {
        "type": "object",
        "properties": {
          "fullName": {
            "type": "string",
            "title": "full_name",
            "description": "owner/name."
          },
          "cloneUrl": {
            "type": "string",
            "title": "clone_url",
            "description": "What a project's repository is: https, with nothing of a credential in it."
          },
          "defaultBranch": {
            "type": "string",
            "title": "default_branch"
          },
          "private": {
            "type": "boolean",
            "title": "private"
          },
          "description": {
            "type": "string",
            "title": "description"
          }
        },
        "title": "ForgeRepository",
        "additionalProperties": false
      },
      "spin.v1.GetBillRequest": {
        "type": "object",
        "properties": {
          "month": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "month",
            "description": "The month, as any instant in it (UTC's); unset is the month in progress."
          }
        },
        "title": "GetBillRequest",
        "additionalProperties": false
      },
      "spin.v1.GetBillResponse": {
        "type": "object",
        "properties": {
          "month": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "month",
            "description": "The month's first instant, UTC."
          },
          "readAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "read_at",
            "description": "When the bill was last read; unset where it never was - no scope (bill_scope), or a cloud\n that sends none - and then nothing below is known."
          },
          "currency": {
            "type": "string",
            "title": "currency",
            "description": "ISO 4217; every amount here is in millionths of it."
          },
          "totalMicros": {
            "type": "string",
            "title": "total_micros",
            "format": "int64",
            "description": "The month so far, every day and service."
          },
          "forecastMicros": {
            "type": [
              "string",
              "null"
            ],
            "title": "forecast_micros",
            "format": "int64",
            "description": "What the month is forecast to end at; unset where the cloud has no forecast yet."
          },
          "budgetLimitMicros": {
            "type": [
              "string",
              "null"
            ],
            "title": "budget_limit_micros",
            "format": "int64",
            "description": "The installation's budget and what the cloud counts against it; unset where it has none."
          },
          "budgetActualMicros": {
            "type": [
              "string",
              "null"
            ],
            "title": "budget_actual_micros",
            "format": "int64"
          },
          "budgetForecastMicros": {
            "type": [
              "string",
              "null"
            ],
            "title": "budget_forecast_micros",
            "format": "int64"
          },
          "days": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.BillDay"
            },
            "title": "days",
            "description": "Oldest first."
          }
        },
        "title": "GetBillResponse",
        "additionalProperties": false
      },
      "spin.v1.GetCostsRequest": {
        "type": "object",
        "properties": {
          "month": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "month",
            "description": "The month, as any instant in it (UTC's); unset is the month in progress."
          }
        },
        "title": "GetCostsRequest",
        "additionalProperties": false
      },
      "spin.v1.GetCostsResponse": {
        "type": "object",
        "properties": {
          "month": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "month",
            "description": "The month's first instant, UTC."
          },
          "currency": {
            "type": "string",
            "title": "currency",
            "description": "ISO 4217; every amount here is in millionths of it."
          },
          "workspaces": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.WorkspaceCost"
            },
            "title": "workspaces",
            "description": "Costliest first."
          },
          "idleMicros": {
            "type": "string",
            "title": "idle_micros",
            "format": "int64",
            "description": "What the runners cost that no workspace held."
          },
          "unstoredMicros": {
            "type": "string",
            "title": "unstored_micros",
            "format": "int64",
            "description": "What the volumes' bucket cost for bytes no workspace keeps: the images, what nothing\n references any more."
          },
          "platform": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.PlatformCost"
            },
            "title": "platform",
            "description": "Every other cost - the control plane, the proxy, keys, logs - by role and service, costliest\n first."
          },
          "standby": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.StandbyCost"
              }
            ],
            "title": "standby",
            "description": "What the installation costs a day with nobody working; unset where no day before the\n reading billed anything."
          },
          "readAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "read_at",
            "description": "When the month's bill was last read; unset where it never was, and then nothing is answered."
          },
          "trend": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.CostMonth"
            },
            "title": "trend",
            "description": "The year up to this month, oldest first, this month last: each month the bill was read in,\n shared out as this one is. A month never read is not among them."
          }
        },
        "title": "GetCostsResponse",
        "additionalProperties": false
      },
      "spin.v1.GetCurrentUserRequest": {
        "type": "object",
        "title": "GetCurrentUserRequest",
        "additionalProperties": false
      },
      "spin.v1.GetCurrentUserResponse": {
        "type": "object",
        "properties": {
          "user": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.User"
              }
            ],
            "title": "user"
          },
          "controlPlaneVersion": {
            "type": "string",
            "title": "control_plane_version",
            "description": "The release of the control plane that answered, which is the release of the dashboard asking:\n the bundle is served from inside that binary. It rides here rather than on an endpoint of its\n own because every session asks this once, and because a version an installation will be\n matched against known flaws by is not something to hand out unauthenticated."
          }
        },
        "title": "GetCurrentUserResponse",
        "additionalProperties": false
      },
      "spin.v1.GetEmailSettingsRequest": {
        "type": "object",
        "title": "GetEmailSettingsRequest",
        "additionalProperties": false
      },
      "spin.v1.GetEmailSettingsResponse": {
        "type": "object",
        "properties": {
          "settings": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.EmailSettings"
              }
            ],
            "title": "settings"
          }
        },
        "title": "GetEmailSettingsResponse",
        "additionalProperties": false
      },
      "spin.v1.GetFleetRequest": {
        "type": "object",
        "title": "GetFleetRequest",
        "additionalProperties": false
      },
      "spin.v1.GetFleetResponse": {
        "type": "object",
        "properties": {
          "autoscaling": {
            "type": "boolean",
            "title": "autoscaling",
            "description": "False when no fleet is configured: the hosts of this installation are whatever somebody\n registered by hand, and none of the numbers below mean anything."
          },
          "connected": {
            "type": "integer",
            "title": "connected",
            "format": "int32",
            "description": "The hosts that are connected now, of every class, which lags what was asked for by a\n machine's boot."
          },
          "idleMinutes": {
            "type": "integer",
            "title": "idle_minutes",
            "format": "int32",
            "description": "How long a class's group may be idle before it is emptied, and the window in which it is\n emptied at once. Empty quiet_hours is none."
          },
          "quietHours": {
            "type": "string",
            "title": "quiet_hours"
          },
          "timeZone": {
            "type": "string",
            "title": "time_zone"
          },
          "maxHosts": {
            "type": "integer",
            "title": "max_hosts",
            "format": "int32",
            "description": "The most hosts of every class together; 0 is no limit of the installation's own."
          },
          "classes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.FleetClass"
            },
            "title": "classes",
            "description": "Each host class's group, the default first."
          }
        },
        "title": "GetFleetResponse",
        "additionalProperties": false,
        "description": "What an operator needs to read an empty list of hosts: whether the installation can bring one\n at all, how many it has asked for, and what is waiting. Every count is the control plane's own\n view now, not a stored one - a control plane that restarted starts counting again."
      },
      "spin.v1.GetFleetVersionsRequest": {
        "type": "object",
        "title": "GetFleetVersionsRequest",
        "additionalProperties": false
      },
      "spin.v1.GetFleetVersionsResponse": {
        "type": "object",
        "properties": {
          "controlPlaneVersion": {
            "type": "string",
            "title": "control_plane_version"
          },
          "machineVersion": {
            "type": "string",
            "title": "machine_version",
            "description": "The spin-machine release this control plane pins, which a host should be running."
          },
          "hosts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.FleetHostVersion"
            },
            "title": "hosts"
          },
          "extensions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.ExtensionVersion"
            },
            "title": "extensions"
          }
        },
        "title": "GetFleetVersionsResponse",
        "additionalProperties": false
      },
      "spin.v1.GetHostPolicyRequest": {
        "type": "object",
        "properties": {
          "hostId": {
            "type": "string",
            "title": "host_id"
          }
        },
        "title": "GetHostPolicyRequest",
        "additionalProperties": false
      },
      "spin.v1.GetHostPolicyResponse": {
        "type": "object",
        "properties": {
          "policy": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.HostPolicy"
              }
            ],
            "title": "policy"
          },
          "writebackPresets": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.WritebackPreset"
            },
            "title": "writeback_presets",
            "description": "The writeback thresholds an operator chooses from without testing them on the host, each\n with what it measured. The first is unset: what the host booted with."
          },
          "writebackTest": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.WritebackTest"
              }
            ],
            "title": "writeback_test",
            "description": "The last writeback test of this host, while SetHostPolicy still takes its thresholds."
          }
        },
        "title": "GetHostPolicyResponse",
        "additionalProperties": false
      },
      "spin.v1.GetHostRequest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          }
        },
        "title": "GetHostRequest",
        "additionalProperties": false
      },
      "spin.v1.GetHostResponse": {
        "type": "object",
        "properties": {
          "host": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.Host"
              }
            ],
            "title": "host"
          },
          "departure": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.HostDeparture"
              }
            ],
            "title": "departure",
            "description": "What taking the host out would do to each workspace on it, as the server would do it: asked\n of one host, because it reads every workspace there."
          }
        },
        "title": "GetHostResponse",
        "additionalProperties": false
      },
      "spin.v1.GetHostShellRecordingRequest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          }
        },
        "title": "GetHostShellRecordingRequest",
        "additionalProperties": false
      },
      "spin.v1.GetHostShellRecordingResponse": {
        "type": "object",
        "properties": {
          "sessions": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "byte"
            },
            "title": "sessions",
            "description": "Each session's asciicast v2, in the order they were opened."
          },
          "truncated": {
            "type": "boolean",
            "title": "truncated",
            "description": "Whether there was more than one answer carries: the rest is in the bucket, under\n host-shells/\u003cid\u003e/."
          }
        },
        "title": "GetHostShellRecordingResponse",
        "additionalProperties": false
      },
      "spin.v1.GetInstallationHealthRequest": {
        "type": "object",
        "title": "GetInstallationHealthRequest",
        "additionalProperties": false
      },
      "spin.v1.GetInstallationHealthResponse": {
        "type": "object",
        "properties": {
          "status": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.HealthStatus"
              }
            ],
            "title": "status",
            "description": "status is the worst of the checks'."
          },
          "checks": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.HealthCheck"
            },
            "title": "checks",
            "description": "One per part the installation has: a part it does not have - a database archive on a\n development stack, a log store where none is kept, a collector that never reported, jobs on\n a control plane that does not lead - is left out rather than answered for."
          }
        },
        "title": "GetInstallationHealthResponse",
        "additionalProperties": false
      },
      "spin.v1.GetMonitoringRequest": {
        "type": "object",
        "title": "GetMonitoringRequest",
        "additionalProperties": false
      },
      "spin.v1.GetMonitoringResponse": {
        "type": "object",
        "properties": {
          "grafana": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.Grafana"
              }
            ],
            "title": "grafana",
            "description": "Unset where the control plane serves none: the installation keeps no metrics, or this\n machine has no Grafana."
          }
        },
        "title": "GetMonitoringResponse",
        "additionalProperties": false
      },
      "spin.v1.GetNotificationPreferencesRequest": {
        "type": "object",
        "title": "GetNotificationPreferencesRequest",
        "additionalProperties": false
      },
      "spin.v1.GetNotificationPreferencesResponse": {
        "type": "object",
        "properties": {
          "preferences": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.NotificationPreference"
            },
            "title": "preferences",
            "description": "One per event a person may be told of, in the order they are shown: an administrator's\n include the installation's."
          },
          "emailConfigured": {
            "type": "boolean",
            "title": "email_configured"
          }
        },
        "title": "GetNotificationPreferencesResponse",
        "additionalProperties": false
      },
      "spin.v1.GetPlatformImagesRequest": {
        "type": "object",
        "title": "GetPlatformImagesRequest",
        "additionalProperties": false
      },
      "spin.v1.GetPlatformImagesResponse": {
        "type": "object",
        "properties": {
          "images": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.PlatformImage"
            },
            "title": "images",
            "description": "Empty until the object store is configured: there is nowhere to publish to."
          },
          "baseImages": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.BaseImage"
            },
            "title": "base_images",
            "description": "Every base image published, one per machine release, newest first."
          },
          "supervisorReleases": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.ExtensionRelease"
            },
            "title": "supervisor_releases",
            "description": "Every release of the supervisor, newest first."
          },
          "agentReleases": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.ExtensionRelease"
            },
            "title": "agent_releases",
            "description": "Every release of the agents' programs (Claude Code, Codex and T3 Code, one extension), newest\n first."
          }
        },
        "title": "GetPlatformImagesResponse",
        "additionalProperties": false
      },
      "spin.v1.GetPrebuildRequest": {
        "type": "object",
        "properties": {
          "projectId": {
            "type": "string",
            "title": "project_id"
          },
          "prebuildId": {
            "type": "string",
            "title": "prebuild_id"
          }
        },
        "title": "GetPrebuildRequest",
        "additionalProperties": false,
        "description": "A prebuild by its id, of the project it names: one of another project is not found."
      },
      "spin.v1.GetPrebuildResponse": {
        "type": "object",
        "properties": {
          "prebuild": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.Prebuild"
              }
            ],
            "title": "prebuild"
          }
        },
        "title": "GetPrebuildResponse",
        "additionalProperties": false
      },
      "spin.v1.GetProjectCostsRequest": {
        "type": "object",
        "properties": {
          "projectId": {
            "type": "string",
            "title": "project_id"
          }
        },
        "title": "GetProjectCostsRequest",
        "additionalProperties": false
      },
      "spin.v1.GetProjectCostsResponse": {
        "type": "object",
        "properties": {
          "month": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "month",
            "description": "The month in progress: its first instant, UTC."
          },
          "readAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "read_at",
            "description": "When the bill was last read; unset where it never was - an installation with no bill scope -\n and then nothing below is known and nothing is to be drawn."
          },
          "currency": {
            "type": "string",
            "title": "currency",
            "description": "ISO 4217; every amount here is in millionths of it."
          },
          "workspaces": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.CostShare"
              }
            ],
            "title": "workspaces",
            "description": "Its workspaces' shares summed, deleted ones and its prebuilds' builds included: a workspace is\n the project's it opened, whoever's it was."
          },
          "prebuilds": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PrebuildsKept"
              }
            ],
            "title": "prebuilds"
          }
        },
        "title": "GetProjectCostsResponse",
        "additionalProperties": false
      },
      "spin.v1.GetProjectRequest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          },
          "slug": {
            "type": "string",
            "title": "slug"
          }
        },
        "title": "GetProjectRequest",
        "additionalProperties": false,
        "description": "By id, or by slug."
      },
      "spin.v1.GetProjectResponse": {
        "type": "object",
        "properties": {
          "project": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.Project"
              }
            ],
            "title": "project"
          }
        },
        "title": "GetProjectResponse",
        "additionalProperties": false
      },
      "spin.v1.GetRunbookRequest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          }
        },
        "title": "GetRunbookRequest",
        "additionalProperties": false
      },
      "spin.v1.GetRunbookResponse": {
        "type": "object",
        "properties": {
          "runbook": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.Runbook"
              }
            ],
            "title": "runbook"
          },
          "markdown": {
            "type": "string",
            "title": "markdown",
            "description": "Its body, markdown without the front matter: the app renders it and nothing else (no raw HTML)."
          },
          "sourceUrl": {
            "type": "string",
            "title": "source_url",
            "description": "The file at the commit this release pins, to propose a change from."
          }
        },
        "title": "GetRunbookResponse",
        "additionalProperties": false
      },
      "spin.v1.GetSettingsRequest": {
        "type": "object",
        "title": "GetSettingsRequest",
        "additionalProperties": false
      },
      "spin.v1.GetSettingsResponse": {
        "type": "object",
        "properties": {
          "values": {
            "type": "object",
            "title": "values",
            "additionalProperties": {
              "type": "string",
              "title": "value"
            },
            "description": "Every definition's value in force, by key, as text of its type: what the installation says,\n or the default where it says nothing. The control plane's own are left out."
          },
          "definitions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.SettingDefinition"
            },
            "title": "definitions",
            "description": "Every setting an administrator is shown, in the registry's order."
          },
          "runningWorkspaces": {
            "type": "integer",
            "title": "running_workspaces",
            "format": "int32",
            "description": "How many workspaces are running now: what a RUNNING_WORKSPACES setting reaches, and what a\n NEW_WORKSPACES one leaves as it is."
          },
          "connectedRunners": {
            "type": [
              "integer",
              "null"
            ],
            "title": "connected_runners",
            "format": "int32",
            "description": "How many runners hold their stream to this control plane now: what a NEXT_HEARTBEAT setting\n reaches. Unset where this control plane cannot tell."
          },
          "place": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.InstallationPlace"
              }
            ],
            "title": "place",
            "description": "Where the installation runs and what it runs, read-only."
          }
        },
        "title": "GetSettingsResponse",
        "additionalProperties": false
      },
      "spin.v1.GetSetupStatusRequest": {
        "type": "object",
        "title": "GetSetupStatusRequest",
        "additionalProperties": false
      },
      "spin.v1.GetSetupStatusResponse": {
        "type": "object",
        "properties": {
          "needsSetup": {
            "type": "boolean",
            "title": "needs_setup",
            "description": "True until the setup wizard has been completed: where the dashboard sends everybody."
          },
          "hasOauth": {
            "type": "boolean",
            "title": "has_oauth",
            "description": "True if any OAuth/OIDC provider is configured"
          },
          "setupCompleted": {
            "type": "boolean",
            "title": "setup_completed",
            "description": "True if setup wizard has been completed"
          },
          "forcePasswordChange": {
            "type": "boolean",
            "title": "force_password_change",
            "description": "True if current admin must change their password"
          },
          "baseDomain": {
            "type": "string",
            "title": "base_domain",
            "description": "The configured base domain (if any)"
          },
          "hasBootstrapAdmin": {
            "type": "boolean",
            "title": "has_bootstrap_admin",
            "description": "True if bootstrap admin is still active (should be disabled after OAuth setup)"
          },
          "registrationMode": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.RegistrationMode"
              }
            ],
            "title": "registration_mode",
            "description": "Current registration mode (open, whitelist, closed)"
          },
          "hasStorage": {
            "type": "boolean",
            "title": "has_storage",
            "description": "True if the object store is configured; until it is, no workspace can be created"
          },
          "signedIn": {
            "type": "boolean",
            "title": "signed_in",
            "description": "True if whoever asked is signed in: the wizard starts at the sign-in until they are, whatever\n the installation already has."
          },
          "development": {
            "type": "boolean",
            "title": "development",
            "description": "True for a development installation, where the mock identity provider may be enabled."
          },
          "thirdPartyAccepted": {
            "type": "boolean",
            "title": "third_party_accepted",
            "description": "True where an administrator accepted the terms of any third-party software, as the current\n text: the wizard asks until one has, or until it is told to go on without."
          }
        },
        "title": "GetSetupStatusResponse",
        "additionalProperties": false
      },
      "spin.v1.GetStorageSettingsRequest": {
        "type": "object",
        "title": "GetStorageSettingsRequest",
        "additionalProperties": false
      },
      "spin.v1.GetStorageSettingsResponse": {
        "type": "object",
        "properties": {
          "settings": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.StorageSettings"
              }
            ],
            "title": "settings"
          },
          "volumesExist": {
            "type": "boolean",
            "title": "volumes_exist",
            "description": "Whether volumes exist, whose history is in this store: it can then be changed, but not\n for another bucket or directory."
          }
        },
        "title": "GetStorageSettingsResponse",
        "additionalProperties": false
      },
      "spin.v1.GetStorageUsageRequest": {
        "type": "object",
        "title": "GetStorageUsageRequest",
        "additionalProperties": false
      },
      "spin.v1.GetStorageUsageResponse": {
        "type": "object",
        "properties": {
          "volumes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.StoredVolume"
            },
            "title": "volumes",
            "description": "Heaviest first."
          },
          "unreferencedLayers": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.StorageTally"
              }
            ],
            "title": "unreferenced_layers",
            "description": "Layers no commit in the store names: the storage GC's to collect."
          },
          "other": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.StorageTally"
              }
            ],
            "title": "other",
            "description": "Everything outside volumes/ and layers/: the control planes' claims to lead, the owners'\n words kept per workspace, the rosters and keyrings, the writers' keys and the identity\n records."
          },
          "measuredAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "measured_at"
          }
        },
        "title": "GetStorageUsageResponse",
        "additionalProperties": false
      },
      "spin.v1.GetTeamCostsRequest": {
        "type": "object",
        "properties": {
          "teamId": {
            "type": "string",
            "title": "team_id"
          }
        },
        "title": "GetTeamCostsRequest",
        "additionalProperties": false
      },
      "spin.v1.GetTeamCostsResponse": {
        "type": "object",
        "properties": {
          "month": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "month",
            "description": "The month in progress: its first instant, UTC."
          },
          "readAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "read_at",
            "description": "When the bill was last read; unset where it never was - an installation with no bill scope -\n and then nothing below is known and nothing is to be drawn."
          },
          "currency": {
            "type": "string",
            "title": "currency",
            "description": "ISO 4217; every amount here is in millionths of it."
          },
          "total": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.CostShare"
              }
            ],
            "title": "total",
            "description": "Its workspaces, summed."
          },
          "workspaces": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.TeamWorkspaceCost"
            },
            "title": "workspaces",
            "description": "Costliest first."
          }
        },
        "title": "GetTeamCostsResponse",
        "additionalProperties": false
      },
      "spin.v1.GetTeamRequest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id",
            "description": "ID, path (e.g., \"/engineering/backend\") or \"me\": the caller's personal team"
          }
        },
        "title": "GetTeamRequest",
        "additionalProperties": false
      },
      "spin.v1.GetTeamResponse": {
        "type": "object",
        "properties": {
          "team": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.Team"
              }
            ],
            "title": "team"
          },
          "currentUserRole": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.TeamRole"
              }
            ],
            "title": "current_user_role",
            "description": "Role of the requesting user in this team"
          }
        },
        "title": "GetTeamResponse",
        "additionalProperties": false
      },
      "spin.v1.GetTelemetryStatusRequest": {
        "type": "object",
        "title": "GetTelemetryStatusRequest",
        "additionalProperties": false
      },
      "spin.v1.GetTelemetryStatusResponse": {
        "type": "object",
        "properties": {
          "reportedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "reported_at",
            "description": "Unset: the watch has not reported since this control plane started - no collector, or not\n yet."
          },
          "windowSeconds": {
            "type": "integer",
            "title": "window_seconds",
            "format": "int32",
            "description": "How long the counts below are over."
          },
          "spans": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.TelemetryFlow"
              }
            ],
            "title": "spans",
            "description": "Into the installation's store, after the traces policy chose which to keep."
          },
          "samples": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.TelemetryFlow"
              }
            ],
            "title": "samples",
            "description": "Into the installation's store of metrics."
          },
          "perVolumeHistograms": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "per_volume_histograms",
            "description": "The metrics that cost most to keep, a histogram per volume, which a surface may offer to\n drop as one (the setting telemetry_metrics_drop)."
          }
        },
        "title": "GetTelemetryStatusResponse",
        "additionalProperties": false
      },
      "spin.v1.GetThirdPartyTermsRequest": {
        "type": "object",
        "title": "GetThirdPartyTermsRequest",
        "additionalProperties": false
      },
      "spin.v1.GetThirdPartyTermsResponse": {
        "type": "object",
        "properties": {
          "termsVersion": {
            "type": "string",
            "title": "terms_version",
            "description": "The version of the text below, which an acceptance names."
          },
          "text": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "text",
            "description": "The terms, a paragraph each."
          },
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.ThirdPartyTermsItem"
            },
            "title": "items"
          }
        },
        "title": "GetThirdPartyTermsResponse",
        "additionalProperties": false
      },
      "spin.v1.GetTraceRequest": {
        "type": "object",
        "properties": {
          "traceId": {
            "type": "string",
            "title": "trace_id",
            "description": "Hex, as a log record carries it."
          }
        },
        "title": "GetTraceRequest",
        "additionalProperties": false
      },
      "spin.v1.GetTraceResponse": {
        "type": "object",
        "properties": {
          "spans": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.Span"
            },
            "title": "spans"
          }
        },
        "title": "GetTraceResponse",
        "additionalProperties": false
      },
      "spin.v1.GetUserSettingsRequest": {
        "type": "object",
        "title": "GetUserSettingsRequest",
        "additionalProperties": false,
        "description": "User settings"
      },
      "spin.v1.GetUserSettingsResponse": {
        "type": "object",
        "properties": {
          "settings": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.UserSettings"
              }
            ],
            "title": "settings"
          }
        },
        "title": "GetUserSettingsResponse",
        "additionalProperties": false
      },
      "spin.v1.GetUserWorkspaceEgressRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id",
            "description": "The workspace's id."
          },
          "reason": {
            "type": "string",
            "title": "reason",
            "description": "Why, kept on the audit entry."
          }
        },
        "title": "GetUserWorkspaceEgressRequest",
        "additionalProperties": false
      },
      "spin.v1.GetUserWorkspaceEgressResponse": {
        "type": "object",
        "properties": {
          "egress": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.GetWorkspaceEgressResponse"
              }
            ],
            "title": "egress"
          }
        },
        "title": "GetUserWorkspaceEgressResponse",
        "additionalProperties": false
      },
      "spin.v1.GetVSCodeServersRequest": {
        "type": "object",
        "title": "GetVSCodeServersRequest",
        "additionalProperties": false
      },
      "spin.v1.GetVSCodeServersResponse": {
        "type": "object",
        "properties": {
          "releases": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.ExtensionRelease"
            },
            "title": "releases",
            "description": "Newest first."
          },
          "publish": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.VSCodeServerPublish"
              }
            ],
            "title": "publish"
          },
          "unavailable": {
            "type": "string",
            "title": "unavailable",
            "description": "Why this control plane cannot publish - no object store, or a build with no machine tools\n to make the image with - and empty when it can."
          }
        },
        "title": "GetVSCodeServersResponse",
        "additionalProperties": false
      },
      "spin.v1.GetWorkspaceConsoleRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "lines": {
            "type": "integer",
            "title": "lines",
            "format": "int32",
            "description": "How many lines from the end; zero asks for the default. The host bounds it either way."
          }
        },
        "title": "GetWorkspaceConsoleRequest",
        "additionalProperties": false
      },
      "spin.v1.GetWorkspaceConsoleResponse": {
        "type": "object",
        "properties": {
          "lines": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "lines",
            "description": "Newest last, as the console was written."
          },
          "truncated": {
            "type": "boolean",
            "title": "truncated",
            "description": "truncated says there are lines before the first one here, so what this begins with is not\n mistaken for the start of the boot."
          },
          "hostId": {
            "type": "string",
            "title": "host_id",
            "description": "Which host answered. A console belongs to the machine that wrote it, and a workspace that\n has moved has nothing to say about the run that failed on the host it left."
          }
        },
        "title": "GetWorkspaceConsoleResponse",
        "additionalProperties": false
      },
      "spin.v1.GetWorkspaceCostRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          }
        },
        "title": "GetWorkspaceCostRequest",
        "additionalProperties": false
      },
      "spin.v1.GetWorkspaceCostResponse": {
        "type": "object",
        "properties": {
          "month": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "month",
            "description": "The month in progress: its first instant, UTC."
          },
          "readAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "read_at",
            "description": "When the bill was last read; unset where it never was - an installation with no bill scope, a\n cloud that sends none - and then nothing below is known and nothing is to be drawn."
          },
          "currency": {
            "type": "string",
            "title": "currency",
            "description": "ISO 4217; every amount here is in millionths of it."
          },
          "share": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.CostShare"
              }
            ],
            "title": "share",
            "description": "The month so far."
          },
          "estimate": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.CostEstimate"
              }
            ],
            "title": "estimate",
            "description": "Unset where no day before the reading was billed, or none says anything of this workspace."
          }
        },
        "title": "GetWorkspaceCostResponse",
        "additionalProperties": false
      },
      "spin.v1.GetWorkspaceDeletionRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "permanently": {
            "type": "boolean",
            "title": "permanently",
            "description": "What DeleteWorkspaceRequest.permanently would do: an erase, whatever the trash keeps."
          }
        },
        "title": "GetWorkspaceDeletionRequest",
        "additionalProperties": false
      },
      "spin.v1.GetWorkspaceDeletionResponse": {
        "type": "object",
        "properties": {
          "trashDays": {
            "type": "integer",
            "title": "trash_days",
            "format": "int32",
            "description": "How many days the delete keeps the workspace in the trash; 0 is an erase now - the\n installation keeps no trash, or permanently was asked."
          },
          "effects": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.DeletionEffect"
            },
            "title": "effects",
            "description": "Everything the delete does to what the workspace has, ordered erased, trashed, kept. Only\n what this workspace has: one with no snapshot is told nothing of snapshots."
          }
        },
        "title": "GetWorkspaceDeletionResponse",
        "additionalProperties": false
      },
      "spin.v1.GetWorkspaceEgressRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          }
        },
        "title": "GetWorkspaceEgressRequest",
        "additionalProperties": false,
        "description": "GetWorkspaceEgressRequest asks what a workspace has reached beyond the node. The host keeps\n the record, so the workspace has to be running on one; it is kept for six hours and survives\n a restart of the runner, not of the host."
      },
      "spin.v1.GetWorkspaceEgressResponse": {
        "type": "object",
        "properties": {
          "destinations": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.ObservedDestination"
            },
            "title": "destinations",
            "description": "Most traffic first, so what an allowlist has to carry is at the top."
          },
          "lookups": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.ResolverLookup"
            },
            "title": "lookups",
            "description": "The workspace's recent lookups its host's resolver did not answer as asked, newest first:\n \"it cannot resolve github.com\" is an upstream failing, a name pointing into the node being\n removed, or a query type refused, and this says which. Answered lookups are not kept."
          },
          "refused": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.RefusedDestination"
            },
            "title": "refused",
            "description": "What the host's drops refused the workspace in the last hour, most packets first: the\n node's own networks, or what none of its policies allows. The other half of destinations,\n and what a policy that is too narrow looks like from outside the machine."
          },
          "brokered": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.BrokeredRequest"
            },
            "title": "brokered",
            "description": "The workspace's recent requests to names its policies broker with an injection, newest\n first: what the host's egress proxy set a header on, and what it refused and why. A brokered\n name no rule injects on is relayed byte for byte and leaves no request here."
          }
        },
        "title": "GetWorkspaceEgressResponse",
        "additionalProperties": false
      },
      "spin.v1.GetWorkspaceHistoryRequest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          },
          "limit": {
            "type": "integer",
            "title": "limit",
            "format": "int32",
            "description": "Number of events (default: 50)"
          }
        },
        "title": "GetWorkspaceHistoryRequest",
        "additionalProperties": false
      },
      "spin.v1.GetWorkspaceHistoryResponse": {
        "type": "object",
        "properties": {
          "events": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.WorkspaceEvent"
            },
            "title": "events"
          }
        },
        "title": "GetWorkspaceHistoryResponse",
        "additionalProperties": false
      },
      "spin.v1.GetWorkspaceIdentityRequest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          }
        },
        "title": "GetWorkspaceIdentityRequest",
        "additionalProperties": false,
        "description": "Workspace History / Timeline"
      },
      "spin.v1.GetWorkspaceIdentityResponse": {
        "type": "object",
        "properties": {
          "spiffeId": {
            "type": "string",
            "title": "spiffe_id",
            "description": "The workspace's SPIFFE ID, spiffe://\u003cdomain\u003e/t/\u003cteam\u003e/w/\u003cworkspace\u003e: every subject in it is\n under it - the user's at /u, each agent's at /a/\u003cname\u003e - so a relying party names the\n workspace by it as a prefix."
          },
          "userSubject": {
            "type": "string",
            "title": "user_subject",
            "description": "The workspace user's subject, what its tokens and signatures carry."
          },
          "issuer": {
            "type": "string",
            "title": "issuer",
            "description": "The issuer its tokens name, https://id.\u003cdomain\u003e, where the key set and the allowed signers are."
          },
          "parentSnapshotId": {
            "type": "string",
            "title": "parent_snapshot_id",
            "description": "What the workspace was cloned from: the snapshot, and the workspace whose disk it was when\n that is still there and of the same team. A workspace made from an image is cloned from the\n image's snapshot, and no workspace's: the snapshot is named and the workspace is empty."
          },
          "parentWorkspaceId": {
            "type": "string",
            "title": "parent_workspace_id"
          },
          "audiences": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "audiences",
            "description": "Who the installation gives identities for; empty is anybody."
          }
        },
        "title": "GetWorkspaceIdentityResponse",
        "additionalProperties": false
      },
      "spin.v1.GetWorkspaceNamesRequest": {
        "type": "object",
        "properties": {
          "ids": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "ids",
            "description": "At most 500: the ids a page of records names."
          }
        },
        "title": "GetWorkspaceNamesRequest",
        "additionalProperties": false
      },
      "spin.v1.GetWorkspaceNamesResponse": {
        "type": "object",
        "properties": {
          "names": {
            "type": "object",
            "title": "names",
            "additionalProperties": {
              "type": "string",
              "title": "value"
            },
            "description": "Each id asked for that the installation holds a row for, to its workspace's name."
          }
        },
        "title": "GetWorkspaceNamesResponse",
        "additionalProperties": false
      },
      "spin.v1.GetWorkspaceRequest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id",
            "description": "Workspace ID or name"
          }
        },
        "title": "GetWorkspaceRequest",
        "additionalProperties": false
      },
      "spin.v1.GetWorkspaceResponse": {
        "type": "object",
        "properties": {
          "workspace": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.Workspace"
              }
            ],
            "title": "workspace"
          }
        },
        "title": "GetWorkspaceResponse",
        "additionalProperties": false
      },
      "spin.v1.GetWorkspaceStatusRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          }
        },
        "title": "GetWorkspaceStatusRequest",
        "additionalProperties": false,
        "description": "GetWorkspace is on the hot path - the proxy resolves every request through it - and\n serves one row; this joins four and is asked when something looks wrong."
      },
      "spin.v1.GetWorkspaceStatusResponse": {
        "type": "object",
        "properties": {
          "state": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.WorkspaceState"
              }
            ],
            "title": "state",
            "description": "What the control plane believes, which is what every other surface shows."
          },
          "failureReason": {
            "type": "string",
            "title": "failure_reason",
            "description": "Only when state = FAILED"
          },
          "supervisor": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.SupervisorStatus"
              }
            ],
            "title": "supervisor"
          },
          "host": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.WorkspaceHostStatus"
              }
            ],
            "title": "host"
          },
          "volume": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.WorkspaceVolumeStatus"
              }
            ],
            "title": "volume"
          },
          "disagreements": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.StatusDisagreement"
            },
            "title": "disagreements",
            "description": "Where the four disagree, in the order they should be read. Empty means they agree -\n which is the answer when a workspace is simply healthy, and is worth saying."
          },
          "runtime": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.WorkspaceRuntime"
              }
            ],
            "title": "runtime",
            "description": "What the machine has and uses now, asked of its host. Absent - not zero - when there is no\n machine to ask about: not running, on no connected host, or a host that did not answer in\n time. Zero cores would read as a machine that has none."
          },
          "failure": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.WorkspaceFailure"
              }
            ],
            "title": "failure",
            "description": "Which part failed, when state = FAILED; failure_reason is the detail. Workspace.failure."
          },
          "injections": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.InjectionStatus"
            },
            "title": "injections",
            "description": "Each header a brokered rule of the workspace's policies sets, and whether what it is set\n from is there to set: a request to a brokered name is refused when it is not, and this is\n where that is seen from outside the machine."
          },
          "network": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.WorkspaceNetworkStatus"
            },
            "title": "network",
            "description": "The policies the workspace's network is under (Workspace.network_tags), in their order, and\n whether each is declared and installed on its host. Empty for a workspace with no tag, which\n reaches anything beyond its host's own networks."
          }
        },
        "title": "GetWorkspaceStatusResponse",
        "additionalProperties": false
      },
      "spin.v1.GetWorkspaceTraceRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "traceId": {
            "type": "string",
            "title": "trace_id",
            "description": "Hex, as a log record carries it."
          }
        },
        "title": "GetWorkspaceTraceRequest",
        "additionalProperties": false
      },
      "spin.v1.GetWorkspaceTraceResponse": {
        "type": "object",
        "properties": {
          "spans": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.Span"
            },
            "title": "spans"
          }
        },
        "title": "GetWorkspaceTraceResponse",
        "additionalProperties": false
      },
      "spin.v1.GetWorkspaceUsageRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "windowSeconds": {
            "type": "integer",
            "title": "window_seconds",
            "format": "int32",
            "description": "How far back: an hour at most, which is all a host keeps; zero is the hour."
          },
          "stepSeconds": {
            "type": "integer",
            "title": "step_seconds",
            "format": "int32",
            "description": "How wide each point is: at least 10 seconds, the slowest sampler's period; zero is 10."
          }
        },
        "title": "GetWorkspaceUsageRequest",
        "additionalProperties": false
      },
      "spin.v1.GetWorkspaceUsageResponse": {
        "type": "object",
        "properties": {
          "hostId": {
            "type": "string",
            "title": "host_id",
            "description": "The host that sampled the series; empty, with no points, when the workspace runs nowhere\n and its host kept nothing of the machine it ran."
          },
          "sampledSince": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "sampled_since",
            "description": "When that host began sampling the machine. Nothing before it is known: the samples are the\n host's, and a restart of it or a move starts them again."
          },
          "start": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "start",
            "description": "The window the points fall in: step_seconds apart from start, each over the step that begins\n at its own start. A step with no sample has no point. For a stopped or failed workspace the\n window ends with the step its machine's last sample fell in."
          },
          "stepSeconds": {
            "type": "integer",
            "title": "step_seconds",
            "format": "int32"
          },
          "cpu": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.CpuUsagePoint"
            },
            "title": "cpu"
          },
          "memory": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.MemoryUsagePoint"
            },
            "title": "memory"
          },
          "network": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.NetworkUsagePoint"
            },
            "title": "network"
          }
        },
        "title": "GetWorkspaceUsageResponse",
        "additionalProperties": false
      },
      "spin.v1.Grafana": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "title": "url",
            "description": "Where the control plane serves it: \"/monitoring/grafana/\"."
          },
          "dashboards": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.GrafanaDashboard"
            },
            "title": "dashboards",
            "description": "The release's, in the order they are listed."
          }
        },
        "title": "Grafana",
        "additionalProperties": false,
        "description": "Grafana is the one the control plane runs over the installation's metrics and serves to its\n administrators."
      },
      "spin.v1.GrafanaDashboard": {
        "type": "object",
        "properties": {
          "uid": {
            "type": "string",
            "title": "uid"
          },
          "title": {
            "type": "string",
            "title": "title"
          }
        },
        "title": "GrafanaDashboard",
        "additionalProperties": false
      },
      "spin.v1.GrantPortAccessRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "port": {
            "type": "integer",
            "title": "port",
            "format": "int32"
          },
          "userId": {
            "type": "string",
            "title": "user_id"
          }
        },
        "title": "GrantPortAccessRequest",
        "additionalProperties": false,
        "description": "Granting and revoking are separate from SetPortAccess because they answer a different\n question - who, rather than how many - and because revoking one person must not be\n expressible as \"send the list again minus one\", which loses a race with a second grant."
      },
      "spin.v1.GrantPortAccessResponse": {
        "type": "object",
        "properties": {
          "exposedPort": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.ExposedPort"
              }
            ],
            "title": "exposed_port"
          }
        },
        "title": "GrantPortAccessResponse",
        "additionalProperties": false
      },
      "spin.v1.GrantWorkspaceResourcesRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "cpuCores": {
            "type": "integer",
            "title": "cpu_cores",
            "format": "int32"
          },
          "memoryMb": {
            "type": "integer",
            "title": "memory_mb",
            "format": "int32"
          },
          "lasts": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Duration"
              }
            ],
            "title": "lasts",
            "description": "How long the grant lasts before it is given back on its own, from now: at least a minute.\n Unset keeps it until it is given back. Each grant says it anew: one that says nothing about\n time is kept, whatever the one before it said."
          },
          "move": {
            "type": "boolean",
            "title": "move",
            "description": "move says what to do when a running workspace's host has no room for the grant: move it to\n a host that has - suspended where it runs, its processes as they are, and resumed there from\n the checkpoint. The guest is paused from the checkpoint until it runs on the other host, which\n takes as long as storing its memory and publishing its disk. Without it such a grant is\n refused."
          }
        },
        "title": "GrantWorkspaceResourcesRequest",
        "additionalProperties": false,
        "description": "SetWorkspaceNetworkTagsRequest is the whole set a workspace should run under, not an\n addition: a request naming one tag leaves it carrying that one. Naming none means what it\n means on a create - the installation's default, and \"offline\" where it declares none - so\n there is one reading of an empty list rather than two nobody would keep straight. To ask for\n a workspace that reaches nothing, name \"offline\".\n\n Who may ask what: the workspace's owner chooses among the policies the installation\n declares, which are the same ones they could have created it with; an administrator may\n name any policy a host reports. Nothing inside the guest can ask at all - a workspace's own\n credential does not reach this, because loosening the egress of the sandbox you are in is\n the first thing something that got in would try.\n GrantWorkspaceResourcesRequest is what the workspace holds of its own from now on: at least its\n floor, and at most its ceiling where its preset has one (to_host has none but its host's room).\n Zero keeps what it holds of that one."
      },
      "spin.v1.GrantWorkspaceResourcesResponse": {
        "type": "object",
        "properties": {
          "workspace": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.Workspace"
              }
            ],
            "title": "workspace"
          }
        },
        "title": "GrantWorkspaceResourcesResponse",
        "additionalProperties": false
      },
      "spin.v1.HeaderInjection": {
        "type": "object",
        "properties": {
          "header": {
            "type": "string",
            "title": "header"
          },
          "secret": {
            "type": "string",
            "title": "secret",
            "description": "The team secret's name."
          },
          "prefix": {
            "type": "string",
            "title": "prefix",
            "description": "What goes before the value, as \"Bearer \"."
          },
          "identity": {
            "type": "string",
            "title": "identity",
            "description": "The audience of a token of the workspace's identity, issued for the proxy to present: bound\n to no key, and saying so (spin.via = egress-proxy)."
          },
          "forge": {
            "type": "string",
            "title": "forge",
            "description": "The forge whose credential goes in the header, whole: \"github\" is the workspace owner's own\n token, connected through the installation's OAuth App (ForgeService), which the control plane\n keeps and refreshes."
          },
          "methods": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "methods",
            "description": "The requests the header is set on: these methods, and paths under path_prefix by whole\n segments. Another request to the rule's names is answered 403. None of either is every request."
          },
          "pathPrefix": {
            "type": "string",
            "title": "path_prefix"
          }
        },
        "title": "HeaderInjection",
        "additionalProperties": false,
        "description": "HeaderInjection is a header the egress proxy sets: header, to prefix and then a value the\n workspace never holds - a team secret's, or a token of the workspace's identity. One of the two."
      },
      "spin.v1.HealthCheck": {
        "type": "object",
        "properties": {
          "part": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.HealthPart"
              }
            ],
            "title": "part"
          },
          "status": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.HealthStatus"
              }
            ],
            "title": "status"
          },
          "reason": {
            "type": "string",
            "title": "reason",
            "description": "reason says in a line what was found, OK or not."
          },
          "knownAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "known_at",
            "description": "known_at is when what decided the status was so: the moment it was asked for a part asked\n now, the collector's last report, the last WAL file archived or failed, a failed job's run."
          },
          "problems": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.Problem"
            },
            "title": "problems",
            "description": "What is wrong in this part, each on its own: one per host, one per job, one for a part that is\n a single thing. Empty while the part is OK. At most 20 are listed, the worst first;\n problem_count is how many there are."
          },
          "problemCount": {
            "type": "integer",
            "title": "problem_count",
            "format": "int32"
          }
        },
        "title": "HealthCheck",
        "additionalProperties": false,
        "description": "HealthCheck is one part of the installation as the control plane knows it."
      },
      "spin.v1.HealthCheckResult": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "title": "name"
          },
          "passed": {
            "type": "boolean",
            "title": "passed"
          },
          "value": {
            "type": "string",
            "title": "value",
            "description": "Actual value from check"
          },
          "message": {
            "type": "string",
            "title": "message",
            "description": "Error message if failed"
          }
        },
        "title": "HealthCheckResult",
        "additionalProperties": false
      },
      "spin.v1.HealthPart": {
        "type": "string",
        "title": "HealthPart",
        "enum": [
          "HEALTH_PART_UNSPECIFIED",
          "HEALTH_PART_DATABASE",
          "HEALTH_PART_DATABASE_ARCHIVE",
          "HEALTH_PART_LOG_STORE",
          "HEALTH_PART_COLLECTOR",
          "HEALTH_PART_JOBS",
          "HEALTH_PART_HOSTS",
          "HEALTH_PART_WAITING_WORKSPACES"
        ],
        "description": "HealthPart is which part of the installation a check is of.\n\n- `HEALTH_PART_DATABASE`: The control plane's database answers a query.\n- `HEALTH_PART_DATABASE_ARCHIVE`: The database's continuous archive keeps up: its last WAL file sent and how many wait. Its base\n  backups are taken by a timer outside the control plane, which records nothing it can read.\n- `HEALTH_PART_LOG_STORE`: The log store (Quickwit) beside the control plane answers that it is ready.\n- `HEALTH_PART_COLLECTOR`: The collector sends what it is given: spans to the trace store, samples to the metric store\n  (GetTelemetryStatus). It is what says whether the metric store takes writes - the control\n  plane is not one of the metric store's readers.\n- `HEALTH_PART_JOBS`: The control plane's periodic work: a job whose last run failed (ListJobs).\n- `HEALTH_PART_HOSTS`: The hosts registered and not taken out of the fleet: those whose command stream is not up,\n  and those that answer and fail a check of their own (HostCheck).\n- `HEALTH_PART_WAITING_WORKSPACES`: Workspaces waiting for a runner, across the whole fleet.",
        "x-enum-descriptions": [
          "",
          "The control plane's database answers a query.",
          "The database's continuous archive keeps up: its last WAL file sent and how many wait. Its base\n backups are taken by a timer outside the control plane, which records nothing it can read.",
          "The log store (Quickwit) beside the control plane answers that it is ready.",
          "The collector sends what it is given: spans to the trace store, samples to the metric store\n (GetTelemetryStatus). It is what says whether the metric store takes writes - the control\n plane is not one of the metric store's readers.",
          "The control plane's periodic work: a job whose last run failed (ListJobs).",
          "The hosts registered and not taken out of the fleet: those whose command stream is not up,\n and those that answer and fail a check of their own (HostCheck).",
          "Workspaces waiting for a runner, across the whole fleet."
        ]
      },
      "spin.v1.HealthReport": {
        "type": "object",
        "properties": {
          "healthy": {
            "type": "boolean",
            "title": "healthy"
          },
          "checks": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.HealthCheckResult"
            },
            "title": "checks"
          }
        },
        "title": "HealthReport",
        "additionalProperties": false,
        "description": "HealthReport is what the supervisor inside a workspace observes about it. Here rather\n than beside the stream that carries it, for the reason SupervisorState is here: it is\n read from both sides - reported by the supervisor on its own connection\n (spin.agent.v1), and returned to an operator by WorkspaceService.GetWorkspaceStatus.\n\n It is also what keeps the dependency between the two packages pointing one way.\n spin.v1 is the vocabulary and spin.agent.v1 is the machine surface built on it; a type\n the operator's side needs from the agent's side would make each package need the other."
      },
      "spin.v1.HealthStatus": {
        "type": "string",
        "title": "HealthStatus",
        "enum": [
          "HEALTH_STATUS_UNSPECIFIED",
          "HEALTH_STATUS_OK",
          "HEALTH_STATUS_DEGRADED",
          "HEALTH_STATUS_FAILED"
        ],
        "description": "- `HEALTH_STATUS_DEGRADED`: Working, and something in it wants a look: some hosts not connected, a job's last run failed,\n  a workspace waiting longer than a machine takes to boot.\n- `HEALTH_STATUS_FAILED`: Not doing what it is for: the database does not answer, the archive's last send failed, no\n  host is connected.",
        "x-enum-descriptions": [
          "",
          "",
          "Working, and something in it wants a look: some hosts not connected, a job's last run failed,\n a workspace waiting longer than a machine takes to boot.",
          "Not doing what it is for: the database does not answer, the archive's last send failed, no\n host is connected."
        ]
      },
      "spin.v1.HistogramLogsResponse": {
        "type": "object",
        "properties": {
          "intervals": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.LogInterval"
            },
            "title": "intervals"
          }
        },
        "title": "HistogramLogsResponse",
        "additionalProperties": false
      },
      "spin.v1.HistogramPlatformLogsRequest": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "title": "query"
          },
          "from": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "from"
          },
          "to": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "to"
          },
          "intervals": {
            "type": "integer",
            "title": "intervals",
            "format": "int32",
            "description": "How many intervals to split the window into: 1 to 200, 60 when unset. Each is at least a\n second."
          }
        },
        "title": "HistogramPlatformLogsRequest",
        "additionalProperties": false
      },
      "spin.v1.HistogramWorkspaceLogsRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "query": {
            "type": "string",
            "title": "query"
          },
          "from": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "from"
          },
          "to": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "to"
          },
          "intervals": {
            "type": "integer",
            "title": "intervals",
            "format": "int32"
          }
        },
        "title": "HistogramWorkspaceLogsRequest",
        "additionalProperties": false
      },
      "spin.v1.HistogramWorkspaceLogsResponse": {
        "type": "object",
        "properties": {
          "intervals": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.LogInterval"
            },
            "title": "intervals"
          }
        },
        "title": "HistogramWorkspaceLogsResponse",
        "additionalProperties": false
      },
      "spin.v1.Host": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          },
          "address": {
            "type": "string",
            "title": "address"
          },
          "state": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.HostState"
              }
            ],
            "title": "state"
          },
          "capacity": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.Resources"
              }
            ],
            "title": "capacity"
          },
          "allocated": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.Resources"
              }
            ],
            "title": "allocated"
          },
          "workspaceCount": {
            "type": "integer",
            "title": "workspace_count",
            "format": "int32"
          },
          "agentVersion": {
            "type": "string",
            "title": "agent_version"
          },
          "labels": {
            "type": "object",
            "title": "labels",
            "additionalProperties": {
              "type": "string",
              "title": "value"
            }
          },
          "lastHeartbeat": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "last_heartbeat",
            "description": "last_heartbeat is whichever of this host's two channels was heard from last, and they are\n not the same thing: the command stream carries what the host can be *told* (start this,\n stop that), and the volume agent's own heartbeat renews the lease its disks are served\n under. Either refreshes this, so a fresh stamp says one of them is alive and not which:\n stream_heard_at and lease_renewed_at are each on its own. It is what the sweep that forgets\n a host gone for good reads."
          },
          "registeredAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "registered_at"
          },
          "connected": {
            "type": "boolean",
            "title": "connected",
            "description": "connected is the command stream, now: the half that decides whether this host can be given\n a workspace or asked to stop one. A host whose stream is gone while its volume agent keeps\n renewing reads as freshly heartbeated above and can be told nothing at all - which is the\n state an operator is looking at when they ask why a host takes no work."
          },
          "goingAway": {
            "type": "boolean",
            "title": "going_away",
            "description": "going_away is this host on its way out: a runner told the control plane it is stopping -\n an operator's restart, or the cloud taking the machine away - and it takes no new\n workspace from that moment. Nothing is written to the database for it (a state there would\n outlive the restart it described), so this is the only place an operator can see that the\n host they are looking at is leaving rather than idle."
          },
          "checks": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.HostCheck"
            },
            "title": "checks",
            "description": "checks are what the host last found when it asked itself whether a workspace can run on it\n as it should, as its heartbeat said: held for as long as the host is connected, like\n going_away, and empty for a host that has said nothing yet."
          },
          "hostClass": {
            "type": "string",
            "title": "host_class",
            "description": "host_class is the class (HostClass.name) of the group that launched the machine, which ties\n the host to its FleetClass: \"default\" for a machine no group launched."
          },
          "machineVersion": {
            "type": "string",
            "title": "machine_version",
            "description": "machine_version is the spin-machine release the host registered (its QEMU, kernel and\n firmware); empty for a host with no machine."
          },
          "detected": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.Resources"
              }
            ],
            "title": "detected",
            "description": "detected is what the host found it has when it last registered (cores, memory, disk GB),\n beside capacity, which is what it advertises: a HostPolicy capacity holds a machine back by\n saying it has less. Zero for a host that has not registered since it was made."
          },
          "streamHeardAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "stream_heard_at",
            "description": "Each channel on its own. stream_heard_at is the command stream's last heartbeat the control\n plane recorded - unset for a host that never held one - and lease_renewed_at the volume\n agent's last renewal of the lease its disks are served under, unset for one that never held\n a lease. A host whose stream is gone while its lease renews serves its disks and can be\n told nothing."
          },
          "leaseRenewedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "lease_renewed_at"
          },
          "connectedChangedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "connected_changed_at",
            "description": "connected_changed_at is when connected last changed, as this control plane saw it: the\n stream registering while connected, its end while not. Unset where this control plane has\n seen neither since it started - stream_heard_at then says when the host was last heard.\n Held in memory, as connected is: a control plane that restarts starts again."
          },
          "streamEnd": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.HostStreamEnd"
              }
            ],
            "title": "stream_end",
            "description": "Why the host's last command stream ended, while it is not connected; UNSPECIFIED while it is\n connected, and where this control plane has not seen one end. stream_end_detail is the error\n the stream ended with, in its own words."
          },
          "streamEndDetail": {
            "type": "string",
            "title": "stream_end_detail"
          },
          "hostname": {
            "type": "string",
            "title": "hostname",
            "description": "hostname is the name the host's machine goes by, as it last registered it: how a person tells\n one host from another where its id says nothing. Empty for a host that has not registered\n since it was made."
          },
          "removal": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.HostRemoval"
              }
            ],
            "title": "removal",
            "description": "removal is how this host leaves the fleet, decided by where it came from: the only removal\n the API takes for it, so the dashboard offers that one and no other."
          },
          "removalRefused": {
            "type": "string",
            "title": "removal_refused",
            "description": "removal_refused is why that removal cannot run now - a workspace whose disk is there - in\n words an administrator acts on; empty while it can."
          },
          "keysGiven": {
            "type": "integer",
            "title": "keys_given",
            "format": "int32",
            "description": "keys_given is how many teams' disks this host was given the key of: what revoking it, or\n removing it as taken, marks for re-keying."
          },
          "machineId": {
            "type": "string",
            "title": "machine_id",
            "description": "Where the host's machine is, as its cloud said when the host joined - never as the host said\n of itself: the machine's id and type as that cloud names them, its zone and its region. Each\n empty for a host that joined with no cloud (a registration token: a development stack, a\n machine of one's own), and for what its cloud did not say."
          },
          "machineType": {
            "type": "string",
            "title": "machine_type"
          },
          "zone": {
            "type": "string",
            "title": "zone"
          },
          "region": {
            "type": "string",
            "title": "region"
          },
          "reclaimable": {
            "type": [
              "boolean",
              "null"
            ],
            "title": "reclaimable",
            "description": "reclaimable is whether the cloud may take the machine back, as its cloud said of the instance\n when it joined - a spot machine is, whatever its class says: a group that fell back to\n on-demand, or one whose class was changed, starts machines its class does not describe. Unset\n where nothing says: a host that joined with no cloud, or one its cloud named nothing of."
          },
          "holders": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.HostHolder"
            },
            "title": "holders",
            "description": "holders is what keeps this host in the fleet, from the database: the workspaces whose disk is\n only here - whichever list of theirs leaves them out, a prebuild's build, a team's, another\n person's, a failed one - and the volumes still here that are no such workspace's disk, a\n trashed workspace's or an agent's home, each of which forgetting the host must detach first.\n At most 10; holder_count is how many there are."
          },
          "holderCount": {
            "type": "integer",
            "title": "holder_count",
            "format": "int32"
          }
        },
        "title": "Host",
        "additionalProperties": false
      },
      "spin.v1.HostCheck": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "title": "name",
            "description": "name is what was checked: clock, kvm, resolver."
          },
          "ok": {
            "type": "boolean",
            "title": "ok"
          },
          "detail": {
            "type": "string",
            "title": "detail",
            "description": "detail is what it found when it is not ok, in the host's words."
          },
          "checkedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "checked_at"
          }
        },
        "title": "HostCheck",
        "additionalProperties": false,
        "description": "HostCheck is one thing a host asks itself about, at start and every few minutes: a clock that\n is not synchronised, a KVM it cannot open, a resolver that answers its workspaces nothing - each\n a host that looks healthy to every other signal and fails its workspaces."
      },
      "spin.v1.HostClass": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "title": "name",
            "description": "Lower-case letters, digits and -, a letter first, up to 31: it is part of the group's name."
          },
          "description": {
            "type": "string",
            "title": "description"
          },
          "instanceTypes": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "instance_types",
            "description": "The instance types it may be, as the cloud names them, patterns allowed (\"c8id.*\"); none is\n any type the rest admits."
          },
          "vcpusMin": {
            "type": "integer",
            "title": "vcpus_min",
            "format": "int32"
          },
          "vcpusMax": {
            "type": "integer",
            "title": "vcpus_max",
            "format": "int32"
          },
          "memoryMibPerVcpu": {
            "type": "integer",
            "title": "memory_mib_per_vcpu",
            "format": "int32",
            "description": "The least memory a vCPU of it has, in MiB; 0 is 2048."
          },
          "spot": {
            "type": "boolean",
            "title": "spot",
            "description": "A machine the cloud may take back (each host drains first), or an on-demand one."
          },
          "maxHosts": {
            "type": "integer",
            "title": "max_hosts",
            "format": "int32",
            "description": "The most hosts of it; 0 is no limit of its own (the setting autoscaling_max_hosts\n bounds them all)."
          },
          "fallbackOnDemand": {
            "type": "boolean",
            "title": "fallback_on_demand",
            "description": "A spot class whose group the cloud refuses spot machines for capacity starts on-demand ones\n for a while, and then spot again (FleetClass.on_demand_until); spot itself is not changed.\n Off, the class's workspaces wait until somebody changes spot. Only a spot class has it."
          }
        },
        "title": "HostClass",
        "additionalProperties": false,
        "description": "A kind of runner: the shape of the machines a group of the installation's cloud starts for it,\n which the control plane makes and sizes. What a machine boots is the installation's launch\n template, never this. \"default\" is the class a preset that names none runs on."
      },
      "spin.v1.HostDeparture": {
        "type": "object",
        "properties": {
          "workspaces": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.WorkspaceDeparture"
            },
            "title": "workspaces",
            "description": "At most 20, the running first; count is how many there are."
          },
          "count": {
            "type": "integer",
            "title": "count",
            "format": "int32"
          }
        },
        "title": "HostDeparture",
        "additionalProperties": false,
        "description": "HostDeparture is what draining the host, and removing it as Host.removal says, would do to each\n workspace that names it - the ones a drain moves, the ones that stay, the ones that lose their\n place on it and the ones that hold it - so the confirmation says it before it is done."
      },
      "spin.v1.HostHolder": {
        "type": "object",
        "properties": {
          "kind": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.HostHolderKind"
              }
            ],
            "title": "kind"
          },
          "workspaceId": {
            "type": "string",
            "title": "workspace_id",
            "description": "The workspace it is or was the disk of; for an agent's home, the workspace that mounts it, or\n that last did by name alone (workspace_id empty)."
          },
          "workspaceName": {
            "type": "string",
            "title": "workspace_name"
          },
          "volumeId": {
            "type": "string",
            "title": "volume_id",
            "description": "The volume, for a holder that is a volume (a trashed workspace's disk, an agent's home); empty\n for a workspace, whose disk the workspace names."
          },
          "ownerId": {
            "type": "string",
            "title": "owner_id",
            "description": "Whose it is."
          },
          "ownerEmail": {
            "type": "string",
            "title": "owner_email"
          },
          "state": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.WorkspaceState"
              }
            ],
            "title": "state",
            "description": "The workspace's state; UNSPECIFIED for an agent's home no workspace mounts."
          },
          "lastEvent": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.WorkspaceEventType"
              }
            ],
            "title": "last_event",
            "description": "What last happened to the workspace, and when: its history's newest entry. UNSPECIFIED and\n unset where it has none."
          },
          "lastEventAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "last_event_at"
          }
        },
        "title": "HostHolder",
        "additionalProperties": false,
        "description": "HostHolder is one thing a host holds that its removal would lose or has to wait for, with\n whose it is and what last happened to it."
      },
      "spin.v1.HostHolderKind": {
        "type": "string",
        "title": "HostHolderKind",
        "enum": [
          "HOST_HOLDER_KIND_UNSPECIFIED",
          "HOST_HOLDER_KIND_WORKSPACE",
          "HOST_HOLDER_KIND_TEAM_WORKSPACE",
          "HOST_HOLDER_KIND_PREBUILD_BUILD",
          "HOST_HOLDER_KIND_TRASHED_WORKSPACE",
          "HOST_HOLDER_KIND_AGENT_HOME"
        ],
        "description": "HostHolderKind is what a holder is, which says which list of whose shows it.\n\n- `HOST_HOLDER_KIND_WORKSPACE`: A person's own workspace, in their workspaces list.\n- `HOST_HOLDER_KIND_TEAM_WORKSPACE`: A workspace of a team, in its members' lists.\n- `HOST_HOLDER_KIND_PREBUILD_BUILD`: A prebuild's build: kept stopped as its prebuild's anchor, and in nobody's list.\n- `HOST_HOLDER_KIND_TRASHED_WORKSPACE`: The disk of a workspace in its owner's trash.\n- `HOST_HOLDER_KIND_AGENT_HOME`: A person's agent's home (AgentVolume).",
        "x-enum-descriptions": [
          "",
          "A person's own workspace, in their workspaces list.",
          "A workspace of a team, in its members' lists.",
          "A prebuild's build: kept stopped as its prebuild's anchor, and in nobody's list.",
          "The disk of a workspace in its owner's trash.",
          "A person's agent's home (AgentVolume)."
        ]
      },
      "spin.v1.HostNetworkPolicy": {
        "type": "object",
        "properties": {
          "hostId": {
            "type": "string",
            "title": "host_id"
          },
          "rules": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.NetworkRule"
            },
            "title": "rules"
          }
        },
        "title": "HostNetworkPolicy",
        "additionalProperties": false
      },
      "spin.v1.HostPolicy": {
        "type": "object",
        "properties": {
          "hostId": {
            "type": "string",
            "title": "host_id"
          },
          "shutdownGraceSeconds": {
            "type": [
              "integer",
              "null"
            ],
            "title": "shutdown_grace_seconds",
            "format": "int32",
            "description": "Seconds this host stays up after a stop signal so what it runs can be suspended off it.\n The unit's TimeoutStopSec still bounds it."
          },
          "preemptible": {
            "type": [
              "boolean",
              "null"
            ],
            "title": "preemptible",
            "description": "Whether a stop here is the machine being taken away rather than coming back."
          },
          "preemptionSource": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PreemptionSource"
              },
              {
                "type": "null"
              }
            ],
            "title": "preemption_source",
            "description": "Which cloud announces that reclaim; setting one implies preemptible."
          },
          "preemptionMetadataUrl": {
            "type": [
              "string",
              "null"
            ],
            "title": "preemption_metadata_url",
            "description": "That service's address, for a private cloud or a test."
          },
          "capacityCpuCores": {
            "type": [
              "integer",
              "null"
            ],
            "title": "capacity_cpu_cores",
            "format": "int32",
            "description": "What this host advertises to the fleet, which is not what it has: an operator holds a\n machine back by saying it has less. Unset leaves the host advertising what it detects."
          },
          "capacityMemoryMb": {
            "type": [
              "integer",
              "null"
            ],
            "title": "capacity_memory_mb",
            "format": "int32"
          },
          "capacityDiskGb": {
            "type": [
              "integer",
              "null"
            ],
            "title": "capacity_disk_gb",
            "format": "int32"
          },
          "maxWorkspaceCpuCores": {
            "type": [
              "integer",
              "null"
            ],
            "title": "max_workspace_cpu_cores",
            "format": "int32",
            "description": "The ceiling one workspace may grow to here, for the machines it starts afterwards."
          },
          "maxWorkspaceMemoryMb": {
            "type": [
              "integer",
              "null"
            ],
            "title": "max_workspace_memory_mb",
            "format": "int32"
          },
          "revision": {
            "type": "string",
            "title": "revision",
            "description": "revision names the content, and is what a host reports it is running under."
          },
          "writebackLimitBytes": {
            "type": [
              "string",
              "null"
            ],
            "title": "writeback_limit_bytes",
            "format": "int64",
            "description": "The host's writeback thresholds (spin.agent.v1.HostPolicy says why): both or neither, the\n background below the limit. Unset is what the host booted with."
          },
          "writebackBackgroundBytes": {
            "type": [
              "string",
              "null"
            ],
            "title": "writeback_background_bytes",
            "format": "int64"
          },
          "runningRevision": {
            "type": "string",
            "title": "running_revision",
            "description": "running_revision is what the host last said, empty where it has not said or is not\n connected. Different from revision is a policy still on its way, which is normal for the\n seconds after a write and a fault after that."
          },
          "maxWorkspaceIoMbPerSecond": {
            "type": [
              "integer",
              "null"
            ],
            "title": "max_workspace_io_mb_per_second",
            "format": "int32",
            "description": "What one machine may read and write per second here, in MiB and in operations, for the\n machines it starts afterwards. Unset is no bound."
          },
          "maxWorkspaceIoOpsPerSecond": {
            "type": [
              "integer",
              "null"
            ],
            "title": "max_workspace_io_ops_per_second",
            "format": "int32"
          }
        },
        "title": "HostPolicy",
        "additionalProperties": false,
        "description": "HostPolicy is what an installation decides about one host. An unset field is the\n installation saying nothing about that setting, which leaves the host on its own default -\n not the same as setting it to nothing."
      },
      "spin.v1.HostRemoval": {
        "type": "string",
        "title": "HostRemoval",
        "enum": [
          "HOST_REMOVAL_UNSPECIFIED",
          "HOST_REMOVAL_REVOKE",
          "HOST_REMOVAL_GIVE_BACK",
          "HOST_REMOVAL_FORGET"
        ],
        "description": "HostRemoval is how a host leaves the fleet.\n\n- `HOST_REMOVAL_REVOKE`: A host registered with a token, or a machine of a cloud no group of this installation sizes:\n  RevokeRunner. Nothing else can take its machine away.\n- `HOST_REMOVAL_GIVE_BACK`: A machine of an autoscaling group, connected: RemoveHost gives it back to its group, which\n  terminates it and is asked for one less. Revoking it would leave the machine running and\n  paid for, in a group that counts it.\n- `HOST_REMOVAL_FORGET`: A machine of an autoscaling group, not connected: RemoveHost gives back a machine the group\n  still has, and forgets the host now rather than once it has been silent for\n  host_forget_after_hours.",
        "x-enum-descriptions": [
          "",
          "A host registered with a token, or a machine of a cloud no group of this installation sizes:\n RevokeRunner. Nothing else can take its machine away.",
          "A machine of an autoscaling group, connected: RemoveHost gives it back to its group, which\n terminates it and is asked for one less. Revoking it would leave the machine running and\n paid for, in a group that counts it.",
          "A machine of an autoscaling group, not connected: RemoveHost gives back a machine the group\n still has, and forgets the host now rather than once it has been silent for\n host_forget_after_hours."
        ]
      },
      "spin.v1.HostShell": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          },
          "hostId": {
            "type": "string",
            "title": "host_id"
          },
          "requestedBy": {
            "type": "string",
            "title": "requested_by",
            "description": "Who asked, and who approved: an email, or empty for a person no longer on the installation.\n Approved by nobody where the installation asks for no second administrator."
          },
          "approvedBy": {
            "type": "string",
            "title": "approved_by"
          },
          "reason": {
            "type": "string",
            "title": "reason"
          },
          "incident": {
            "type": "boolean",
            "title": "incident",
            "description": "An incident's shell opens on a host still running workspaces."
          },
          "minutes": {
            "type": "integer",
            "title": "minutes",
            "format": "int32",
            "description": "How long it is open once it opens."
          },
          "state": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.HostShellState"
              }
            ],
            "title": "state"
          },
          "requestedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "requested_at"
          },
          "approvedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "approved_at"
          },
          "openedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "opened_at"
          },
          "closesAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "closes_at"
          },
          "endedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "ended_at"
          },
          "ended": {
            "type": "string",
            "title": "ended",
            "description": "How it ended, in words."
          },
          "hostRetired": {
            "type": "boolean",
            "title": "host_retired",
            "description": "Whether its host has been retired since: revoked, its disks marked to be re-keyed, and given\n back to its group where it has one."
          },
          "running": {
            "type": "integer",
            "title": "running",
            "format": "int32",
            "description": "How many workspaces the host still runs, while it is emptied."
          }
        },
        "title": "HostShell",
        "additionalProperties": false
      },
      "spin.v1.HostShellState": {
        "type": "string",
        "title": "HostShellState",
        "enum": [
          "HOST_SHELL_STATE_UNSPECIFIED",
          "HOST_SHELL_STATE_REQUESTED",
          "HOST_SHELL_STATE_EMPTYING",
          "HOST_SHELL_STATE_OPEN",
          "HOST_SHELL_STATE_ENDED",
          "HOST_SHELL_STATE_REFUSED"
        ],
        "description": "- `HOST_SHELL_STATE_REQUESTED`: Asked for, waiting for a second administrator.\n- `HOST_SHELL_STATE_EMPTYING`: Approved: the host is cordoned and its workspaces are being suspended to run elsewhere.\n- `HOST_SHELL_STATE_OPEN`: Open: a terminal may attach until closes_at.\n- `HOST_SHELL_STATE_ENDED`: Over: closed, or past its time. Its host is retired.\n- `HOST_SHELL_STATE_REFUSED`: Refused, or withdrawn before it was approved. Its host was never touched.",
        "x-enum-descriptions": [
          "",
          "Asked for, waiting for a second administrator.",
          "Approved: the host is cordoned and its workspaces are being suspended to run elsewhere.",
          "Open: a terminal may attach until closes_at.",
          "Over: closed, or past its time. Its host is retired.",
          "Refused, or withdrawn before it was approved. Its host was never touched."
        ]
      },
      "spin.v1.HostState": {
        "type": "string",
        "title": "HostState",
        "enum": [
          "HOST_STATE_UNSPECIFIED",
          "HOST_STATE_ACTIVE",
          "HOST_STATE_CORDONED",
          "HOST_STATE_DRAINING",
          "HOST_STATE_DEAD"
        ],
        "description": "HostState mirrors internal/lifecycle.HostState (§28.1) and the CHECK on hosts.state:\n one vocabulary for the fleet, whichever component is asking. Only ACTIVE takes new\n work; a CORDONED or DRAINING host keeps serving (and keeps its lease) while it is\n evacuated, and the Agent needs to be told which of the two it is.\n\n It replaces a second set of names this schema carried for the same states - HEALTHY,\n DEGRADED, OFFLINE - where DEGRADED was a word nothing branched on and no name said\n \"an operator stopped this host\"."
      },
      "spin.v1.HostStreamEnd": {
        "type": "string",
        "title": "HostStreamEnd",
        "enum": [
          "HOST_STREAM_END_UNSPECIFIED",
          "HOST_STREAM_END_HOST_CLOSED",
          "HOST_STREAM_END_LOST",
          "HOST_STREAM_END_CONTROL_PLANE_CLOSED",
          "HOST_STREAM_END_TOO_FAST",
          "HOST_STREAM_END_REFUSED_RELEASE",
          "HOST_STREAM_END_ERROR"
        ],
        "description": "HostStreamEnd is why a host's command stream ended.\n\n- `HOST_STREAM_END_HOST_CLOSED`: The host closed it: a runner stopping or restarting.\n- `HOST_STREAM_END_LOST`: The connection went without the host closing it: a network fault, a runner killed, a\n  machine that went away, a transport that timed out.\n- `HOST_STREAM_END_CONTROL_PLANE_CLOSED`: The control plane closed it: the host was revoked, or a newer stream of it replaced this one.\n- `HOST_STREAM_END_TOO_FAST`: The host sent far faster than any runner does, and was cut off.\n- `HOST_STREAM_END_REFUSED_RELEASE`: Its registration was refused: the host runs another release than the control plane's.\n- `HOST_STREAM_END_ERROR`: Its registration could not be recorded, or the stream failed in a way none of the above says.",
        "x-enum-descriptions": [
          "",
          "The host closed it: a runner stopping or restarting.",
          "The connection went without the host closing it: a network fault, a runner killed, a\n machine that went away, a transport that timed out.",
          "The control plane closed it: the host was revoked, or a newer stream of it replaced this one.",
          "The host sent far faster than any runner does, and was cut off.",
          "Its registration was refused: the host runs another release than the control plane's.",
          "Its registration could not be recorded, or the stream failed in a way none of the above says."
        ]
      },
      "spin.v1.IdentityProvider": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id",
            "description": "\"github\" for built-in, UUIDv7 for dynamic"
          },
          "name": {
            "type": "string",
            "title": "name",
            "description": "Display name (e.g., \"Sign in with Okta\")"
          },
          "providerType": {
            "type": "string",
            "title": "provider_type",
            "description": "github (built-in), oidc, google, azure-ad"
          },
          "teamId": {
            "type": "string",
            "title": "team_id",
            "description": "Empty if system-wide provider"
          },
          "isDefault": {
            "type": "boolean",
            "title": "is_default",
            "description": "True for built-in GitHub provider"
          }
        },
        "title": "IdentityProvider",
        "additionalProperties": false,
        "description": "Identity provider info (returned to clients for login UI)\n Built-in provider has id=\"github\"; dynamic providers have UUIDv7 IDs"
      },
      "spin.v1.Image": {
        "type": "object",
        "properties": {
          "ref": {
            "type": "string",
            "title": "ref",
            "description": "The name a workspace asks for. It moves: a publish under it tags new bytes, and what a disk\n began as is its volume's parent snapshot, not this."
          },
          "virtualSizeBytes": {
            "type": "string",
            "title": "virtual_size_bytes",
            "format": "int64",
            "description": "What the disk cloned from it will hold before the workspace writes anything."
          },
          "publishedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "published_at",
            "description": "When the publication this ref resolves to was made."
          },
          "name": {
            "type": "string",
            "title": "name",
            "description": "What a person choosing a disk is shown: its name (\"base image\") and what it is ready for.\n An empty name is a publication made before one was asked for; show the ref."
          },
          "description": {
            "type": "string",
            "title": "description"
          }
        },
        "title": "Image",
        "additionalProperties": false,
        "description": "Image is one name a workspace can be created from: a publication in this installation's\n database that its settings also permit. It is not a container image and does not come from a\n registry - it is a volume somebody published here, which is why a name that looks like\n \"ubuntu:22.04\" is not one unless it was published under that name.\n A disk image a workspace's disk can be cloned from: a volume published in this installation,\n not a container image, and never pulled from a registry."
      },
      "spin.v1.InjectionStatus": {
        "type": "object",
        "properties": {
          "policy": {
            "type": "string",
            "title": "policy",
            "description": "The policy, by name, and the names its rule brokers."
          },
          "names": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "names"
          },
          "header": {
            "type": "string",
            "title": "header"
          },
          "from": {
            "type": "string",
            "title": "from",
            "description": "What the header is set from: a team secret by name, \"\u003cforge\u003e app\", or \"identity for\n \u003caudience\u003e\"."
          },
          "held": {
            "type": "boolean",
            "title": "held",
            "description": "Whether the team holds it: the secret is set, the forge app is set, an identity is always\n held. False is a request refused with credentials."
          }
        },
        "title": "InjectionStatus",
        "additionalProperties": false,
        "description": "InjectionStatus is one header the egress proxy sets on the workspace's requests to a brokered\n name, and whether the workspace's team holds what it is set from."
      },
      "spin.v1.InstallationEventType": {
        "type": "string",
        "title": "InstallationEventType",
        "enum": [
          "INSTALLATION_EVENT_TYPE_UNSPECIFIED",
          "INSTALLATION_EVENT_TYPE_ALERT_FIRING",
          "INSTALLATION_EVENT_TYPE_ALERT_RESOLVED"
        ],
        "description": "What happened to the installation itself, which its administrators are told of: an event of no\n workspace, recorded where the control plane hears it.\n\n- `INSTALLATION_EVENT_TYPE_ALERT_FIRING`: One of the release's alert rules fired in the installation's Grafana\n- `INSTALLATION_EVENT_TYPE_ALERT_RESOLVED`: A rule that fired is no longer past its threshold",
        "x-enum-descriptions": [
          "",
          "One of the release's alert rules fired in the installation's Grafana",
          "A rule that fired is no longer past its threshold"
        ]
      },
      "spin.v1.InstallationPlace": {
        "type": "object",
        "properties": {
          "provider": {
            "type": "string",
            "title": "provider",
            "description": "The provider the installation was made on, as its document names it: \"aws\", \"self-hosted\"."
          },
          "account": {
            "type": "string",
            "title": "account",
            "description": "The cloud account it runs in, as that cloud names it."
          },
          "region": {
            "type": "string",
            "title": "region"
          },
          "release": {
            "type": "string",
            "title": "release",
            "description": "The release the control plane runs, \"v20261112.01\"."
          },
          "machineImage": {
            "type": "string",
            "title": "machine_image",
            "description": "The machine image the control plane's machine booted, as its cloud names it."
          }
        },
        "title": "InstallationPlace",
        "additionalProperties": false,
        "description": "InstallationPlace is where the installation runs, as its control plane's machine read it once\n when it started - never asked of the cloud again per request - and the release it runs. What\n a cloud did not say, or an installation with no cloud (a development stack, a machine of one's\n own), is empty."
      },
      "spin.v1.Job": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "title": "name"
          },
          "intervalSeconds": {
            "type": "string",
            "title": "interval_seconds",
            "format": "int64",
            "description": "Zero for a job only run by hand, which has no next_run_at."
          },
          "running": {
            "type": "boolean",
            "title": "running"
          },
          "nextRunAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "next_run_at",
            "description": "When the schedule next starts it."
          },
          "lastRun": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.JobRun"
              }
            ],
            "title": "last_run",
            "description": "Unset until it has run on this installation."
          },
          "lastSucceededAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "last_succeeded_at"
          },
          "title": {
            "type": "string",
            "title": "title",
            "description": "The job as a person names it: \"Storage collection\" for storage-gc."
          },
          "does": {
            "type": "string",
            "title": "does",
            "description": "A sentence of what it does."
          },
          "whileFailing": {
            "type": "string",
            "title": "while_failing",
            "description": "What stays undone while it fails, said after \"While it fails, \": \"new workspaces start from\n an older prebuild\". What a failure's verdict says, so whoever reads it knows how soon it\n needs them."
          },
          "recentRuns": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.JobRun"
            },
            "title": "recent_runs",
            "description": "Its newest runs, newest first, at most twenty: what a list of jobs shows each one's recent\n outcomes and durations from, without asking for every job's runs. Each has its id, start,\n end and outcome only; ListJobRuns has the rest."
          }
        },
        "title": "Job",
        "additionalProperties": false
      },
      "spin.v1.JobRun": {
        "type": "object",
        "properties": {
          "runId": {
            "type": "string",
            "title": "run_id"
          },
          "job": {
            "type": "string",
            "title": "job"
          },
          "startedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "started_at"
          },
          "finishedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "finished_at",
            "description": "Unset while it runs."
          },
          "outcome": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.JobRunOutcome"
              }
            ],
            "title": "outcome"
          },
          "counts": {
            "type": "object",
            "title": "counts",
            "additionalProperties": {
              "type": "string",
              "title": "value",
              "format": "int64"
            },
            "description": "What it did, by the job's own names for it: objects deleted, bytes freed, hosts forgotten."
          },
          "error": {
            "type": "string",
            "title": "error",
            "description": "Why it failed; empty when it did not."
          },
          "traceId": {
            "type": "string",
            "title": "trace_id",
            "description": "The run's trace id, which every record it logged carries; empty when it was not recorded.\n Whether the store kept the trace is LogService.KeptTraces's to say."
          },
          "askedBy": {
            "type": "string",
            "title": "asked_by",
            "description": "The admin who ran it by hand; empty for a run the schedule started."
          }
        },
        "title": "JobRun",
        "additionalProperties": false
      },
      "spin.v1.JobRunOutcome": {
        "type": "string",
        "title": "JobRunOutcome",
        "enum": [
          "JOB_RUN_OUTCOME_UNSPECIFIED",
          "JOB_RUN_OUTCOME_RUNNING",
          "JOB_RUN_OUTCOME_SUCCEEDED",
          "JOB_RUN_OUTCOME_FAILED"
        ],
        "description": "How one run of a job ended, or that it has not."
      },
      "spin.v1.KeepWorkspaceRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "lasts": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Duration"
              }
            ],
            "title": "lasts",
            "description": "How long from now it is kept awake: a minute to a day."
          }
        },
        "title": "KeepWorkspaceRequest",
        "additionalProperties": false
      },
      "spin.v1.KeepWorkspaceResponse": {
        "type": "object",
        "properties": {
          "workspace": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.Workspace"
              }
            ],
            "title": "workspace"
          }
        },
        "title": "KeepWorkspaceResponse",
        "additionalProperties": false
      },
      "spin.v1.KeptTracesRequest": {
        "type": "object",
        "properties": {
          "traceIds": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "trace_ids",
            "description": "Hex, as a log record carries them: at most 1000, a page's."
          }
        },
        "title": "KeptTracesRequest",
        "additionalProperties": false
      },
      "spin.v1.KeptTracesResponse": {
        "type": "object",
        "properties": {
          "traceIds": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "trace_ids",
            "description": "Those of the request's the store holds, each once."
          }
        },
        "title": "KeptTracesResponse",
        "additionalProperties": false
      },
      "spin.v1.ListAPIKeysRequest": {
        "type": "object",
        "properties": {
          "page": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PageRequest"
              }
            ],
            "title": "page"
          }
        },
        "title": "ListAPIKeysRequest",
        "additionalProperties": false
      },
      "spin.v1.ListAPIKeysResponse": {
        "type": "object",
        "properties": {
          "apiKeys": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.APIKey"
            },
            "title": "api_keys"
          },
          "page": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PageResponse"
              }
            ],
            "title": "page"
          }
        },
        "title": "ListAPIKeysResponse",
        "additionalProperties": false
      },
      "spin.v1.ListAgentThreadsRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          }
        },
        "title": "ListAgentThreadsRequest",
        "additionalProperties": false
      },
      "spin.v1.ListAgentThreadsResponse": {
        "type": "object",
        "properties": {
          "environmentId": {
            "type": "string",
            "title": "environment_id",
            "description": "environment_id is T3 Code's id for the workspace's server: a thread's page in its web client\n is /\u003cenvironment_id\u003e/\u003cthread id\u003e, served at the port `spin agent` forwards."
          },
          "threads": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.AgentThread"
            },
            "title": "threads",
            "description": "Newest first."
          },
          "reportedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "reported_at",
            "description": "reported_at is when the supervisor last sent the index; unset where it never has - a\n workspace that ran no agent."
          }
        },
        "title": "ListAgentThreadsResponse",
        "additionalProperties": false
      },
      "spin.v1.ListAgentVolumesRequest": {
        "type": "object",
        "title": "ListAgentVolumesRequest",
        "additionalProperties": false
      },
      "spin.v1.ListAgentVolumesResponse": {
        "type": "object",
        "properties": {
          "volumes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.AgentVolume"
            },
            "title": "volumes"
          }
        },
        "title": "ListAgentVolumesResponse",
        "additionalProperties": false
      },
      "spin.v1.ListAlertsRequest": {
        "type": "object",
        "title": "ListAlertsRequest",
        "additionalProperties": false
      },
      "spin.v1.ListAlertsResponse": {
        "type": "object",
        "properties": {
          "alerts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.Alert"
            },
            "title": "alerts"
          }
        },
        "title": "ListAlertsResponse",
        "additionalProperties": false
      },
      "spin.v1.ListAllowedEmailsRequest": {
        "type": "object",
        "properties": {
          "page": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PageRequest"
              }
            ],
            "title": "page"
          }
        },
        "title": "ListAllowedEmailsRequest",
        "additionalProperties": false
      },
      "spin.v1.ListAllowedEmailsResponse": {
        "type": "object",
        "properties": {
          "entries": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.AllowedEmail"
            },
            "title": "entries"
          },
          "page": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PageResponse"
              }
            ],
            "title": "page"
          }
        },
        "title": "ListAllowedEmailsResponse",
        "additionalProperties": false
      },
      "spin.v1.ListAuditLogRequest": {
        "type": "object",
        "properties": {
          "page": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PageRequest"
              }
            ],
            "title": "page"
          },
          "actorId": {
            "type": "string",
            "title": "actor_id",
            "description": "Each filter is optional and they are combined with AND; an empty request is the whole\n log, newest first."
          },
          "action": {
            "type": "string",
            "title": "action"
          },
          "resourceType": {
            "type": "string",
            "title": "resource_type"
          },
          "since": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "since",
            "description": "since bounds the listing at the older end; an audit log is read forward from an\n incident, and the whole of one is not what a page wants."
          },
          "excludeActions": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "exclude_actions",
            "description": "exclude_actions are actions left out: every sign-in of an installation outnumbers what was\n done on it, and the one action filter can name what to see but not what to look past."
          }
        },
        "title": "ListAuditLogRequest",
        "additionalProperties": false
      },
      "spin.v1.ListAuditLogResponse": {
        "type": "object",
        "properties": {
          "entries": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.AuditEntry"
            },
            "title": "entries"
          },
          "page": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PageResponse"
              }
            ],
            "title": "page"
          },
          "actions": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "actions",
            "description": "actions and resource_types are every value this installation can record, so a reader\n building a filter does not have to know them. They come from the code rather than from\n a DISTINCT over the log: the log is the one table that only grows, and a vocabulary\n that is empty until something happens is a filter that is empty when it matters."
          },
          "resourceTypes": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "resource_types"
          },
          "totalCapped": {
            "type": "boolean",
            "title": "total_capped",
            "description": "total_capped says page.total_count is where counting stopped, not the count: the log is\n counted up to a bound, since counting all of it is reading all of it on every page."
          }
        },
        "title": "ListAuditLogResponse",
        "additionalProperties": false
      },
      "spin.v1.ListConfigChangesRequest": {
        "type": "object",
        "title": "ListConfigChangesRequest",
        "additionalProperties": false
      },
      "spin.v1.ListConfigChangesResponse": {
        "type": "object",
        "properties": {
          "changes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.ConfigChange"
            },
            "title": "changes"
          }
        },
        "title": "ListConfigChangesResponse",
        "additionalProperties": false
      },
      "spin.v1.ListConnectionsRequest": {
        "type": "object",
        "title": "ListConnectionsRequest",
        "additionalProperties": false
      },
      "spin.v1.ListConnectionsResponse": {
        "type": "object",
        "properties": {
          "connections": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.ForgeConnection"
            },
            "title": "connections"
          }
        },
        "title": "ListConnectionsResponse",
        "additionalProperties": false
      },
      "spin.v1.ListDeletedWorkspacesRequest": {
        "type": "object",
        "title": "ListDeletedWorkspacesRequest",
        "additionalProperties": false
      },
      "spin.v1.ListDeletedWorkspacesResponse": {
        "type": "object",
        "properties": {
          "workspaces": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.DeletedWorkspace"
            },
            "title": "workspaces"
          },
          "trashDays": {
            "type": "integer",
            "title": "trash_days",
            "format": "int32",
            "description": "How many days a delete now keeps a workspace here; 0 is no trash, a delete erases. The\n installation's setting, read by whoever may delete: a delete dialog that could not tell\n which happens said both, at the one moment the difference matters."
          }
        },
        "title": "ListDeletedWorkspacesResponse",
        "additionalProperties": false
      },
      "spin.v1.ListExposedPortsRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "page": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PageRequest"
              }
            ],
            "title": "page"
          }
        },
        "title": "ListExposedPortsRequest",
        "additionalProperties": false
      },
      "spin.v1.ListExposedPortsResponse": {
        "type": "object",
        "properties": {
          "ports": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.ExposedPort"
            },
            "title": "ports"
          },
          "page": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PageResponse"
              }
            ],
            "title": "page"
          }
        },
        "title": "ListExposedPortsResponse",
        "additionalProperties": false
      },
      "spin.v1.ListForgeAppsRequest": {
        "type": "object",
        "title": "ListForgeAppsRequest",
        "additionalProperties": false
      },
      "spin.v1.ListForgeAppsResponse": {
        "type": "object",
        "properties": {
          "apps": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.ForgeApp"
            },
            "title": "apps"
          }
        },
        "title": "ListForgeAppsResponse",
        "additionalProperties": false
      },
      "spin.v1.ListHostClassesRequest": {
        "type": "object",
        "title": "ListHostClassesRequest",
        "additionalProperties": false
      },
      "spin.v1.ListHostClassesResponse": {
        "type": "object",
        "properties": {
          "classes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.HostClass"
            },
            "title": "classes"
          }
        },
        "title": "ListHostClassesResponse",
        "additionalProperties": false
      },
      "spin.v1.ListHostProblemsRequest": {
        "type": "object",
        "properties": {
          "hostId": {
            "type": "string",
            "title": "host_id",
            "description": "The one host asked about; empty for every host of the fleet."
          }
        },
        "title": "ListHostProblemsRequest",
        "additionalProperties": false
      },
      "spin.v1.ListHostProblemsResponse": {
        "type": "object",
        "properties": {
          "problems": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.Problem"
            },
            "title": "problems",
            "description": "At most 20, hosts that are not connected first; problem_count is how many there are."
          },
          "problemCount": {
            "type": "integer",
            "title": "problem_count",
            "format": "int32"
          }
        },
        "title": "ListHostProblemsResponse",
        "additionalProperties": false
      },
      "spin.v1.ListHostShellsRequest": {
        "type": "object",
        "properties": {
          "hostId": {
            "type": "string",
            "title": "host_id",
            "description": "One host's; empty for every host's."
          }
        },
        "title": "ListHostShellsRequest",
        "additionalProperties": false
      },
      "spin.v1.ListHostShellsResponse": {
        "type": "object",
        "properties": {
          "shells": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.HostShell"
            },
            "title": "shells"
          }
        },
        "title": "ListHostShellsResponse",
        "additionalProperties": false
      },
      "spin.v1.ListHostsRequest": {
        "type": "object",
        "properties": {
          "page": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PageRequest"
              }
            ],
            "title": "page"
          },
          "stateFilter": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.HostState"
              }
            ],
            "title": "state_filter"
          }
        },
        "title": "ListHostsRequest",
        "additionalProperties": false,
        "description": "Admin RPCs"
      },
      "spin.v1.ListHostsResponse": {
        "type": "object",
        "properties": {
          "hosts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.Host"
            },
            "title": "hosts"
          },
          "page": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PageResponse"
              }
            ],
            "title": "page"
          }
        },
        "title": "ListHostsResponse",
        "additionalProperties": false
      },
      "spin.v1.ListIdentityProvidersRequest": {
        "type": "object",
        "title": "ListIdentityProvidersRequest",
        "additionalProperties": false,
        "description": "Not paginated: the login page offers every enabled provider, a set an admin configures."
      },
      "spin.v1.ListIdentityProvidersResponse": {
        "type": "object",
        "properties": {
          "providers": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.IdentityProvider"
            },
            "title": "providers"
          }
        },
        "title": "ListIdentityProvidersResponse",
        "additionalProperties": false
      },
      "spin.v1.ListImagesRequest": {
        "type": "object",
        "title": "ListImagesRequest",
        "additionalProperties": false
      },
      "spin.v1.ListImagesResponse": {
        "type": "object",
        "properties": {
          "images": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.Image"
            },
            "title": "images",
            "description": "One entry per name, newest publication of it, in the order a person reads a list."
          }
        },
        "title": "ListImagesResponse",
        "additionalProperties": false
      },
      "spin.v1.ListJobRunsRequest": {
        "type": "object",
        "properties": {
          "job": {
            "type": "string",
            "title": "job"
          },
          "limit": {
            "type": "integer",
            "title": "limit",
            "format": "int32",
            "description": "At most this many, newest first; zero is the default of 50."
          }
        },
        "title": "ListJobRunsRequest",
        "additionalProperties": false
      },
      "spin.v1.ListJobRunsResponse": {
        "type": "object",
        "properties": {
          "runs": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.JobRun"
            },
            "title": "runs"
          }
        },
        "title": "ListJobRunsResponse",
        "additionalProperties": false
      },
      "spin.v1.ListJobsRequest": {
        "type": "object",
        "title": "ListJobsRequest",
        "additionalProperties": false
      },
      "spin.v1.ListJobsResponse": {
        "type": "object",
        "properties": {
          "jobs": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.Job"
            },
            "title": "jobs"
          }
        },
        "title": "ListJobsResponse",
        "additionalProperties": false
      },
      "spin.v1.ListLogIndexesRequest": {
        "type": "object",
        "title": "ListLogIndexesRequest",
        "additionalProperties": false
      },
      "spin.v1.ListLogIndexesResponse": {
        "type": "object",
        "properties": {
          "indexes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.LogIndex"
            },
            "title": "indexes"
          }
        },
        "title": "ListLogIndexesResponse",
        "additionalProperties": false
      },
      "spin.v1.ListNetworkPoliciesRequest": {
        "type": "object",
        "title": "ListNetworkPoliciesRequest",
        "additionalProperties": false
      },
      "spin.v1.ListNetworkPoliciesResponse": {
        "type": "object",
        "properties": {
          "policies": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.NetworkPolicy"
            },
            "title": "policies"
          },
          "hostsEnforcing": {
            "type": "integer",
            "title": "hosts_enforcing",
            "format": "int32",
            "description": "Of the hosts connected, how many have installed what the installation declares. They are\n told on their next heartbeat, so the two differ for a moment after an apply - and go on\n differing when a host cannot install what was declared, which is the thing worth seeing."
          },
          "hostsConnected": {
            "type": "integer",
            "title": "hosts_connected",
            "format": "int32"
          }
        },
        "title": "ListNetworkPoliciesResponse",
        "additionalProperties": false
      },
      "spin.v1.ListNotificationsRequest": {
        "type": "object",
        "title": "ListNotificationsRequest",
        "additionalProperties": false
      },
      "spin.v1.ListNotificationsResponse": {
        "type": "object",
        "properties": {
          "notifications": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.Notification"
            },
            "title": "notifications"
          },
          "emailConfigured": {
            "type": "boolean",
            "title": "email_configured",
            "description": "Whether the installation can send email at all."
          }
        },
        "title": "ListNotificationsResponse",
        "additionalProperties": false
      },
      "spin.v1.ListOwnAgentThreadsRequest": {
        "type": "object",
        "title": "ListOwnAgentThreadsRequest",
        "additionalProperties": false
      },
      "spin.v1.ListOwnAgentThreadsResponse": {
        "type": "object",
        "properties": {
          "workspaces": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.WorkspaceAgentThreads"
            },
            "title": "workspaces",
            "description": "One per workspace of the caller's whose supervisor reported a chat, in project then workspace\n name order; a workspace in the trash is not here."
          }
        },
        "title": "ListOwnAgentThreadsResponse",
        "additionalProperties": false
      },
      "spin.v1.ListPasskeysRequest": {
        "type": "object",
        "title": "ListPasskeysRequest",
        "additionalProperties": false
      },
      "spin.v1.ListPasskeysResponse": {
        "type": "object",
        "properties": {
          "passkeys": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.Passkey"
            },
            "title": "passkeys"
          }
        },
        "title": "ListPasskeysResponse",
        "additionalProperties": false
      },
      "spin.v1.ListPrebuildsRequest": {
        "type": "object",
        "properties": {
          "projectId": {
            "type": "string",
            "title": "project_id"
          }
        },
        "title": "ListPrebuildsRequest",
        "additionalProperties": false
      },
      "spin.v1.ListPrebuildsResponse": {
        "type": "object",
        "properties": {
          "prebuilds": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.Prebuild"
            },
            "title": "prebuilds",
            "description": "Newest first."
          },
          "storageMeasuredAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "storage_measured_at",
            "description": "When storage-gc last read the store, which each stored_bytes is as of; unset before it has."
          },
          "retireUnusedDays": {
            "type": "integer",
            "title": "retire_unused_days",
            "format": "int32",
            "description": "The installation's prebuild_retire_unused_days: a ready prebuild nobody opened a workspace\n from in this many days is retired, its ref's newest included. Zero retires none for that."
          },
          "refsNotFound": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.PrebuildRefNotFound"
            },
            "title": "refs_not_found",
            "description": "The refs the project prebuilds that its forge says the repository has not - a branch deleted\n since it was named - as the prebuilds job last found them: nothing is built of one until the\n forge has it again or the project names it no longer."
          }
        },
        "title": "ListPrebuildsResponse",
        "additionalProperties": false
      },
      "spin.v1.ListProjectWorkspacesRequest": {
        "type": "object",
        "properties": {
          "projectId": {
            "type": "string",
            "title": "project_id"
          }
        },
        "title": "ListProjectWorkspacesRequest",
        "additionalProperties": false
      },
      "spin.v1.ListProjectWorkspacesResponse": {
        "type": "object",
        "properties": {
          "workspaces": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.ProjectWorkspace"
            },
            "title": "workspaces",
            "description": "Newest first, and at most 500. Not a prebuild's build, and not a deleted one."
          }
        },
        "title": "ListProjectWorkspacesResponse",
        "additionalProperties": false
      },
      "spin.v1.ListProjectsRequest": {
        "type": "object",
        "title": "ListProjectsRequest",
        "additionalProperties": false
      },
      "spin.v1.ListProjectsResponse": {
        "type": "object",
        "properties": {
          "projects": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.Project"
            },
            "title": "projects"
          }
        },
        "title": "ListProjectsResponse",
        "additionalProperties": false
      },
      "spin.v1.ListRefusedVolumesRequest": {
        "type": "object",
        "title": "ListRefusedVolumesRequest",
        "additionalProperties": false
      },
      "spin.v1.ListRefusedVolumesResponse": {
        "type": "object",
        "properties": {
          "volumes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.RefusedVolume"
            },
            "title": "volumes"
          }
        },
        "title": "ListRefusedVolumesResponse",
        "additionalProperties": false
      },
      "spin.v1.ListRegistrationTokensRequest": {
        "type": "object",
        "properties": {
          "includeUsed": {
            "type": "boolean",
            "title": "include_used"
          },
          "page": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PageRequest"
              }
            ],
            "title": "page"
          }
        },
        "title": "ListRegistrationTokensRequest",
        "additionalProperties": false,
        "description": "Admin: List registration tokens"
      },
      "spin.v1.ListRegistrationTokensResponse": {
        "type": "object",
        "properties": {
          "tokens": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.RegistrationToken"
            },
            "title": "tokens"
          },
          "page": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PageResponse"
              }
            ],
            "title": "page"
          }
        },
        "title": "ListRegistrationTokensResponse",
        "additionalProperties": false
      },
      "spin.v1.ListRekeysRequest": {
        "type": "object",
        "title": "ListRekeysRequest",
        "additionalProperties": false
      },
      "spin.v1.ListRekeysResponse": {
        "type": "object",
        "properties": {
          "rekeys": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.VolumeRekey"
            },
            "title": "rekeys"
          }
        },
        "title": "ListRekeysResponse",
        "additionalProperties": false
      },
      "spin.v1.ListResourcePresetsRequest": {
        "type": "object",
        "properties": {
          "includeDisabled": {
            "type": "boolean",
            "title": "include_disabled",
            "description": "Include disabled presets (admin only)"
          },
          "page": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PageRequest"
              }
            ],
            "title": "page"
          }
        },
        "title": "ListResourcePresetsRequest",
        "additionalProperties": false
      },
      "spin.v1.ListResourcePresetsResponse": {
        "type": "object",
        "properties": {
          "presets": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.ResourcePreset"
            },
            "title": "presets"
          },
          "page": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PageResponse"
              }
            ],
            "title": "page"
          }
        },
        "title": "ListResourcePresetsResponse",
        "additionalProperties": false
      },
      "spin.v1.ListRunbooksRequest": {
        "type": "object",
        "title": "ListRunbooksRequest",
        "additionalProperties": false
      },
      "spin.v1.ListRunbooksResponse": {
        "type": "object",
        "properties": {
          "runbooks": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.Runbook"
            },
            "title": "runbooks"
          }
        },
        "title": "ListRunbooksResponse",
        "additionalProperties": false
      },
      "spin.v1.ListSSHKeysRequest": {
        "type": "object",
        "properties": {
          "page": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PageRequest"
              }
            ],
            "title": "page"
          }
        },
        "title": "ListSSHKeysRequest",
        "additionalProperties": false,
        "description": "List user SSH keys"
      },
      "spin.v1.ListSSHKeysResponse": {
        "type": "object",
        "properties": {
          "sshKeys": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.SSHKey"
            },
            "title": "ssh_keys"
          },
          "page": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PageResponse"
              }
            ],
            "title": "page"
          }
        },
        "title": "ListSSHKeysResponse",
        "additionalProperties": false
      },
      "spin.v1.ListSharedSnapshotsRequest": {
        "type": "object",
        "properties": {
          "includePublic": {
            "type": "boolean",
            "title": "include_public",
            "description": "false: only what was shared with the caller"
          },
          "page": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PageRequest"
              }
            ],
            "title": "page"
          }
        },
        "title": "ListSharedSnapshotsRequest",
        "additionalProperties": false
      },
      "spin.v1.ListSharedSnapshotsResponse": {
        "type": "object",
        "properties": {
          "snapshots": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.Snapshot"
            },
            "title": "snapshots",
            "description": "Uses Snapshot from workspace.proto"
          },
          "page": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PageResponse"
              }
            ],
            "title": "page"
          }
        },
        "title": "ListSharedSnapshotsResponse",
        "additionalProperties": false
      },
      "spin.v1.ListSnapshotSharesRequest": {
        "type": "object",
        "properties": {
          "snapshotId": {
            "type": "string",
            "title": "snapshot_id"
          },
          "page": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PageRequest"
              }
            ],
            "title": "page"
          }
        },
        "title": "ListSnapshotSharesRequest",
        "additionalProperties": false
      },
      "spin.v1.ListSnapshotSharesResponse": {
        "type": "object",
        "properties": {
          "shares": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.SnapshotShare"
            },
            "title": "shares"
          },
          "page": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PageResponse"
              }
            ],
            "title": "page"
          },
          "outsideTeam": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.OutsideShareState"
              }
            ],
            "title": "outside_team",
            "description": "outside_team is the snapshot's share outside its team: what a clone by somebody of another\n team stands on, made when the snapshot is first shared outside the team or made public. A\n clone of it outside the team is refused until it is ready."
          }
        },
        "title": "ListSnapshotSharesResponse",
        "additionalProperties": false
      },
      "spin.v1.ListSnapshotsRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "page": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PageRequest"
              }
            ],
            "title": "page"
          }
        },
        "title": "ListSnapshotsRequest",
        "additionalProperties": false
      },
      "spin.v1.ListSnapshotsResponse": {
        "type": "object",
        "properties": {
          "snapshots": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.Snapshot"
            },
            "title": "snapshots"
          },
          "page": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PageResponse"
              }
            ],
            "title": "page"
          },
          "baseSnapshotId": {
            "type": "string",
            "title": "base_snapshot_id",
            "description": "What the workspace's disk is cloned from now: the snapshot last restored to, or the one it\n was cloned from - for a workspace made from an image, that image's. Empty for a disk that was\n not cloned."
          }
        },
        "title": "ListSnapshotsResponse",
        "additionalProperties": false
      },
      "spin.v1.ListTeamIdentityProvidersRequest": {
        "type": "object",
        "properties": {
          "teamId": {
            "type": "string",
            "title": "team_id",
            "description": "Empty = system-wide providers"
          },
          "page": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PageRequest"
              }
            ],
            "title": "page"
          }
        },
        "title": "ListTeamIdentityProvidersRequest",
        "additionalProperties": false,
        "description": "Identity provider management"
      },
      "spin.v1.ListTeamIdentityProvidersResponse": {
        "type": "object",
        "properties": {
          "providers": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.TeamIdentityProvider"
            },
            "title": "providers"
          },
          "page": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PageResponse"
              }
            ],
            "title": "page"
          }
        },
        "title": "ListTeamIdentityProvidersResponse",
        "additionalProperties": false
      },
      "spin.v1.ListTeamMembersRequest": {
        "type": "object",
        "properties": {
          "teamId": {
            "type": "string",
            "title": "team_id"
          },
          "page": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PageRequest"
              }
            ],
            "title": "page"
          }
        },
        "title": "ListTeamMembersRequest",
        "additionalProperties": false,
        "description": "Member management"
      },
      "spin.v1.ListTeamMembersResponse": {
        "type": "object",
        "properties": {
          "members": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.TeamMember"
            },
            "title": "members"
          },
          "page": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PageResponse"
              }
            ],
            "title": "page"
          }
        },
        "title": "ListTeamMembersResponse",
        "additionalProperties": false
      },
      "spin.v1.ListTeamSecretsRequest": {
        "type": "object",
        "properties": {
          "teamId": {
            "type": "string",
            "title": "team_id"
          }
        },
        "title": "ListTeamSecretsRequest",
        "additionalProperties": false
      },
      "spin.v1.ListTeamSecretsResponse": {
        "type": "object",
        "properties": {
          "secrets": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.TeamSecret"
            },
            "title": "secrets"
          }
        },
        "title": "ListTeamSecretsResponse",
        "additionalProperties": false
      },
      "spin.v1.ListTeamsRequest": {
        "type": "object",
        "properties": {
          "parentId": {
            "type": "string",
            "title": "parent_id",
            "description": "Optional: filter by parent (empty = root teams only)"
          },
          "includeAllDescendants": {
            "type": "boolean",
            "title": "include_all_descendants",
            "description": "If true, include all nested teams"
          },
          "page": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PageRequest"
              }
            ],
            "title": "page"
          },
          "everyTeam": {
            "type": "boolean",
            "title": "every_team",
            "description": "every_team lists the whole installation rather than the caller's own teams - the\n administration view, and only an instance admin may ask for it. It is asked for rather\n than inferred from who is calling: an admin's own Teams page should be their teams, not\n a list of everybody's personal team that they cannot get out of."
          }
        },
        "title": "ListTeamsRequest",
        "additionalProperties": false
      },
      "spin.v1.ListTeamsResponse": {
        "type": "object",
        "properties": {
          "teams": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.Team"
            },
            "title": "teams"
          },
          "page": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PageResponse"
              }
            ],
            "title": "page"
          }
        },
        "title": "ListTeamsResponse",
        "additionalProperties": false
      },
      "spin.v1.ListTimelineRequest": {
        "type": "object",
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "hostId": {
                "type": "string",
                "title": "host_id"
              }
            },
            "title": "host_id"
          },
          {
            "type": "object",
            "properties": {
              "projectId": {
                "type": "string",
                "title": "project_id"
              }
            },
            "title": "project_id"
          },
          {
            "type": "object",
            "properties": {
              "teamId": {
                "type": "string",
                "title": "team_id"
              }
            },
            "title": "team_id"
          },
          {
            "type": "object",
            "properties": {
              "workspaceId": {
                "type": "string",
                "title": "workspace_id",
                "description": "The one sample: a request names one of these at most."
              }
            },
            "title": "workspace_id"
          }
        ],
        "unevaluatedProperties": false,
        "not": {
          "allOf": [
            {
              "anyOf": [
                {
                  "required": [
                    "hostId"
                  ]
                },
                {
                  "required": [
                    "projectId"
                  ]
                },
                {
                  "required": [
                    "teamId"
                  ]
                },
                {
                  "required": [
                    "workspaceId"
                  ]
                }
              ]
            },
            {
              "not": {
                "oneOf": [
                  {
                    "required": [
                      "hostId"
                    ]
                  },
                  {
                    "required": [
                      "projectId"
                    ]
                  },
                  {
                    "required": [
                      "teamId"
                    ]
                  },
                  {
                    "required": [
                      "workspaceId"
                    ]
                  }
                ]
              }
            }
          ]
        },
        "properties": {
          "since": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "since",
            "description": "Inclusive; unset reads from as far back as the records go."
          },
          "until": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "until",
            "description": "Exclusive; unset is now."
          },
          "page": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PageRequest"
              }
            ],
            "title": "page",
            "description": "page_size is at most 200, and zero is 50. total_count is not counted."
          }
        },
        "title": "ListTimelineRequest"
      },
      "spin.v1.ListTimelineResponse": {
        "type": "object",
        "properties": {
          "events": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.TimelineEvent"
            },
            "title": "events"
          },
          "page": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PageResponse"
              }
            ],
            "title": "page"
          },
          "keptDays": {
            "type": "integer",
            "title": "kept_days",
            "format": "int32",
            "description": "kept_days is how long what the timeline reads is kept (ListWorkspaceTimelineResponse)."
          }
        },
        "title": "ListTimelineResponse",
        "additionalProperties": false
      },
      "spin.v1.ListUserAPIKeysRequest": {
        "type": "object",
        "properties": {
          "userId": {
            "type": "string",
            "title": "user_id"
          },
          "page": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PageRequest"
              }
            ],
            "title": "page"
          }
        },
        "title": "ListUserAPIKeysRequest",
        "additionalProperties": false
      },
      "spin.v1.ListUserAPIKeysResponse": {
        "type": "object",
        "properties": {
          "apiKeys": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.APIKey"
            },
            "title": "api_keys"
          },
          "page": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PageResponse"
              }
            ],
            "title": "page"
          }
        },
        "title": "ListUserAPIKeysResponse",
        "additionalProperties": false
      },
      "spin.v1.ListUsersRequest": {
        "type": "object",
        "properties": {
          "page": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PageRequest"
              }
            ],
            "title": "page"
          },
          "query": {
            "type": "string",
            "title": "query",
            "description": "Optional: filter by name or email"
          },
          "adminsOnly": {
            "type": "boolean",
            "title": "admins_only",
            "description": "Optional: only return admin users"
          }
        },
        "title": "ListUsersRequest",
        "additionalProperties": false
      },
      "spin.v1.ListUsersResponse": {
        "type": "object",
        "properties": {
          "users": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.User"
            },
            "title": "users"
          },
          "page": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PageResponse"
              }
            ],
            "title": "page"
          },
          "holdings": {
            "type": "object",
            "title": "holdings",
            "additionalProperties": {
              "allOf": [
                {
                  "$ref": "#/components/schemas/spin.v1.UserHoldings"
                }
              ],
              "title": "value"
            },
            "description": "What each listed user still holds, by user id: what an administrator asks before taking\n access away. Kept off User, which other calls return without it."
          },
          "refusedRemovals": {
            "type": "object",
            "title": "refused_removals",
            "additionalProperties": {
              "type": "string",
              "title": "value"
            },
            "description": "Why removing a listed user as an administrator, or disabling them, would be refused, by user\n id; absent where it would not be. The refusal is the database's (lockout), so a client that\n never reads this is refused the same."
          }
        },
        "title": "ListUsersResponse",
        "additionalProperties": false
      },
      "spin.v1.ListWorkspaceGuestsRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          }
        },
        "title": "ListWorkspaceGuestsRequest",
        "additionalProperties": false
      },
      "spin.v1.ListWorkspaceGuestsResponse": {
        "type": "object",
        "properties": {
          "guests": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.WorkspaceGuest"
            },
            "title": "guests"
          }
        },
        "title": "ListWorkspaceGuestsResponse",
        "additionalProperties": false
      },
      "spin.v1.ListWorkspaceQuarantineDenialsRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id",
            "description": "The workspace's id."
          },
          "limit": {
            "type": "integer",
            "title": "limit",
            "format": "int32",
            "description": "How many of the newest to answer; the newest first."
          }
        },
        "title": "ListWorkspaceQuarantineDenialsRequest",
        "additionalProperties": false
      },
      "spin.v1.ListWorkspaceQuarantineDenialsResponse": {
        "type": "object",
        "properties": {
          "denials": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.QuarantineDenial"
            },
            "title": "denials",
            "description": "Newest first."
          }
        },
        "title": "ListWorkspaceQuarantineDenialsResponse",
        "additionalProperties": false
      },
      "spin.v1.ListWorkspaceTimelineRequest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          },
          "since": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "since",
            "description": "Inclusive; unset reads from as far back as the records go."
          },
          "until": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "until",
            "description": "Exclusive; unset is now."
          },
          "page": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PageRequest"
              }
            ],
            "title": "page",
            "description": "page_size is at most 200, and zero is 50. total_count is not counted."
          }
        },
        "title": "ListWorkspaceTimelineRequest",
        "additionalProperties": false
      },
      "spin.v1.ListWorkspaceTimelineResponse": {
        "type": "object",
        "properties": {
          "events": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.TimelineEvent"
            },
            "title": "events"
          },
          "page": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PageResponse"
              }
            ],
            "title": "page"
          },
          "keptDays": {
            "type": "integer",
            "title": "kept_days",
            "format": "int32",
            "description": "kept_days is how long what the timeline reads is kept: before it, an empty timeline is the\n records gone, not nothing having happened."
          }
        },
        "title": "ListWorkspaceTimelineResponse",
        "additionalProperties": false
      },
      "spin.v1.ListWorkspacesRequest": {
        "type": "object",
        "properties": {
          "page": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PageRequest"
              }
            ],
            "title": "page"
          },
          "stateFilter": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.WorkspaceState"
              }
            ],
            "title": "state_filter",
            "description": "Optional filter by state"
          },
          "teamId": {
            "type": "string",
            "title": "team_id",
            "description": "Optional filter by team (empty = all user's workspaces)"
          },
          "nameFilter": {
            "type": "string",
            "title": "name_filter",
            "description": "Optional search by name prefix"
          }
        },
        "title": "ListWorkspacesRequest",
        "additionalProperties": false
      },
      "spin.v1.ListWorkspacesResponse": {
        "type": "object",
        "properties": {
          "workspaces": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.Workspace"
            },
            "title": "workspaces"
          },
          "page": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PageResponse"
              }
            ],
            "title": "page"
          }
        },
        "title": "ListWorkspacesResponse",
        "additionalProperties": false
      },
      "spin.v1.LogIndex": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          },
          "retention": {
            "type": "string",
            "title": "retention",
            "description": "How long it keeps what it holds, in the store's words (\"30 days\"); empty for forever."
          },
          "timestampField": {
            "type": "string",
            "title": "timestamp_field",
            "description": "The field its records are dated by: what a search's window is over."
          },
          "defaultSearchFields": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "default_search_fields",
            "description": "What a query's bare words are searched in."
          },
          "fields": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.LogIndexField"
            },
            "title": "fields"
          },
          "documents": {
            "type": "string",
            "title": "documents",
            "format": "int64",
            "description": "What it holds: records, the splits they are kept in, and the splits' size in the bucket\n and the records' before compression."
          },
          "splits": {
            "type": "string",
            "title": "splits",
            "format": "int64"
          },
          "sizeBytes": {
            "type": "string",
            "title": "size_bytes",
            "format": "int64"
          },
          "uncompressedBytes": {
            "type": "string",
            "title": "uncompressed_bytes",
            "format": "int64"
          },
          "oldest": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "oldest",
            "description": "When its oldest and newest records are dated; unset while it holds none."
          },
          "newest": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "newest"
          }
        },
        "title": "LogIndex",
        "additionalProperties": false,
        "description": "LogIndex is one index of the store."
      },
      "spin.v1.LogIndexField": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "title": "name",
            "description": "A dotted path for a field inside an object field."
          },
          "type": {
            "type": "string",
            "title": "type",
            "description": "The store's type: text, json, u64, bool, bytes, datetime, array\u003ctext\u003e..."
          },
          "tokenizer": {
            "type": "string",
            "title": "tokenizer",
            "description": "How a text or JSON field is split into what a query matches: \"raw\" is the whole value as\n written, \"default\" is its words, lowercased. Empty for any other type."
          },
          "indexed": {
            "type": "boolean",
            "title": "indexed",
            "description": "Whether a query can match it, and whether it can be counted and ranged over fast."
          },
          "fast": {
            "type": "boolean",
            "title": "fast"
          }
        },
        "title": "LogIndexField",
        "additionalProperties": false,
        "description": "LogIndexField is one field of an index's mapping."
      },
      "spin.v1.LogInterval": {
        "type": "object",
        "properties": {
          "start": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "start"
          },
          "bySeverity": {
            "type": "object",
            "title": "by_severity",
            "additionalProperties": {
              "type": "string",
              "title": "value",
              "format": "int64"
            }
          }
        },
        "title": "LogInterval",
        "additionalProperties": false,
        "description": "LogInterval is how many records one interval holds, by severity."
      },
      "spin.v1.LogRecord": {
        "type": "object",
        "properties": {
          "time": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "time"
          },
          "severity": {
            "type": "string",
            "title": "severity"
          },
          "service": {
            "type": "string",
            "title": "service",
            "description": "The process that wrote it: controlplane, runner, proxy."
          },
          "body": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Value"
              }
            ],
            "title": "body",
            "description": "What was logged: its message, or the structure it logged."
          },
          "attributes": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Struct"
              }
            ],
            "title": "attributes"
          },
          "resourceAttributes": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Struct"
              }
            ],
            "title": "resource_attributes"
          },
          "traceId": {
            "type": "string",
            "title": "trace_id",
            "description": "The trace it was written in, hex; empty for none."
          },
          "spanId": {
            "type": "string",
            "title": "span_id"
          }
        },
        "title": "LogRecord",
        "additionalProperties": false,
        "description": "LogRecord is one record as OpenTelemetry names its parts."
      },
      "spin.v1.LogoutRequest": {
        "type": "object",
        "title": "LogoutRequest",
        "additionalProperties": false
      },
      "spin.v1.LogoutResponse": {
        "type": "object",
        "title": "LogoutResponse",
        "additionalProperties": false
      },
      "spin.v1.MemoryUsagePoint": {
        "type": "object",
        "properties": {
          "start": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "start"
          },
          "usedBytes": {
            "type": "string",
            "title": "used_bytes",
            "format": "int64"
          },
          "heldBytes": {
            "type": "string",
            "title": "held_bytes",
            "format": "int64"
          },
          "memoryBytes": {
            "type": "string",
            "title": "memory_bytes",
            "format": "int64"
          },
          "maxMemoryBytes": {
            "type": "string",
            "title": "max_memory_bytes",
            "format": "int64"
          }
        },
        "title": "MemoryUsagePoint",
        "additionalProperties": false,
        "description": "MemoryUsagePoint is the most the machine used over a step - running out is a peak, not a mean\n - against what it held, as CpuUsagePoint."
      },
      "spin.v1.MoveWorkspaceRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          }
        },
        "title": "MoveWorkspaceRequest",
        "additionalProperties": false
      },
      "spin.v1.MoveWorkspaceResponse": {
        "type": "object",
        "properties": {
          "workspace": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.Workspace"
              }
            ],
            "title": "workspace"
          }
        },
        "title": "MoveWorkspaceResponse",
        "additionalProperties": false
      },
      "spin.v1.NetworkPolicy": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "title": "name"
          },
          "hosts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.HostNetworkPolicy"
            },
            "title": "hosts",
            "description": "What each host reporting this tag says it enforces."
          },
          "declared": {
            "type": "boolean",
            "title": "declared",
            "description": "declared says the installation has this policy, and rules are what it allows. A policy with\n no hosts is declared and not yet enforced anywhere."
          },
          "rules": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.NetworkRule"
            },
            "title": "rules"
          },
          "teamId": {
            "type": "string",
            "title": "team_id",
            "description": "The team whose admins declared it, which only its workspaces and those of the teams below\n it may run under; empty is the installation's."
          }
        },
        "title": "NetworkPolicy",
        "additionalProperties": false,
        "description": "NetworkPolicy is a tag a workspace can be created with, and what the hosts reporting it say\n it allows. The hosts are the authority: this is what they last said they enforce."
      },
      "spin.v1.NetworkPolicyRule": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "title": "name"
          },
          "rules": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.NetworkRule"
            },
            "title": "rules"
          }
        },
        "title": "NetworkPolicyRule",
        "additionalProperties": false,
        "description": "NetworkPolicyRule is a policy as an administrator writes it, in the words the config file\n takes: a name, which is a tag - letters, digits, - and _, up to 32 - and the rules it allows,\n each these destinations on these ports. A policy with no rules allows nothing."
      },
      "spin.v1.NetworkRule": {
        "type": "object",
        "properties": {
          "allow": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "allow",
            "description": "IPv4 prefixes in CIDR."
          },
          "allowNames": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "allow_names",
            "description": "Names, exact or with a leading \"*.\": the host opens the address its own resolver answers a\n machine with, for as long as the answer lives."
          },
          "ports": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "ports",
            "description": "Destination ports as \"443\" (TCP, which is what a bare number means), \"443/udp\", a range as\n \"8000-8100\" or \"8000-8100/udp\", or \"icmp\" for a ping. None is every port, at the\n destinations above; none of those is every destination, on these ports."
          },
          "broker": {
            "type": "boolean",
            "title": "broker",
            "description": "The host's egress proxy stands in for these names, on HTTPS only: a machine reaches them\n through it and never directly, and it adds what the machine never holds. Names only."
          },
          "inject": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.HeaderInjection"
            },
            "title": "inject",
            "description": "Headers the proxy sets on a brokered rule's requests, each from a secret of the workspace's\n team (or the nearest team above it with one by that name). Brokered rules only."
          },
          "cloud": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.CloudAccess"
              }
            ],
            "title": "cloud",
            "description": "The principal the proxy authorizes a brokered rule's requests as, on its cloud: the host takes\n its credentials as the workspace, with a token of its identity. Brokered rules naming that\n cloud's endpoints only, and not with inject."
          },
          "verifySni": {
            "type": "boolean",
            "title": "verify_sni",
            "description": "The host's egress proxy reads the TLS server name of each connection to these names and passes\n on, untouched, only one this rule names: an address shared with other names opens only these\n to a client that says which it wants. A connection with no name, or one hiding it (ECH), goes\n nowhere. Names only, on TCP, never with broker; it does not stop a client that lies."
          },
          "principal": {
            "type": "string",
            "title": "principal",
            "description": "Whose connections a brokered rule stands in for: \"agent\" (the workspace's agent, whose packets\n its guest marks), \"user\" (everything else the workspace sends), or \"any\" (empty: both). Two\n rules for one name, one per principal, each with its own injections and methods, say what the\n person may do and what the agent may. Brokered rules only: an agent reaches nothing outside\n the proxy, so a rule that is not brokered is the person's already."
          }
        },
        "title": "NetworkRule",
        "additionalProperties": false,
        "description": "NetworkRule is one thing a network policy allows: these destinations on these ports. Within a\n rule the two intersect - every destination on every port - and a policy is the union of its\n rules, so \"53/udp to one resolver and 443 to github.com\" is two rules and not a product of\n both. Here and not beside a policy for the reason HealthReport is: the control plane's policy,\n the one a host reports it enforces and the one a host is given are one vocabulary."
      },
      "spin.v1.NetworkUsagePoint": {
        "type": "object",
        "properties": {
          "start": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "start"
          },
          "sentBytes": {
            "type": "string",
            "title": "sent_bytes",
            "format": "int64"
          },
          "receivedBytes": {
            "type": "string",
            "title": "received_bytes",
            "format": "int64"
          }
        },
        "title": "NetworkUsagePoint",
        "additionalProperties": false,
        "description": "NetworkUsagePoint is what the machine's network carried over a step."
      },
      "spin.v1.Notification": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id",
            "description": "The workspace event's id."
          },
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "workspaceName": {
            "type": "string",
            "title": "workspace_name"
          },
          "event": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.WorkspaceEventType"
              }
            ],
            "title": "event"
          },
          "createdAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "created_at"
          },
          "subject": {
            "type": "string",
            "title": "subject",
            "description": "One line saying what happened."
          },
          "body": {
            "type": "string",
            "title": "body",
            "description": "What happened, in full."
          },
          "command": {
            "type": "string",
            "title": "command",
            "description": "The command that does what the owner can do about it; empty where nothing is to be done."
          },
          "deliveries": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.NotificationDelivery"
            },
            "title": "deliveries",
            "description": "Empty where it was never sent: email off, or this kind turned off."
          }
        },
        "title": "Notification",
        "additionalProperties": false,
        "description": "Notification is one event of a workspace's timeline its owner is told of: what happened, and\n what they can do about it."
      },
      "spin.v1.NotificationChannel": {
        "type": "string",
        "title": "NotificationChannel",
        "enum": [
          "NOTIFICATION_CHANNEL_UNSPECIFIED",
          "NOTIFICATION_CHANNEL_EMAIL"
        ],
        "description": "How a notification leaves the installation."
      },
      "spin.v1.NotificationDelivery": {
        "type": "object",
        "properties": {
          "channel": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.NotificationChannel"
              }
            ],
            "title": "channel"
          },
          "state": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.NotificationDeliveryState"
              }
            ],
            "title": "state"
          },
          "attempts": {
            "type": "integer",
            "title": "attempts",
            "format": "int32"
          },
          "lastError": {
            "type": "string",
            "title": "last_error",
            "description": "What the last attempt that failed was told; empty once one succeeded."
          },
          "sentAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "sent_at"
          }
        },
        "title": "NotificationDelivery",
        "additionalProperties": false
      },
      "spin.v1.NotificationDeliveryState": {
        "type": "string",
        "title": "NotificationDeliveryState",
        "enum": [
          "NOTIFICATION_DELIVERY_STATE_UNSPECIFIED",
          "NOTIFICATION_DELIVERY_STATE_PENDING",
          "NOTIFICATION_DELIVERY_STATE_SENT",
          "NOTIFICATION_DELIVERY_STATE_FAILED"
        ],
        "description": "Where one notification's delivery on one channel is.\n\n- `NOTIFICATION_DELIVERY_STATE_PENDING`: Not sent yet, or tried and to be tried again\n- `NOTIFICATION_DELIVERY_STATE_SENT`: The channel accepted it\n- `NOTIFICATION_DELIVERY_STATE_FAILED`: Every attempt failed; it is not tried again",
        "x-enum-descriptions": [
          "",
          "Not sent yet, or tried and to be tried again",
          "The channel accepted it",
          "Every attempt failed; it is not tried again"
        ]
      },
      "spin.v1.NotificationPreference": {
        "type": "object",
        "properties": {
          "event": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.WorkspaceEventType"
              }
            ],
            "title": "event"
          },
          "email": {
            "type": "boolean",
            "title": "email"
          },
          "installationEvent": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.InstallationEventType"
              }
            ],
            "title": "installation_event"
          }
        },
        "title": "NotificationPreference",
        "additionalProperties": false,
        "description": "One kind of event and whether the caller is emailed about it: a workspace's event, or the\n installation's (an administrator's alone). Exactly one of event and installation_event is set."
      },
      "spin.v1.ObservedDestination": {
        "type": "object",
        "properties": {
          "address": {
            "type": "string",
            "title": "address"
          },
          "name": {
            "type": "string",
            "title": "name"
          },
          "packets": {
            "type": "string",
            "title": "packets",
            "format": "int64",
            "description": "What the workspace sent there, every packet of every flow."
          },
          "bytes": {
            "type": "string",
            "title": "bytes",
            "format": "int64"
          },
          "protocol": {
            "type": "string",
            "title": "protocol",
            "description": "\"tcp\", \"udp\", \"icmp\", or the protocol's number."
          },
          "port": {
            "type": "integer",
            "title": "port",
            "description": "For tcp and udp; zero otherwise."
          },
          "packetsReceived": {
            "type": "string",
            "title": "packets_received",
            "format": "int64",
            "description": "What came back to the workspace from there."
          },
          "bytesReceived": {
            "type": "string",
            "title": "bytes_received",
            "format": "int64"
          }
        },
        "title": "ObservedDestination",
        "additionalProperties": false,
        "description": "ObservedDestination is one address the workspace was allowed to reach, with what the host's\n ruleset counted and the name its resolver answered with that address, where it holds one."
      },
      "spin.v1.OpenWorkspaceProxySessionRequest": {
        "type": "object",
        "properties": {
          "workspaceName": {
            "type": "string",
            "title": "workspace_name",
            "description": "From the subdomain, as CheckPortAccess takes it"
          },
          "port": {
            "type": "integer",
            "title": "port",
            "format": "int32",
            "description": "The published port inside the workspace"
          },
          "sessionToken": {
            "type": "string",
            "title": "session_token",
            "description": "The session token of whoever the connection is being opened for, validated here.\n\n It is the difference between a control plane that can refuse and one that cannot. The\n proxy gates each request in front, but this is reachable on its own, and without a\n credential to check, anything that could reach it would open a session into any\n published port of any workspace. Empty is allowed and reaches only PUBLIC ports."
          },
          "httpsBackend": {
            "type": "boolean",
            "title": "https_backend",
            "description": "The hostname's s. A port whose flag differs answers as one that is not exposed."
          },
          "workspaceId": {
            "type": "string",
            "title": "workspace_id",
            "description": "The workspace CheckPortAccess decided the request about. A name that now names another\n answers as a port that is not exposed: the session is for the workspace that was decided."
          }
        },
        "title": "OpenWorkspaceProxySessionRequest",
        "additionalProperties": false,
        "description": "Opening one connection into a published port, for the proxy.\n\n Separate from CheckPortAccess, which the proxy calls on every request to decide whether the\n browser may reach the port. This one is called only when a new connection is actually\n needed - http.Transport pools them, so a page of fifty assets opens a handful - and each\n call costs a command to the workspace's runner.\n\n The authorization is the same question CheckPortAccess answers and is asked again here\n rather than carried over: a session is a way into somebody's workspace, and the decision to\n open one belongs beside the opening."
      },
      "spin.v1.OpenWorkspaceProxySessionResponse": {
        "type": "object",
        "properties": {
          "status": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.WorkspaceProxyStatus"
              }
            ],
            "title": "status"
          },
          "relayUrl": {
            "type": "string",
            "title": "relay_url",
            "description": "Where the two ends of this connection meet, and the token that names it there. Set only\n when status is ACCESSIBLE. The token is single-use: one connection, one token."
          },
          "sessionToken": {
            "type": "string",
            "title": "session_token"
          },
          "httpsBackend": {
            "type": "boolean",
            "title": "https_backend",
            "description": "The flag of the row the session was authorized on: whether the proxy speaks TLS."
          }
        },
        "title": "OpenWorkspaceProxySessionResponse",
        "additionalProperties": false
      },
      "spin.v1.OutsideShareState": {
        "type": "string",
        "title": "OutsideShareState",
        "enum": [
          "OUTSIDE_SHARE_STATE_UNSPECIFIED",
          "OUTSIDE_SHARE_STATE_PREPARING",
          "OUTSIDE_SHARE_STATE_READY"
        ],
        "description": "OutsideShareState is how far a snapshot's share outside its team is.\n\n- `OUTSIDE_SHARE_STATE_UNSPECIFIED`: None: the snapshot was never shared outside its team, nor made public.\n- `OUTSIDE_SHARE_STATE_PREPARING`: A host is writing the keys a clone outside the team reads the snapshot with.\n- `OUTSIDE_SHARE_STATE_READY`: Somebody of another team can create a workspace from it.",
        "x-enum-descriptions": [
          "None: the snapshot was never shared outside its team, nor made public.",
          "A host is writing the keys a clone outside the team reads the snapshot with.",
          "Somebody of another team can create a workspace from it."
        ]
      },
      "spin.v1.PageRequest": {
        "type": "object",
        "properties": {
          "pageSize": {
            "type": "integer",
            "title": "page_size",
            "format": "int32"
          },
          "pageToken": {
            "type": "string",
            "title": "page_token"
          }
        },
        "title": "PageRequest",
        "additionalProperties": false,
        "description": "Pagination for list requests"
      },
      "spin.v1.PageResponse": {
        "type": "object",
        "properties": {
          "nextPageToken": {
            "type": "string",
            "title": "next_page_token"
          },
          "totalCount": {
            "type": "integer",
            "title": "total_count",
            "format": "int32"
          }
        },
        "title": "PageResponse",
        "additionalProperties": false
      },
      "spin.v1.Passkey": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          },
          "name": {
            "type": "string",
            "title": "name"
          },
          "credentialId": {
            "type": "string",
            "title": "credential_id",
            "format": "byte"
          },
          "createdAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "created_at"
          },
          "lastUsedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "last_used_at"
          }
        },
        "title": "Passkey",
        "additionalProperties": false
      },
      "spin.v1.PasskeyAssertion": {
        "type": "object",
        "properties": {
          "challenge": {
            "type": "string",
            "title": "challenge",
            "format": "byte"
          },
          "credentialId": {
            "type": "string",
            "title": "credential_id",
            "format": "byte"
          },
          "clientDataJson": {
            "type": "string",
            "title": "client_data_json",
            "format": "byte"
          },
          "authenticatorData": {
            "type": "string",
            "title": "authenticator_data",
            "format": "byte"
          },
          "signature": {
            "type": "string",
            "title": "signature",
            "format": "byte",
            "description": "ECDSA's, in ASN.1 DER, as WebAuthn returns it."
          }
        },
        "title": "PasskeyAssertion",
        "additionalProperties": false,
        "description": "PasskeyAssertion is what navigator.credentials.get answers, and the challenge it answers."
      },
      "spin.v1.PasskeyPurpose": {
        "type": "string",
        "title": "PasskeyPurpose",
        "enum": [
          "PASSKEY_PURPOSE_UNSPECIFIED",
          "PASSKEY_PURPOSE_REGISTER",
          "PASSKEY_PURPOSE_ADD_PASSKEY",
          "PASSKEY_PURPOSE_ADD_SSH_KEY",
          "PASSKEY_PURPOSE_DELETE_PASSKEY",
          "PASSKEY_PURPOSE_ADD_GUEST",
          "PASSKEY_PURPOSE_CREATE_EXEC_KEY"
        ],
        "description": "PasskeyPurpose is what a ceremony's challenge is for.\n\n- `PASSKEY_PURPOSE_REGISTER`: A passkey registered: the registration answers it. Subject: none.\n- `PASSKEY_PURPOSE_ADD_PASSKEY`: Another passkey registered while the account has one: an assertion of one it has answers it.\n  Subject: the new credential's id, base64url.\n- `PASSKEY_PURPOSE_ADD_SSH_KEY`: An SSH key added (SSHKeyService.AddSSHKey). Subject: the key, in authorized_keys form.\n- `PASSKEY_PURPOSE_DELETE_PASSKEY`: A passkey deleted. Subject: its id.\n- `PASSKEY_PURPOSE_ADD_GUEST`: A guest let into a workspace (WorkspaceService.AddWorkspaceGuest). Subject: \"\u003cworkspace id\u003e\n  \u003cemail\u003e\".\n- `PASSKEY_PURPOSE_CREATE_EXEC_KEY`: An API key made with workspace:exec (AuthService.CreateAPIKey), which is a shell in every\n  workspace of its person's. Subject: the key's name.",
        "x-enum-descriptions": [
          "",
          "A passkey registered: the registration answers it. Subject: none.",
          "Another passkey registered while the account has one: an assertion of one it has answers it.\n Subject: the new credential's id, base64url.",
          "An SSH key added (SSHKeyService.AddSSHKey). Subject: the key, in authorized_keys form.",
          "A passkey deleted. Subject: its id.",
          "A guest let into a workspace (WorkspaceService.AddWorkspaceGuest). Subject: \"\u003cworkspace id\u003e\n \u003cemail\u003e\".",
          "An API key made with workspace:exec (AuthService.CreateAPIKey), which is a shell in every\n workspace of its person's. Subject: the key's name."
        ]
      },
      "spin.v1.PasswordLoginRequest": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string",
            "title": "email"
          },
          "password": {
            "type": "string",
            "title": "password"
          }
        },
        "title": "PasswordLoginRequest",
        "additionalProperties": false
      },
      "spin.v1.PasswordLoginResponse": {
        "type": "object",
        "properties": {
          "user": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.User"
              }
            ],
            "title": "user"
          },
          "sessionToken": {
            "type": "string",
            "title": "session_token"
          },
          "expiresAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "expires_at"
          },
          "forcePasswordChange": {
            "type": "boolean",
            "title": "force_password_change",
            "description": "True if user must change password before proceeding"
          }
        },
        "title": "PasswordLoginResponse",
        "additionalProperties": false
      },
      "spin.v1.PlatformCost": {
        "type": "object",
        "properties": {
          "role": {
            "type": "string",
            "title": "role",
            "description": "As the resources carry it (on AWS, their spin:role tag); empty where they carry none, which\n is said as untagged."
          },
          "service": {
            "type": "string",
            "title": "service"
          },
          "micros": {
            "type": "string",
            "title": "micros",
            "format": "int64"
          }
        },
        "title": "PlatformCost",
        "additionalProperties": false,
        "description": "What one role's resources of one of the cloud's services cost, in millionths of the bill's\n currency: the control plane, the proxy and the database are three roles of one EC2."
      },
      "spin.v1.PlatformImage": {
        "type": "object",
        "properties": {
          "artifact": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PlatformImageArtifact"
              }
            ],
            "title": "artifact"
          },
          "state": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PlatformImageState"
              }
            ],
            "title": "state"
          },
          "detail": {
            "type": "string",
            "title": "detail",
            "description": "Why it failed, or why it is left alone."
          },
          "version": {
            "type": "string",
            "title": "version",
            "description": "The machine's release, or the supervisor's (the control plane's) version."
          },
          "updatedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "updated_at"
          }
        },
        "title": "PlatformImage",
        "additionalProperties": false
      },
      "spin.v1.PlatformImageArtifact": {
        "type": "string",
        "title": "PlatformImageArtifact",
        "enum": [
          "PLATFORM_IMAGE_ARTIFACT_UNSPECIFIED",
          "PLATFORM_IMAGE_ARTIFACT_BASE",
          "PLATFORM_IMAGE_ARTIFACT_SUPERVISOR",
          "PLATFORM_IMAGE_ARTIFACT_AGENT_HOME"
        ],
        "description": "- `PLATFORM_IMAGE_ARTIFACT_BASE`: The machine's base image, every workspace's disk's floor.\n- `PLATFORM_IMAGE_ARTIFACT_SUPERVISOR`: The supervisor extension every workspace is handed.\n- `PLATFORM_IMAGE_ARTIFACT_AGENT_HOME`: The empty home every agent's volume is cloned from.",
        "x-enum-descriptions": [
          "",
          "The machine's base image, every workspace's disk's floor.",
          "The supervisor extension every workspace is handed.",
          "The empty home every agent's volume is cloned from."
        ]
      },
      "spin.v1.PlatformImageState": {
        "type": "string",
        "title": "PlatformImageState",
        "enum": [
          "PLATFORM_IMAGE_STATE_UNSPECIFIED",
          "PLATFORM_IMAGE_STATE_PENDING",
          "PLATFORM_IMAGE_STATE_PUBLISHED",
          "PLATFORM_IMAGE_STATE_PUBLISHING",
          "PLATFORM_IMAGE_STATE_FAILED",
          "PLATFORM_IMAGE_STATE_UNAVAILABLE",
          "PLATFORM_IMAGE_STATE_FOREIGN"
        ],
        "description": "- `PLATFORM_IMAGE_STATE_UNAVAILABLE`: This build carries nothing to publish.\n- `PLATFORM_IMAGE_STATE_FOREIGN`: The ref names an image somebody else published, which is left as it is.",
        "x-enum-descriptions": [
          "",
          "",
          "",
          "",
          "",
          "This build carries nothing to publish.",
          "The ref names an image somebody else published, which is left as it is."
        ]
      },
      "spin.v1.PlatformLogFieldValuesRequest": {
        "type": "object",
        "properties": {
          "field": {
            "type": "string",
            "title": "field"
          },
          "query": {
            "type": "string",
            "title": "query"
          },
          "from": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "from"
          },
          "to": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "to"
          },
          "limit": {
            "type": "integer",
            "title": "limit",
            "format": "int32",
            "description": "How many values, the commonest first: 1 to 100, 10 when unset."
          }
        },
        "title": "PlatformLogFieldValuesRequest",
        "additionalProperties": false
      },
      "spin.v1.PlatformLogFieldValuesResponse": {
        "type": "object",
        "properties": {
          "values": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.FieldValue"
            },
            "title": "values"
          },
          "other": {
            "type": "string",
            "title": "other",
            "format": "int64",
            "description": "How many records the search found with a value not among these."
          }
        },
        "title": "PlatformLogFieldValuesResponse",
        "additionalProperties": false
      },
      "spin.v1.PollDeviceConnectRequest": {
        "type": "object",
        "properties": {
          "handle": {
            "type": "string",
            "title": "handle"
          }
        },
        "title": "PollDeviceConnectRequest",
        "additionalProperties": false
      },
      "spin.v1.PollDeviceConnectResponse": {
        "type": "object",
        "properties": {
          "connection": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.ForgeConnection"
              }
            ],
            "title": "connection",
            "description": "Set once the person approved: the connection, kept. Unset is pending: poll again after\n interval_seconds, which the forge may have lengthened."
          },
          "intervalSeconds": {
            "type": "integer",
            "title": "interval_seconds",
            "format": "int32"
          }
        },
        "title": "PollDeviceConnectResponse",
        "additionalProperties": false
      },
      "spin.v1.PortAccess": {
        "type": "string",
        "title": "PortAccess",
        "enum": [
          "PORT_ACCESS_UNSPECIFIED",
          "PORT_ACCESS_PRIVATE",
          "PORT_ACCESS_WHITELIST",
          "PORT_ACCESS_PUBLIC"
        ],
        "description": "Who may reach a published port.\n\n Per port rather than per workspace: one workspace serves a demo anyone may see and an\n admin panel only its owner may, and a single setting for both makes the safe answer for\n one the wrong answer for the other.\n\n UNSPECIFIED is not a level and is never stored - the column's CHECK excludes it. A\n request that leaves it at proto3's zero is treated as PRIVATE, which is the direction to\n be wrong in: the cost of failing closed is a confusing error, and the cost of failing\n open is a port somebody published without meaning to.\n\n- `PORT_ACCESS_PRIVATE`: Only the workspace's owner, who must be signed in.\n- `PORT_ACCESS_WHITELIST`: The owner, and the users the owner granted. See GrantPortAccess.\n- `PORT_ACCESS_PUBLIC`: Anyone, with no session at all. Nothing is asked and nobody is redirected to a login.\n  Until the workspace stops or fails: then the port is PRIVATE again, and made public again\n  when it is meant to be.",
        "x-enum-descriptions": [
          "",
          "Only the workspace's owner, who must be signed in.",
          "The owner, and the users the owner granted. See GrantPortAccess.",
          "Anyone, with no session at all. Nothing is asked and nobody is redirected to a login.\n Until the workspace stops or fails: then the port is PRIVATE again, and made public again\n when it is meant to be."
        ]
      },
      "spin.v1.PortGrant": {
        "type": "object",
        "properties": {
          "userId": {
            "type": "string",
            "title": "user_id"
          },
          "email": {
            "type": "string",
            "title": "email",
            "description": "Output only, so a list is readable without a second lookup"
          },
          "grantedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "granted_at"
          }
        },
        "title": "PortGrant",
        "additionalProperties": false,
        "description": "One user a whitelisted port is shared with."
      },
      "spin.v1.Prebuild": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          },
          "projectId": {
            "type": "string",
            "title": "project_id"
          },
          "ref": {
            "type": "string",
            "title": "ref"
          },
          "commit": {
            "type": "string",
            "title": "commit"
          },
          "state": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PrebuildState"
              }
            ],
            "title": "state"
          },
          "snapshotId": {
            "type": "string",
            "title": "snapshot_id"
          },
          "parentId": {
            "type": "string",
            "title": "parent_id",
            "description": "The prebuild it was built on, and how many builds it is from the image (0: built from it)."
          },
          "depth": {
            "type": "integer",
            "title": "depth",
            "format": "int32"
          },
          "image": {
            "type": "string",
            "title": "image"
          },
          "log": {
            "type": "string",
            "title": "log",
            "description": "The tail of what its build's create tasks wrote (GetPrebuild only), and why it failed."
          },
          "error": {
            "type": "string",
            "title": "error"
          },
          "createdAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "created_at"
          },
          "builtAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "built_at"
          },
          "workspaceCount": {
            "type": "integer",
            "title": "workspace_count",
            "format": "int32",
            "description": "In ListPrebuilds: the workspaces opened from it that are not deleted, whoever's they are."
          },
          "reportedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "reported_at",
            "description": "When its build's guest said the checkout and create tasks were done; unset before it did."
          },
          "spinYaml": {
            "type": "boolean",
            "title": "spin_yaml",
            "description": "Whether the checkout had a .spin.yaml at its root, as the guest reported: without one the\n build is the clone alone, with no create tasks run. Read only with reported_at."
          },
          "storedBytes": {
            "type": [
              "string",
              "null"
            ],
            "title": "stored_bytes",
            "format": "int64",
            "description": "What it keeps in the object store, as storage-gc last read it; unset before a reading\n counted it."
          },
          "buildWorkspaceId": {
            "type": "string",
            "title": "build_workspace_id",
            "description": "The workspace that ran its build (workspaces.prebuild_id), while its row is kept, and whose it\n is: its events, logs and traces are its owner's to read, and no list of workspaces shows it."
          },
          "buildWorkspaceOwnerId": {
            "type": "string",
            "title": "build_workspace_owner_id"
          }
        },
        "title": "Prebuild",
        "additionalProperties": false,
        "description": "A prebuild: one build of a project's ref at a commit, and the snapshot it left."
      },
      "spin.v1.PrebuildRefNotFound": {
        "type": "object",
        "properties": {
          "ref": {
            "type": "string",
            "title": "ref"
          },
          "since": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "since",
            "description": "The job's first look that found it missing."
          }
        },
        "title": "PrebuildRefNotFound",
        "additionalProperties": false,
        "description": "A prebuild ref the project's forge has not."
      },
      "spin.v1.PrebuildState": {
        "type": "string",
        "title": "PrebuildState",
        "enum": [
          "PREBUILD_STATE_UNSPECIFIED",
          "PREBUILD_STATE_BUILDING",
          "PREBUILD_STATE_READY",
          "PREBUILD_STATE_FAILED",
          "PREBUILD_STATE_RETIRED"
        ],
        "description": "- `PREBUILD_STATE_RETIRED`: Superseded and given back: its snapshot is being deleted.",
        "x-enum-descriptions": [
          "",
          "",
          "",
          "",
          "Superseded and given back: its snapshot is being deleted."
        ]
      },
      "spin.v1.PrebuildsKept": {
        "type": "object",
        "properties": {
          "storedBytes": {
            "type": "string",
            "title": "stored_bytes",
            "format": "int64",
            "description": "As the store was last read (Admin's Storage, PREBUILD)."
          },
          "day": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "day",
            "description": "The billed day the rate is from: its first instant, UTC. Unset, with month_micros, where no day\n before the reading billed the bucket, or the prebuilds keep nothing."
          },
          "monthMicros": {
            "type": [
              "string",
              "null"
            ],
            "title": "month_micros",
            "format": "int64"
          }
        },
        "title": "PrebuildsKept",
        "additionalProperties": false,
        "description": "What a project's prebuilds keep in the volumes' bucket, and what that would cost a month at what\n the last billed day charged: an estimate, never said without the day it is from."
      },
      "spin.v1.PreemptionSource": {
        "type": "string",
        "title": "PreemptionSource",
        "enum": [
          "PREEMPTION_SOURCE_UNSPECIFIED",
          "PREEMPTION_SOURCE_AWS",
          "PREEMPTION_SOURCE_GCP",
          "PREEMPTION_SOURCE_AZURE"
        ],
        "description": "PreemptionSource mirrors spin.agent.v1.PreemptionSource, which is what reaches the host."
      },
      "spin.v1.Problem": {
        "type": "object",
        "properties": {
          "cause": {
            "type": "string",
            "title": "cause",
            "description": "cause says in a line what was found."
          },
          "since": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "since",
            "description": "since is when what decided it was so, as HealthCheck.known_at is: a host's command stream\n last heard, a check's last run, a job's failed run. Unset where nothing says."
          },
          "impact": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.ProblemImpact"
              }
            ],
            "title": "impact"
          },
          "evidence": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.ProblemEvidence"
            },
            "title": "evidence",
            "description": "What shows it, each a thing the console has a page for."
          },
          "runbookId": {
            "type": "string",
            "title": "runbook_id",
            "description": "The runbook to follow (Runbook.id), of the runbooks this release serves: never empty."
          },
          "actions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.ProblemAction"
            },
            "title": "actions",
            "description": "What the console itself can do about it, each on the host or the job the problem is of."
          },
          "hostId": {
            "type": "string",
            "title": "host_id",
            "description": "The host the problem is of, and the name its machine goes by; empty for one that is not a\n host's."
          },
          "hostname": {
            "type": "string",
            "title": "hostname"
          },
          "job": {
            "type": "string",
            "title": "job",
            "description": "The job (Job.name) the problem is of, and its title; empty for one that is not a job's."
          },
          "jobTitle": {
            "type": "string",
            "title": "job_title"
          }
        },
        "title": "Problem",
        "additionalProperties": false,
        "description": "Problem is one thing wrong with the installation, said whole: why, what it takes down, what\n shows it and what to do. Nothing is kept of it - it is read off the installation as it is now,\n and is gone when what caused it is."
      },
      "spin.v1.ProblemAction": {
        "type": "string",
        "title": "ProblemAction",
        "enum": [
          "PROBLEM_ACTION_UNSPECIFIED",
          "PROBLEM_ACTION_CORDON_HOST",
          "PROBLEM_ACTION_DRAIN_HOST",
          "PROBLEM_ACTION_RUN_JOB",
          "PROBLEM_ACTION_RECOVER_WORKSPACE"
        ],
        "description": "ProblemAction is something the console can do about a problem, each an RPC it has.\n\n- `PROBLEM_ACTION_CORDON_HOST`: DrainHost without suspend: the host takes no new workspace and keeps what it runs.\n- `PROBLEM_ACTION_DRAIN_HOST`: DrainHost with suspend: its workspaces are moved to other hosts.\n- `PROBLEM_ACTION_RUN_JOB`: RunJobNow: the job is run again, now.\n- `PROBLEM_ACTION_RECOVER_WORKSPACE`: RecoverUserWorkspace, of each workspace the problem names: its disk is on a host that is gone,\n  and it runs again only once moved off it.",
        "x-enum-descriptions": [
          "",
          "DrainHost without suspend: the host takes no new workspace and keeps what it runs.",
          "DrainHost with suspend: its workspaces are moved to other hosts.",
          "RunJobNow: the job is run again, now.",
          "RecoverUserWorkspace, of each workspace the problem names: its disk is on a host that is gone,\n and it runs again only once moved off it."
        ]
      },
      "spin.v1.ProblemEvidence": {
        "type": "object",
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "hostId": {
                "type": "string",
                "title": "host_id",
                "description": "A host: its page under Admin → Runners."
              }
            },
            "title": "host_id"
          },
          {
            "type": "object",
            "properties": {
              "job": {
                "type": "string",
                "title": "job",
                "description": "A job (Job.name): its runs under Admin → Jobs."
              }
            },
            "title": "job"
          },
          {
            "type": "object",
            "properties": {
              "logQuery": {
                "type": "string",
                "title": "log_query",
                "description": "A query of the log store, as SearchPlatformLogs takes it."
              }
            },
            "title": "log_query"
          },
          {
            "type": "object",
            "properties": {
              "traceId": {
                "type": "string",
                "title": "trace_id",
                "description": "A trace: a failed job run's."
              }
            },
            "title": "trace_id"
          }
        ],
        "unevaluatedProperties": false,
        "not": {
          "allOf": [
            {
              "anyOf": [
                {
                  "required": [
                    "hostId"
                  ]
                },
                {
                  "required": [
                    "job"
                  ]
                },
                {
                  "required": [
                    "logQuery"
                  ]
                },
                {
                  "required": [
                    "traceId"
                  ]
                }
              ]
            },
            {
              "not": {
                "oneOf": [
                  {
                    "required": [
                      "hostId"
                    ]
                  },
                  {
                    "required": [
                      "job"
                    ]
                  },
                  {
                    "required": [
                      "logQuery"
                    ]
                  },
                  {
                    "required": [
                      "traceId"
                    ]
                  }
                ]
              }
            }
          ]
        },
        "title": "ProblemEvidence",
        "description": "ProblemEvidence names one thing that shows a problem. The console turns each into a link to\n its own page; none is a URL."
      },
      "spin.v1.ProblemImpact": {
        "type": "object",
        "properties": {
          "stops": {
            "type": "string",
            "title": "stops",
            "description": "What stops working, in a line: \"log lines are not kept\". Empty where the rows say it."
          },
          "runningWorkspaces": {
            "type": "integer",
            "title": "running_workspaces",
            "format": "int32",
            "description": "The workspaces it affects, counted whole: running on the host now, and at rest with their\n disk only there - stopped or failed, each one's next start is on that host. For workspaces\n waiting for a host, waiting_workspaces."
          },
          "restingWorkspaces": {
            "type": "integer",
            "title": "resting_workspaces",
            "format": "int32"
          },
          "waitingWorkspaces": {
            "type": "integer",
            "title": "waiting_workspaces",
            "format": "int32"
          },
          "workspaces": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.AffectedWorkspace"
            },
            "title": "workspaces",
            "description": "At most 10 of them, the running first, then by name: the counts above are the whole."
          }
        },
        "title": "ProblemImpact",
        "additionalProperties": false,
        "description": "ProblemImpact is what a problem takes down: the workspaces under it as rows of the database,\n or, for a part with nothing under it, what stops working."
      },
      "spin.v1.Project": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          },
          "name": {
            "type": "string",
            "title": "name"
          },
          "slug": {
            "type": "string",
            "title": "slug",
            "description": "What a person names it by in the installation: teams.slug's shape"
          },
          "description": {
            "type": "string",
            "title": "description"
          },
          "repository": {
            "type": "string",
            "title": "repository",
            "description": "An https URL, with nothing of a credential in it"
          },
          "ref": {
            "type": "string",
            "title": "ref",
            "description": "The branch or tag a workspace opens at unless the open names one"
          },
          "image": {
            "type": "string",
            "title": "image",
            "description": "As CreateWorkspaceRequest.image; empty is the installation's default when opened"
          },
          "preset": {
            "type": "string",
            "title": "preset",
            "description": "As CreateWorkspaceRequest.preset; empty likewise"
          },
          "networkTags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "network_tags"
          },
          "workspaceCount": {
            "type": "integer",
            "title": "workspace_count",
            "format": "int32",
            "description": "Workspaces open on it, the trash included"
          },
          "createdAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "created_at"
          },
          "updatedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "updated_at"
          },
          "prebuildRefs": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "prebuild_refs",
            "description": "The refs it prebuilds (spin#480 §3): none is none. Each is built as it moves, and opening the\n project at one clones its newest ready prebuild."
          },
          "prebuildRebaseEvery": {
            "type": "integer",
            "title": "prebuild_rebase_every",
            "format": "int32",
            "description": "Every how many prebuilds of a ref one is built from the image again, rather than on the one\n before: a clone is a layer deeper than what it is cloned from."
          },
          "prebuildOwnerId": {
            "type": "string",
            "title": "prebuild_owner_id",
            "description": "Who the builds run as, for what they use: the project admin who last named the refs."
          },
          "sharedWithEveryone": {
            "type": "boolean",
            "title": "shared_with_everyone",
            "description": "Seen by everybody signed in; otherwise by its admins and shares."
          },
          "administers": {
            "type": "boolean",
            "title": "administers",
            "description": "Whether the caller may change, share and delete it."
          },
          "adminIds": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "admin_ids",
            "description": "Its admins and whom it is shared with: shown to its admins, empty to everybody else."
          },
          "sharedUserIds": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "shared_user_ids"
          },
          "sharedTeamIds": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "shared_team_ids"
          },
          "readyPrebuildCount": {
            "type": "integer",
            "title": "ready_prebuild_count",
            "format": "int32",
            "description": "In ListProjects: how many of its prebuilds are ready to open from."
          },
          "prebuildKeep": {
            "type": "integer",
            "title": "prebuild_keep",
            "format": "int32",
            "description": "How many of each ref's newest ready prebuilds are kept when no workspace was opened from them."
          },
          "timeToReady": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.ProjectTimeToReady"
              }
            ],
            "title": "time_to_ready",
            "description": "In GetProject: how long its workspaces took to be ready. Unset where none has been."
          }
        },
        "title": "Project",
        "additionalProperties": false,
        "description": "A project: a repository and the shape of the workspace that opens it."
      },
      "spin.v1.ProjectTimeToReady": {
        "type": "object",
        "properties": {
          "workspaces": {
            "type": "integer",
            "title": "workspaces",
            "format": "int32",
            "description": "How many workspaces the times are over: 1 to 20."
          },
          "median": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Duration"
              }
            ],
            "title": "median"
          },
          "slowest": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Duration"
              }
            ],
            "title": "slowest"
          }
        },
        "title": "ProjectTimeToReady",
        "additionalProperties": false,
        "description": "How long a project's workspaces took from their create to their project being ready in them -\n the repository checked out and its create tasks done, as each one's guest first said it, the\n wait for a host and the boot included - over the last 20 that got there. One that never did -\n it failed, or was deleted first - is not counted, and neither is one opened from a prebuild:\n this is what opening without one costs. A workspace whose first boots failed its project counts\n from its create to the boot that went."
      },
      "spin.v1.ProjectWorkspace": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          },
          "name": {
            "type": "string",
            "title": "name"
          },
          "ownerId": {
            "type": "string",
            "title": "owner_id"
          },
          "ownerName": {
            "type": "string",
            "title": "owner_name"
          },
          "ownerEmail": {
            "type": "string",
            "title": "owner_email"
          },
          "state": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.WorkspaceState"
              }
            ],
            "title": "state",
            "description": "As Workspace.state, DEGRADED included."
          },
          "since": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "since",
            "description": "Since when it has been in that state: when its guest answered for a running one, and when\n its row last changed for any other."
          }
        },
        "title": "ProjectWorkspace",
        "additionalProperties": false,
        "description": "A workspace open on a project, as the project's admins read it: whose it is and how it is, and\n nothing that lets them into it."
      },
      "spin.v1.PublishVSCodeServersRequest": {
        "type": "object",
        "properties": {
          "newest": {
            "type": "integer",
            "title": "newest",
            "format": "int32",
            "description": "The newest stable releases to carry: 2 is the current one and the one before it."
          },
          "commits": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "commits",
            "description": "Commits to carry besides, each the second line of `code --version`."
          }
        },
        "title": "PublishVSCodeServersRequest",
        "additionalProperties": false
      },
      "spin.v1.PublishVSCodeServersResponse": {
        "type": "object",
        "title": "PublishVSCodeServersResponse",
        "additionalProperties": false
      },
      "spin.v1.QuarantineDenial": {
        "type": "object",
        "properties": {
          "target": {
            "type": "string",
            "title": "target",
            "description": "Where the attempt went: the destination, as the supervisor saw it (host and port)."
          },
          "details": {
            "type": "object",
            "title": "details",
            "additionalProperties": {
              "type": "string",
              "title": "value"
            },
            "description": "What the supervisor held of it, in its own words: which user in the guest, which process,\n why the policy refused."
          },
          "at": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "at",
            "description": "When the attempt was made, as the guest clock held it."
          }
        },
        "title": "QuarantineDenial",
        "additionalProperties": false
      },
      "spin.v1.QuarantineWorkspaceRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id",
            "description": "The workspace's id."
          },
          "reason": {
            "type": "string",
            "title": "reason",
            "description": "What the administrator saw that led to holding it: kept on the audit entry for this act,\n not on the row."
          }
        },
        "title": "QuarantineWorkspaceRequest",
        "additionalProperties": false
      },
      "spin.v1.QuarantineWorkspaceResponse": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "name": {
            "type": "string",
            "title": "name"
          },
          "state": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.WorkspaceState"
              }
            ],
            "title": "state"
          },
          "quarantineHeld": {
            "type": "boolean",
            "title": "quarantine_held",
            "description": "Held, as Workspace.quarantine_held: a running workspace answers STOPPING, and this is what\n says the stop is the quarantine's."
          }
        },
        "title": "QuarantineWorkspaceResponse",
        "additionalProperties": false,
        "description": "The workspace as the quarantine left it, and no more of it: an administrator acts on a\n workspace that need not be theirs, and the rest of its row - its env - is its owner's (I27)."
      },
      "spin.v1.ReadFileRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "path": {
            "type": "string",
            "title": "path",
            "description": "path is absolute, or relative to root's home."
          }
        },
        "title": "ReadFileRequest",
        "additionalProperties": false
      },
      "spin.v1.ReadFileResponse": {
        "type": "object",
        "properties": {
          "content": {
            "type": "string",
            "title": "content",
            "format": "byte"
          }
        },
        "title": "ReadFileResponse",
        "additionalProperties": false
      },
      "spin.v1.RecoverUserWorkspaceRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id",
            "description": "The workspace's id."
          },
          "acceptDataLoss": {
            "type": "boolean",
            "title": "accept_data_loss",
            "description": "False asks what it would cost. True accepts that cost, for its owner, and does it."
          },
          "reason": {
            "type": "string",
            "title": "reason",
            "description": "Why: required, kept on the audit entry and on the workspace's history for its owner."
          }
        },
        "title": "RecoverUserWorkspaceRequest",
        "additionalProperties": false
      },
      "spin.v1.RecoverUserWorkspaceResponse": {
        "type": "object",
        "properties": {
          "recovery": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.RecoverWorkspaceResponse"
              }
            ],
            "title": "recovery"
          }
        },
        "title": "RecoverUserWorkspaceResponse",
        "additionalProperties": false
      },
      "spin.v1.RecoverWorkspaceRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "acceptDataLoss": {
            "type": "boolean",
            "title": "accept_data_loss",
            "description": "False asks what it would cost. True accepts that cost and does it."
          }
        },
        "title": "RecoverWorkspaceRequest",
        "additionalProperties": false,
        "description": "Recovering a workspace whose host is gone.\n\n StartWorkspace requires the host the workspace was placed on and refuses while it is not\n connected, so a workspace on a host that died cannot be started again - there is no\n amount of waiting or retrying that fixes it. Recovering re-homes it: the volume is taken\n from the dead host and placed on a live one, and the workspace becomes startable.\n\n The cost is everything the dead host had written and not yet published, and that cost is\n the owner's to accept rather than an operator's to impose - which is why this is an RPC\n of theirs. Called without accept_data_loss it reports the cost and changes nothing; the\n same call with it does the work.\n\n It is not automatic. A host wrongly believed dead, recovered from, is two machines\n writing one disk - which is the failure the whole lease exists to prevent. The safety is\n not in the confirmation, though: taking the volume goes through the same check an\n operator's -detach-volume does, and is refused unless the old host has been *observed* to\n have stopped. The confirmation is about the data, not about the fencing."
      },
      "spin.v1.RecoverWorkspaceResponse": {
        "type": "object",
        "properties": {
          "recovered": {
            "type": "boolean",
            "title": "recovered",
            "description": "False for a cost report, true when the workspace was re-homed."
          },
          "unpublishedSeconds": {
            "type": "string",
            "title": "unpublished_seconds",
            "format": "int64",
            "description": "What recovering costs: the work the dead host had not published, as of its last\n report, plus the time since - a host that has been silent for an hour has been writing\n for that hour too, and reporting only what it last said would understate it."
          },
          "unpublishedBytes": {
            "type": "string",
            "title": "unpublished_bytes",
            "format": "int64"
          },
          "hostLastReportedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "host_last_reported_at",
            "description": "When that report was made. The two numbers above are only as fresh as this."
          },
          "newHostId": {
            "type": "string",
            "title": "new_host_id",
            "description": "The host it now runs on. Set only when recovered."
          }
        },
        "title": "RecoverWorkspaceResponse",
        "additionalProperties": false
      },
      "spin.v1.RefusedDestination": {
        "type": "object",
        "properties": {
          "address": {
            "type": "string",
            "title": "address"
          },
          "name": {
            "type": "string",
            "title": "name"
          },
          "protocol": {
            "type": "string",
            "title": "protocol",
            "description": "\"tcp\", \"udp\", \"icmp\", or the protocol's number."
          },
          "port": {
            "type": "integer",
            "title": "port",
            "description": "For tcp and udp; zero otherwise."
          },
          "packets": {
            "type": "string",
            "title": "packets",
            "format": "int64"
          }
        },
        "title": "RefusedDestination",
        "additionalProperties": false
      },
      "spin.v1.RefusedVolume": {
        "type": "object",
        "properties": {
          "volumeId": {
            "type": "string",
            "title": "volume_id"
          },
          "refusal": {
            "type": "string",
            "title": "refusal",
            "description": "The token an alert keys on, and the sentence the host sent with it (VolumeStatus)."
          },
          "refusalDetail": {
            "type": "string",
            "title": "refusal_detail"
          },
          "hostId": {
            "type": "string",
            "title": "host_id",
            "description": "The host refusing it; empty for a disk placed nowhere."
          },
          "hostName": {
            "type": "string",
            "title": "host_name"
          },
          "workspaceId": {
            "type": "string",
            "title": "workspace_id",
            "description": "The workspace it is the disk of; empty for a disk no workspace runs on."
          },
          "workspaceName": {
            "type": "string",
            "title": "workspace_name"
          },
          "workspaceState": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.WorkspaceState"
              }
            ],
            "title": "workspace_state"
          },
          "ownerId": {
            "type": "string",
            "title": "owner_id",
            "description": "Whose the workspace is."
          },
          "ownerEmail": {
            "type": "string",
            "title": "owner_email"
          }
        },
        "title": "RefusedVolume",
        "additionalProperties": false,
        "description": "RefusedVolume is a disk its host is not serving, and the workspace that cannot run for it."
      },
      "spin.v1.RegisterPasskeyRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "title": "name"
          },
          "challenge": {
            "type": "string",
            "title": "challenge",
            "format": "byte"
          },
          "credentialId": {
            "type": "string",
            "title": "credential_id",
            "format": "byte"
          },
          "clientDataJson": {
            "type": "string",
            "title": "client_data_json",
            "format": "byte"
          },
          "authenticatorData": {
            "type": "string",
            "title": "authenticator_data",
            "format": "byte"
          },
          "publicKey": {
            "type": "string",
            "title": "public_key",
            "format": "byte",
            "description": "The credential's public key, SubjectPublicKeyInfo (AuthenticatorAttestationResponse.getPublicKey)."
          },
          "stepUp": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PasskeyAssertion"
              }
            ],
            "title": "step_up",
            "description": "An assertion of a passkey the account has, over a PASSKEY_PURPOSE_ADD_PASSKEY challenge naming\n this credential; unset for the account's first."
          }
        },
        "title": "RegisterPasskeyRequest",
        "additionalProperties": false
      },
      "spin.v1.RegisterPasskeyResponse": {
        "type": "object",
        "properties": {
          "passkey": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.Passkey"
              }
            ],
            "title": "passkey"
          }
        },
        "title": "RegisterPasskeyResponse",
        "additionalProperties": false
      },
      "spin.v1.RegistrationMode": {
        "type": "string",
        "title": "RegistrationMode",
        "enum": [
          "REGISTRATION_MODE_UNSPECIFIED",
          "REGISTRATION_MODE_OPEN",
          "REGISTRATION_MODE_WHITELIST",
          "REGISTRATION_MODE_CLOSED"
        ],
        "description": "Registration mode enum\n\n- `REGISTRATION_MODE_OPEN`: Anyone can register\n- `REGISTRATION_MODE_WHITELIST`: Only whitelisted emails/domains\n- `REGISTRATION_MODE_CLOSED`: No new registrations",
        "x-enum-descriptions": [
          "",
          "Anyone can register",
          "Only whitelisted emails/domains",
          "No new registrations"
        ]
      },
      "spin.v1.RegistrationToken": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          },
          "tokenPrefix": {
            "type": "string",
            "title": "token_prefix",
            "description": "First 8 chars for identification"
          },
          "description": {
            "type": "string",
            "title": "description",
            "description": "Human-readable description"
          },
          "teamId": {
            "type": "string",
            "title": "team_id",
            "description": "Optional: team scope for registered host"
          },
          "expiresAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "expires_at"
          },
          "createdAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "created_at"
          },
          "createdBy": {
            "type": "string",
            "title": "created_by"
          },
          "used": {
            "type": "boolean",
            "title": "used"
          },
          "usedByHostId": {
            "type": "string",
            "title": "used_by_host_id",
            "description": "Host ID that used this token; a reusable token's last one"
          },
          "reusable": {
            "type": "boolean",
            "title": "reusable",
            "description": "A pool's token: it registers every host that presents it until it expires or is revoked."
          },
          "hostPolicy": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.HostPolicy"
              }
            ],
            "title": "host_policy",
            "description": "What every host it registers is told (HostPolicy without its host_id); unset tells them\n nothing, and they keep their own defaults until an operator says otherwise."
          }
        },
        "title": "RegistrationToken",
        "additionalProperties": false
      },
      "spin.v1.RekeyState": {
        "type": "string",
        "title": "RekeyState",
        "enum": [
          "REKEY_STATE_UNSPECIFIED",
          "REKEY_STATE_PENDING",
          "REKEY_STATE_COPYING",
          "REKEY_STATE_READY"
        ],
        "description": "RekeyState is how far a disk's re-key is.\n\n- `REKEY_STATE_PENDING`: Marked by a revoke: re-keyed once its workspace cannot run.\n- `REKEY_STATE_COPYING`: A host is copying the disk.\n- `REKEY_STATE_READY`: Copied: the workspace is pointed at the copy and the disk deleted on the next pass.",
        "x-enum-descriptions": [
          "",
          "Marked by a revoke: re-keyed once its workspace cannot run.",
          "A host is copying the disk.",
          "Copied: the workspace is pointed at the copy and the disk deleted on the next pass."
        ]
      },
      "spin.v1.RekeyVolumeRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          }
        },
        "title": "RekeyVolumeRequest",
        "additionalProperties": false
      },
      "spin.v1.RekeyVolumeResponse": {
        "type": "object",
        "properties": {
          "targetVolumeId": {
            "type": "string",
            "title": "target_volume_id"
          }
        },
        "title": "RekeyVolumeResponse",
        "additionalProperties": false,
        "description": "The volume the disk is being copied into; the workspace is pointed at it once the copy is\n published."
      },
      "spin.v1.ReleaseWorkspaceQuarantineRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id",
            "description": "The workspace's id."
          }
        },
        "title": "ReleaseWorkspaceQuarantineRequest",
        "additionalProperties": false
      },
      "spin.v1.ReleaseWorkspaceQuarantineResponse": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "name": {
            "type": "string",
            "title": "name"
          },
          "state": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.WorkspaceState"
              }
            ],
            "title": "state"
          },
          "quarantineHeld": {
            "type": "boolean",
            "title": "quarantine_held"
          }
        },
        "title": "ReleaseWorkspaceQuarantineResponse",
        "additionalProperties": false,
        "description": "The workspace as the release left it, and no more of it, as QuarantineWorkspaceResponse."
      },
      "spin.v1.ReleaseWorkspaceResourcesRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          }
        },
        "title": "ReleaseWorkspaceResourcesRequest",
        "additionalProperties": false
      },
      "spin.v1.ReleaseWorkspaceResourcesResponse": {
        "type": "object",
        "properties": {
          "workspace": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.Workspace"
              }
            ],
            "title": "workspace"
          }
        },
        "title": "ReleaseWorkspaceResourcesResponse",
        "additionalProperties": false
      },
      "spin.v1.RemoveAllowedEmailRequest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          }
        },
        "title": "RemoveAllowedEmailRequest",
        "additionalProperties": false
      },
      "spin.v1.RemoveAllowedEmailResponse": {
        "type": "object",
        "title": "RemoveAllowedEmailResponse",
        "additionalProperties": false
      },
      "spin.v1.RemoveHostRequest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          },
          "taken": {
            "type": "boolean",
            "title": "taken",
            "description": "The host is believed taken - compromised - rather than only no longer wanted. Its credentials\n are deleted and its stream cut before its group is asked anything, and every team's disk whose\n key it was given is marked for re-keying. A routine removal - a scale-in, a machine reclaimed -\n leaves it unset, and marks none."
          },
          "leaveWorkspaces": {
            "type": "boolean",
            "title": "leave_workspaces",
            "description": "Remove a taken host although it is the only home of workspaces' disks. Refused without it,\n naming them; with it each runs again only once it is recovered onto another host\n (RecoverWorkspace), which gives up what this host had not published. Only with taken: a\n routine removal loses no disk."
          }
        },
        "title": "RemoveHostRequest",
        "additionalProperties": false
      },
      "spin.v1.RemoveHostResponse": {
        "type": "object",
        "properties": {
          "removal": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.HostRemoval"
              }
            ],
            "title": "removal",
            "description": "removal is what was done: GIVE_BACK or FORGET."
          },
          "givenBack": {
            "type": "boolean",
            "title": "given_back",
            "description": "given_back is the machine terminated and its group asked for one less; false where the\n group no longer had it."
          },
          "forgotten": {
            "type": "boolean",
            "title": "forgotten",
            "description": "forgotten is the host's row gone. A host given back while connected is not: it drains under\n its termination hook, and its row goes when its stream ends."
          },
          "markedForRekey": {
            "type": "integer",
            "title": "marked_for_rekey",
            "format": "int32",
            "description": "marked_for_rekey is how many teams' disks were marked for re-keying: those whose key a host\n removed as taken was given. Zero for a routine removal."
          },
          "kept": {
            "type": "string",
            "title": "kept",
            "description": "kept is why the row was not forgotten, where it was not and should have been: the workspace\n whose disk is only there, or the volume that would not leave it and whose that is. Empty\n when forgotten, and for a host given back while connected."
          }
        },
        "title": "RemoveHostResponse",
        "additionalProperties": false
      },
      "spin.v1.RemoveStoredVolumeRequest": {
        "type": "object",
        "properties": {
          "volumeId": {
            "type": "string",
            "title": "volume_id"
          }
        },
        "title": "RemoveStoredVolumeRequest",
        "additionalProperties": false
      },
      "spin.v1.RemoveStoredVolumeResponse": {
        "type": "object",
        "title": "RemoveStoredVolumeResponse",
        "additionalProperties": false,
        "description": "The volume's key went with it: a key no other volume holds, so its layers open for nobody."
      },
      "spin.v1.RemoveTeamMemberRequest": {
        "type": "object",
        "properties": {
          "teamId": {
            "type": "string",
            "title": "team_id"
          },
          "userId": {
            "type": "string",
            "title": "user_id"
          }
        },
        "title": "RemoveTeamMemberRequest",
        "additionalProperties": false
      },
      "spin.v1.RemoveTeamMemberResponse": {
        "type": "object",
        "title": "RemoveTeamMemberResponse",
        "additionalProperties": false
      },
      "spin.v1.RemoveWorkspaceGuestRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "userId": {
            "type": "string",
            "title": "user_id"
          }
        },
        "title": "RemoveWorkspaceGuestRequest",
        "additionalProperties": false
      },
      "spin.v1.RemoveWorkspaceGuestResponse": {
        "type": "object",
        "title": "RemoveWorkspaceGuestResponse",
        "additionalProperties": false
      },
      "spin.v1.RequestHostShellRequest": {
        "type": "object",
        "properties": {
          "hostId": {
            "type": "string",
            "title": "host_id"
          },
          "reason": {
            "type": "string",
            "title": "reason",
            "description": "Why: said to whoever approves it, and kept."
          },
          "minutes": {
            "type": "integer",
            "title": "minutes",
            "format": "int32",
            "description": "How long it is open once it opens, up to the installation's host_shell_max_minutes."
          },
          "incident": {
            "type": "boolean",
            "title": "incident",
            "description": "Opens on the host as it is, its workspaces running: for a host that has to be looked at busy."
          }
        },
        "title": "RequestHostShellRequest",
        "additionalProperties": false
      },
      "spin.v1.RequestHostShellResponse": {
        "type": "object",
        "properties": {
          "shell": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.HostShell"
              }
            ],
            "title": "shell"
          }
        },
        "title": "RequestHostShellResponse",
        "additionalProperties": false
      },
      "spin.v1.ResolverLookup": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "title": "name"
          },
          "outcome": {
            "type": "string",
            "title": "outcome",
            "description": "filtered, refused, upstream_failed or malformed."
          },
          "at": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "at"
          }
        },
        "title": "ResolverLookup",
        "additionalProperties": false
      },
      "spin.v1.ResourcePreset": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          },
          "name": {
            "type": "string",
            "title": "name",
            "description": "Display name (e.g., \"Small\", \"Medium\", \"Large\")"
          },
          "description": {
            "type": "string",
            "title": "description",
            "description": "Description of the preset"
          },
          "cpuCores": {
            "type": "integer",
            "title": "cpu_cores",
            "format": "int32",
            "description": "Number of CPU cores"
          },
          "memoryMb": {
            "type": "integer",
            "title": "memory_mb",
            "format": "int32",
            "description": "Memory in megabytes"
          },
          "diskGb": {
            "type": "integer",
            "title": "disk_gb",
            "format": "int32",
            "description": "Disk space in gigabytes"
          },
          "burst": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.BurstMode"
              }
            ],
            "title": "burst"
          },
          "isDefault": {
            "type": "boolean",
            "title": "is_default",
            "description": "This is the default preset"
          },
          "enabled": {
            "type": "boolean",
            "title": "enabled",
            "description": "Preset is available for selection"
          },
          "sortOrder": {
            "type": "integer",
            "title": "sort_order",
            "format": "int32",
            "description": "Display order (lower = first)"
          },
          "createdAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "created_at"
          },
          "updatedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "updated_at"
          },
          "burstFloorCpuCores": {
            "type": "integer",
            "title": "burst_floor_cpu_cores",
            "format": "int32",
            "description": "What a workspace of a burst mode starts with; at most cpu_cores and memory_mb."
          },
          "burstFloorMemoryMb": {
            "type": "integer",
            "title": "burst_floor_memory_mb",
            "format": "int32"
          },
          "bandwidthMbps": {
            "type": "integer",
            "title": "bandwidth_mbps",
            "format": "int32",
            "description": "What a workspace of it may carry each way, in megabits a second; 0 is unshaped."
          },
          "rpoSeconds": {
            "type": "integer",
            "title": "rpo_seconds",
            "format": "int32",
            "description": "How far behind the object store a workspace of it may fall, in seconds; 0 is the\n installation's (the setting volume_rpo_seconds)."
          },
          "hostClass": {
            "type": "string",
            "title": "host_class",
            "description": "The host class its workspaces run on (HostClass)."
          },
          "agentMinMemoryMb": {
            "type": "integer",
            "title": "agent_min_memory_mb",
            "format": "int32",
            "description": "What a workspace has to hold for its agent to start there, in MB, for whoever picks a preset."
          },
          "fromConfig": {
            "type": "boolean",
            "title": "from_config",
            "description": "Seeded or applied from the installation's config file (the release's presets where it names\n none); false is one an administrator added. An edit since does not change it."
          },
          "minMemoryMb": {
            "type": "integer",
            "title": "min_memory_mb",
            "format": "int32",
            "description": "The least any preset may start its workspaces at, in MB: memory_mb for a fixed one,\n burst_floor_memory_mb for a burst one. A create or update below it is refused; one written\n before it was asked keeps what it has until an administrator changes it."
          }
        },
        "title": "ResourcePreset",
        "additionalProperties": false,
        "description": "ResourcePreset is a class of workspace: its size, and how a workspace of it may grow. Every\n workspace is created from one."
      },
      "spin.v1.Resources": {
        "type": "object",
        "properties": {
          "cpuCores": {
            "type": "integer",
            "title": "cpu_cores",
            "format": "int32",
            "description": "Initial CPU cores at boot (default: 1)"
          },
          "memoryMb": {
            "type": "integer",
            "title": "memory_mb",
            "format": "int32",
            "description": "Initial memory in MB at boot (default: 512)"
          },
          "diskGb": {
            "type": "integer",
            "title": "disk_gb",
            "format": "int32",
            "description": "Disk size in GB (default: 10)"
          },
          "maxCpuCores": {
            "type": "integer",
            "title": "max_cpu_cores",
            "format": "int32",
            "description": "Max CPU cores (0 = unlimited)"
          },
          "maxMemoryMb": {
            "type": "integer",
            "title": "max_memory_mb",
            "format": "int32",
            "description": "Max memory in MB (0 = unlimited)"
          },
          "bandwidthMbps": {
            "type": "integer",
            "title": "bandwidth_mbps",
            "format": "int32",
            "description": "What a workspace's network carries each way, in megabits a second (0 = unshaped): its\n preset's, held on its host by a token bucket on each way out of its machine's namespace.\n Its vsock - ssh, the editor, forwarded ports - is not shaped."
          }
        },
        "title": "Resources",
        "additionalProperties": false,
        "description": "Resource allocation for workspaces.\n Initial values (cpu_cores, memory_mb) are used at boot time.\n Max values control scaling limits:\n   - 0 = unlimited (burstable to host capacity)\n   - \u003e0 = hard limit (cannot exceed)"
      },
      "spin.v1.RestoreWorkspaceRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "snapshotId": {
            "type": "string",
            "title": "snapshot_id",
            "description": "One of this workspace's own published snapshots. Empty restores what the workspace was\n created from - its image's snapshot as it was at creation, not the one the image names now."
          },
          "withMemory": {
            "type": "boolean",
            "title": "with_memory",
            "description": "with_memory resumes the snapshot's memory too: the workspace's processes go on from the\n instant the snapshot was taken, running or stopped before. Only for a snapshot taken with\n memory; a running workspace is resumed only on its own host."
          }
        },
        "title": "RestoreWorkspaceRequest",
        "additionalProperties": false,
        "description": "RestoreWorkspaceRequest gives a stopped workspace a new disk, cloned from snapshot_id on the\n host it already runs on, and keeps everything else about it: its name, its keys, its ports,\n its resources. The disk it had is kept too, detached, because the snapshots taken of it\n after the one restored are still the workspace's - restoring to one of those is how a\n restore is undone.\n\n What the workspace had written since its last snapshot is given up. That is the request,\n which is why a running workspace is refused rather than stopped for the caller: stopping is\n the caller saying it has nothing left to keep. With memory, the snapshot's own instant is the\n thing kept, and a running workspace is put back to it."
      },
      "spin.v1.RestoreWorkspaceResponse": {
        "type": "object",
        "properties": {
          "workspace": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.Workspace"
              }
            ],
            "title": "workspace"
          }
        },
        "title": "RestoreWorkspaceResponse",
        "additionalProperties": false
      },
      "spin.v1.RetryPlatformImagesRequest": {
        "type": "object",
        "title": "RetryPlatformImagesRequest",
        "additionalProperties": false
      },
      "spin.v1.RetryPlatformImagesResponse": {
        "type": "object",
        "title": "RetryPlatformImagesResponse",
        "additionalProperties": false
      },
      "spin.v1.RevokeAPIKeyRequest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          }
        },
        "title": "RevokeAPIKeyRequest",
        "additionalProperties": false
      },
      "spin.v1.RevokeAPIKeyResponse": {
        "type": "object",
        "title": "RevokeAPIKeyResponse",
        "additionalProperties": false
      },
      "spin.v1.RevokePortAccessRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "port": {
            "type": "integer",
            "title": "port",
            "format": "int32"
          },
          "userId": {
            "type": "string",
            "title": "user_id"
          }
        },
        "title": "RevokePortAccessRequest",
        "additionalProperties": false
      },
      "spin.v1.RevokePortAccessResponse": {
        "type": "object",
        "properties": {
          "exposedPort": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.ExposedPort"
              }
            ],
            "title": "exposed_port"
          }
        },
        "title": "RevokePortAccessResponse",
        "additionalProperties": false
      },
      "spin.v1.RevokeRegistrationTokenRequest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          }
        },
        "title": "RevokeRegistrationTokenRequest",
        "additionalProperties": false,
        "description": "Admin: Revoke registration token"
      },
      "spin.v1.RevokeRegistrationTokenResponse": {
        "type": "object",
        "title": "RevokeRegistrationTokenResponse",
        "additionalProperties": false
      },
      "spin.v1.RevokeRunnerRequest": {
        "type": "object",
        "properties": {
          "hostId": {
            "type": "string",
            "title": "host_id"
          },
          "leaveWorkspaces": {
            "type": "boolean",
            "title": "leave_workspaces",
            "description": "Revoke although workspaces are on this host. Refused without it: each such workspace can\n then run only once it is recovered onto another host (RecoverWorkspace), which gives up what\n this host had not published. A machine that may be compromised is revoked with it anyway."
          }
        },
        "title": "RevokeRunnerRequest",
        "additionalProperties": false,
        "description": "Admin: Revoke runner"
      },
      "spin.v1.RevokeRunnerResponse": {
        "type": "object",
        "title": "RevokeRunnerResponse",
        "additionalProperties": false
      },
      "spin.v1.RevokeThirdPartyTermsRequest": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.ThirdPartyItem"
            },
            "title": "items"
          }
        },
        "title": "RevokeThirdPartyTermsRequest",
        "additionalProperties": false
      },
      "spin.v1.RevokeThirdPartyTermsResponse": {
        "type": "object",
        "title": "RevokeThirdPartyTermsResponse",
        "additionalProperties": false
      },
      "spin.v1.RevokeUserAPIKeyRequest": {
        "type": "object",
        "properties": {
          "userId": {
            "type": "string",
            "title": "user_id"
          },
          "id": {
            "type": "string",
            "title": "id"
          }
        },
        "title": "RevokeUserAPIKeyRequest",
        "additionalProperties": false
      },
      "spin.v1.RevokeUserAPIKeyResponse": {
        "type": "object",
        "title": "RevokeUserAPIKeyResponse",
        "additionalProperties": false
      },
      "spin.v1.RoleCost": {
        "type": "object",
        "properties": {
          "role": {
            "type": "string",
            "title": "role",
            "description": "Empty where the resources carry none."
          },
          "micros": {
            "type": "string",
            "title": "micros",
            "format": "int64"
          }
        },
        "title": "RoleCost",
        "additionalProperties": false,
        "description": "What one role cost on one day, its services summed."
      },
      "spin.v1.RunJobNowRequest": {
        "type": "object",
        "properties": {
          "job": {
            "type": "string",
            "title": "job"
          }
        },
        "title": "RunJobNowRequest",
        "additionalProperties": false
      },
      "spin.v1.RunJobNowResponse": {
        "type": "object",
        "title": "RunJobNowResponse",
        "additionalProperties": false
      },
      "spin.v1.RunPrebuildRequest": {
        "type": "object",
        "properties": {
          "projectId": {
            "type": "string",
            "title": "project_id"
          },
          "ref": {
            "type": "string",
            "title": "ref",
            "description": "One of the project's prebuild refs."
          }
        },
        "title": "RunPrebuildRequest",
        "additionalProperties": false
      },
      "spin.v1.RunPrebuildResponse": {
        "type": "object",
        "properties": {
          "prebuild": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.Prebuild"
              }
            ],
            "title": "prebuild",
            "description": "The build, or the one already running at that commit."
          }
        },
        "title": "RunPrebuildResponse",
        "additionalProperties": false
      },
      "spin.v1.Runbook": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id",
            "description": "Stable: alert rules and pages link /admin/runbooks/\u003cid\u003e."
          },
          "title": {
            "type": "string",
            "title": "title"
          },
          "severity": {
            "type": "string",
            "title": "severity",
            "description": "critical, warning or info."
          },
          "owner": {
            "type": "string",
            "title": "owner",
            "description": "The role that keeps it true: operator, security."
          },
          "lastReviewed": {
            "type": "string",
            "title": "last_reviewed",
            "description": "YYYY-MM-DD: when it was last held to the release it describes."
          },
          "appliesTo": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.RunbookAppliesTo"
              }
            ],
            "title": "applies_to"
          }
        },
        "title": "Runbook",
        "additionalProperties": false
      },
      "spin.v1.RunbookAppliesTo": {
        "type": "object",
        "properties": {
          "alerts": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "alerts",
            "description": "Grafana alert rule uids."
          },
          "jobs": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "jobs",
            "description": "Control plane job names (Job.name)."
          },
          "events": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "events",
            "description": "The notices a workspace's owner gets, by WorkspaceEventType without its prefix: HELD."
          },
          "dashboards": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "dashboards",
            "description": "Grafana dashboard uids."
          }
        },
        "title": "RunbookAppliesTo",
        "additionalProperties": false,
        "description": "What sends an operator to a runbook, each as the installation names it."
      },
      "spin.v1.SSHKey": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          },
          "name": {
            "type": "string",
            "title": "name",
            "description": "User-provided name"
          },
          "fingerprint": {
            "type": "string",
            "title": "fingerprint",
            "description": "SHA256 fingerprint"
          },
          "publicKey": {
            "type": "string",
            "title": "public_key",
            "description": "Full public key"
          },
          "createdAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "created_at"
          },
          "expiresAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "expires_at",
            "description": "No last_used_at: a user's key authenticates inside the guest, over SSH, where the\n control plane is not, so the only honest answer it could give is \"unknown\". Compare\n ApiKey.last_used_at, which the control plane stamps because it is the thing being\n presented to.\n When an enrolled key stops logging in; unset for a key of the person's own."
          }
        },
        "title": "SSHKey",
        "additionalProperties": false,
        "description": "User's uploaded SSH public key"
      },
      "spin.v1.SearchLogsResponse": {
        "type": "object",
        "properties": {
          "records": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.LogRecord"
            },
            "title": "records"
          },
          "total": {
            "type": "string",
            "title": "total",
            "format": "int64",
            "description": "How many records the window holds that match, of which `records` is the newest `limit`."
          }
        },
        "title": "SearchLogsResponse",
        "additionalProperties": false
      },
      "spin.v1.SearchPlatformLogsRequest": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "title": "query",
            "description": "Quickwit's query language (https://quickwit.io/docs/reference/query-language). Empty is\n every record in the window."
          },
          "from": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "from",
            "description": "The window, both ends included. Unset `to` is now; unset `from` is an hour before `to`."
          },
          "to": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "to"
          },
          "limit": {
            "type": "integer",
            "title": "limit",
            "format": "int32",
            "description": "How many records: 1 to 1000, 100 when unset."
          },
          "offset": {
            "type": "integer",
            "title": "offset",
            "format": "int32",
            "description": "How many to skip from the first: the page after the first. With limit, at most 10000."
          },
          "oldestFirst": {
            "type": "boolean",
            "title": "oldest_first",
            "description": "The oldest first rather than the newest: the window read as it happened."
          }
        },
        "title": "SearchPlatformLogsRequest",
        "additionalProperties": false
      },
      "spin.v1.SearchRepositoriesRequest": {
        "type": "object",
        "properties": {
          "forge": {
            "type": "string",
            "title": "forge"
          },
          "query": {
            "type": "string",
            "title": "query",
            "description": "Empty lists the account's repositories, most recently pushed first."
          }
        },
        "title": "SearchRepositoriesRequest",
        "additionalProperties": false
      },
      "spin.v1.SearchRepositoriesResponse": {
        "type": "object",
        "properties": {
          "repositories": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.ForgeRepository"
            },
            "title": "repositories"
          }
        },
        "title": "SearchRepositoriesResponse",
        "additionalProperties": false
      },
      "spin.v1.SearchTracesRequest": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "title": "query",
            "description": "Quickwit's query language, over each trace's first span: service_name, span_name,\n span_attributes.*, span_status.code. Empty is every trace in the window."
          },
          "from": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "from"
          },
          "to": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "to"
          },
          "limit": {
            "type": "integer",
            "title": "limit",
            "format": "int32",
            "description": "1 to 1000, 100 when unset."
          },
          "anySpan": {
            "type": "boolean",
            "title": "any_span",
            "description": "Search every span rather than each trace's first: a workspace's creation is the control\n plane's span inside a trace the browser began, and span_name or\n span_attributes.spin.workspace_id finds it only among all of them. Each span found is listed,\n and opens its whole trace."
          },
          "offset": {
            "type": "integer",
            "title": "offset",
            "format": "int32",
            "description": "As SearchPlatformLogsRequest's."
          }
        },
        "title": "SearchTracesRequest",
        "additionalProperties": false
      },
      "spin.v1.SearchTracesResponse": {
        "type": "object",
        "properties": {
          "roots": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.Span"
            },
            "title": "roots"
          },
          "total": {
            "type": "string",
            "title": "total",
            "format": "int64"
          }
        },
        "title": "SearchTracesResponse",
        "additionalProperties": false
      },
      "spin.v1.SearchUsersRequest": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "title": "query",
            "description": "Search by name or email"
          },
          "limit": {
            "type": "integer",
            "title": "limit",
            "format": "int32",
            "description": "Max results (default 10)"
          },
          "excludeTeamId": {
            "type": "string",
            "title": "exclude_team_id",
            "description": "Exclude users already in this team"
          }
        },
        "title": "SearchUsersRequest",
        "additionalProperties": false
      },
      "spin.v1.SearchUsersResponse": {
        "type": "object",
        "properties": {
          "users": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.User"
            },
            "title": "users"
          }
        },
        "title": "SearchUsersResponse",
        "additionalProperties": false
      },
      "spin.v1.SearchWorkspaceLogsRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "query": {
            "type": "string",
            "title": "query",
            "description": "As SearchPlatformLogsRequest's: searched inside the workspace, never beyond it."
          },
          "from": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "from"
          },
          "to": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "to"
          },
          "limit": {
            "type": "integer",
            "title": "limit",
            "format": "int32"
          },
          "offset": {
            "type": "integer",
            "title": "offset",
            "format": "int32",
            "description": "As SearchPlatformLogsRequest's."
          },
          "oldestFirst": {
            "type": "boolean",
            "title": "oldest_first",
            "description": "As SearchPlatformLogsRequest's."
          }
        },
        "title": "SearchWorkspaceLogsRequest",
        "additionalProperties": false
      },
      "spin.v1.SearchWorkspaceLogsResponse": {
        "type": "object",
        "properties": {
          "records": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.LogRecord"
            },
            "title": "records"
          },
          "total": {
            "type": "string",
            "title": "total",
            "format": "int64"
          }
        },
        "title": "SearchWorkspaceLogsResponse",
        "additionalProperties": false,
        "description": "As SearchLogsResponse, for one workspace's console."
      },
      "spin.v1.SearchWorkspaceTracesRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "query": {
            "type": "string",
            "title": "query",
            "description": "As SearchTracesRequest's, over every span: searched among the workspace's spans, never beyond\n them."
          },
          "from": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "from"
          },
          "to": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "to"
          },
          "limit": {
            "type": "integer",
            "title": "limit",
            "format": "int32"
          },
          "offset": {
            "type": "integer",
            "title": "offset",
            "format": "int32"
          }
        },
        "title": "SearchWorkspaceTracesRequest",
        "additionalProperties": false
      },
      "spin.v1.SearchWorkspaceTracesResponse": {
        "type": "object",
        "properties": {
          "spans": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.Span"
            },
            "title": "spans"
          },
          "total": {
            "type": "string",
            "title": "total",
            "format": "int64"
          }
        },
        "title": "SearchWorkspaceTracesResponse",
        "additionalProperties": false,
        "description": "The spans found, each marked as about the workspace asked for, and how many the store holds."
      },
      "spin.v1.SendTestAlertRequest": {
        "type": "object",
        "title": "SendTestAlertRequest",
        "additionalProperties": false
      },
      "spin.v1.SendTestAlertResponse": {
        "type": "object",
        "title": "SendTestAlertResponse",
        "additionalProperties": false
      },
      "spin.v1.ServiceCost": {
        "type": "object",
        "properties": {
          "service": {
            "type": "string",
            "title": "service"
          },
          "micros": {
            "type": "string",
            "title": "micros",
            "format": "int64"
          }
        },
        "title": "ServiceCost",
        "additionalProperties": false,
        "description": "What one of the cloud's services cost on one day, in millionths of the bill's currency."
      },
      "spin.v1.ServiceHealth": {
        "type": "object",
        "properties": {
          "service": {
            "type": "string",
            "title": "service"
          },
          "traces": {
            "type": "string",
            "title": "traces",
            "format": "int64"
          },
          "failedTraces": {
            "type": "string",
            "title": "failed_traces",
            "format": "int64"
          },
          "p50Millis": {
            "type": "number",
            "title": "p50_millis",
            "format": "double"
          },
          "p95Millis": {
            "type": "number",
            "title": "p95_millis",
            "format": "double"
          },
          "errorLogs": {
            "type": "string",
            "title": "error_logs",
            "format": "int64"
          },
          "intervals": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.ServiceInterval"
            },
            "title": "intervals"
          }
        },
        "title": "ServiceHealth",
        "additionalProperties": false,
        "description": "ServiceHealth is one service over a window: the traces begun in it - what it was asked to do -\n how many failed and how long they took, and how many errors it logged."
      },
      "spin.v1.ServiceHealthRequest": {
        "type": "object",
        "properties": {
          "from": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "from"
          },
          "to": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "to"
          },
          "intervals": {
            "type": "integer",
            "title": "intervals",
            "format": "int32",
            "description": "As HistogramPlatformLogsRequest's."
          }
        },
        "title": "ServiceHealthRequest",
        "additionalProperties": false
      },
      "spin.v1.ServiceHealthResponse": {
        "type": "object",
        "properties": {
          "services": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.ServiceHealth"
            },
            "title": "services"
          }
        },
        "title": "ServiceHealthResponse",
        "additionalProperties": false
      },
      "spin.v1.ServiceInterval": {
        "type": "object",
        "properties": {
          "start": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "start"
          },
          "traces": {
            "type": "string",
            "title": "traces",
            "format": "int64"
          },
          "failedTraces": {
            "type": "string",
            "title": "failed_traces",
            "format": "int64"
          }
        },
        "title": "ServiceInterval",
        "additionalProperties": false
      },
      "spin.v1.SetForgeAppRequest": {
        "type": "object",
        "properties": {
          "forge": {
            "type": "string",
            "title": "forge"
          },
          "appId": {
            "type": "string",
            "title": "app_id",
            "format": "int64"
          },
          "slug": {
            "type": "string",
            "title": "slug"
          },
          "clientId": {
            "type": "string",
            "title": "client_id"
          },
          "clientSecret": {
            "type": "string",
            "title": "client_secret"
          },
          "webhookSecret": {
            "type": "string",
            "title": "webhook_secret"
          },
          "apiUrl": {
            "type": "string",
            "title": "api_url",
            "description": "As StartAppCreationRequest's."
          },
          "webUrl": {
            "type": "string",
            "title": "web_url"
          }
        },
        "title": "SetForgeAppRequest",
        "additionalProperties": false
      },
      "spin.v1.SetForgeAppResponse": {
        "type": "object",
        "properties": {
          "app": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.ForgeApp"
              }
            ],
            "title": "app"
          }
        },
        "title": "SetForgeAppResponse",
        "additionalProperties": false
      },
      "spin.v1.SetHostPolicyRequest": {
        "type": "object",
        "properties": {
          "policy": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.HostPolicy"
              }
            ],
            "title": "policy",
            "description": "Sent whole: what is left unset is unset, so a write is the policy and not a patch."
          }
        },
        "title": "SetHostPolicyRequest",
        "additionalProperties": false
      },
      "spin.v1.SetHostPolicyResponse": {
        "type": "object",
        "properties": {
          "policy": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.HostPolicy"
              }
            ],
            "title": "policy"
          }
        },
        "title": "SetHostPolicyResponse",
        "additionalProperties": false
      },
      "spin.v1.SetPortAccessRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "port": {
            "type": "integer",
            "title": "port",
            "format": "int32"
          },
          "access": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.PortAccess"
              }
            ],
            "title": "access"
          }
        },
        "title": "SetPortAccessRequest",
        "additionalProperties": false
      },
      "spin.v1.SetPortAccessResponse": {
        "type": "object",
        "properties": {
          "exposedPort": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.ExposedPort"
              }
            ],
            "title": "exposed_port"
          }
        },
        "title": "SetPortAccessResponse",
        "additionalProperties": false
      },
      "spin.v1.SetSettingsRequest": {
        "type": "object",
        "properties": {
          "values": {
            "type": "object",
            "title": "values",
            "additionalProperties": {
              "type": "string",
              "title": "value"
            },
            "description": "The settings to write, by key, as text of each one's type. Only ADMIN settings are taken."
          }
        },
        "title": "SetSettingsRequest",
        "additionalProperties": false
      },
      "spin.v1.SetSettingsResponse": {
        "type": "object",
        "properties": {
          "values": {
            "type": "object",
            "title": "values",
            "additionalProperties": {
              "type": "string",
              "title": "value"
            },
            "description": "Every value in force once written, as GetSettings answers them."
          }
        },
        "title": "SetSettingsResponse",
        "additionalProperties": false
      },
      "spin.v1.SetSnapshotVisibilityRequest": {
        "type": "object",
        "properties": {
          "snapshotId": {
            "type": "string",
            "title": "snapshot_id"
          },
          "public": {
            "type": "boolean",
            "title": "public"
          },
          "acknowledgeFindings": {
            "type": "boolean",
            "title": "acknowledge_findings",
            "description": "As ShareSnapshotRequest's: making a snapshot public gives everybody a copy of its files."
          }
        },
        "title": "SetSnapshotVisibilityRequest",
        "additionalProperties": false
      },
      "spin.v1.SetSnapshotVisibilityResponse": {
        "type": "object",
        "properties": {
          "public": {
            "type": "boolean",
            "title": "public"
          }
        },
        "title": "SetSnapshotVisibilityResponse",
        "additionalProperties": false
      },
      "spin.v1.SetTeamNetworkPolicyRequest": {
        "type": "object",
        "properties": {
          "teamId": {
            "type": "string",
            "title": "team_id"
          },
          "name": {
            "type": "string",
            "title": "name"
          },
          "rules": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.NetworkRule"
            },
            "title": "rules"
          }
        },
        "title": "SetTeamNetworkPolicyRequest",
        "additionalProperties": false,
        "description": "SetTeamNetworkPolicyRequest makes the team's policy of that name, or replaces what it allows,\n whole. The name is one tag for the whole installation: one the installation or another team\n has is refused."
      },
      "spin.v1.SetTeamNetworkPolicyResponse": {
        "type": "object",
        "title": "SetTeamNetworkPolicyResponse",
        "additionalProperties": false
      },
      "spin.v1.SetTeamSecretRequest": {
        "type": "object",
        "properties": {
          "teamId": {
            "type": "string",
            "title": "team_id"
          },
          "name": {
            "type": "string",
            "title": "name",
            "description": "Lower-case letters, digits and dashes, starting with a letter; what a rule names it by."
          },
          "value": {
            "type": "string",
            "title": "value",
            "description": "At most 8 KiB of visible ASCII. Replaces what the name held."
          },
          "hosts": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "hosts",
            "description": "The exact names the secret may be sent to, 1 to 16: a brokered rule that injects it and\n names any other host is refused it."
          },
          "ref": {
            "type": "string",
            "title": "ref",
            "description": "In place of value: the ARN of a Secrets Manager secret or a Parameter Store parameter the team\n keeps it in, read as the team (the setting team_secrets_role) now and whenever a host\n asks for it."
          }
        },
        "title": "SetTeamSecretRequest",
        "additionalProperties": false
      },
      "spin.v1.SetTeamSecretResponse": {
        "type": "object",
        "title": "SetTeamSecretResponse",
        "additionalProperties": false
      },
      "spin.v1.SetWorkspaceBandwidthRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "bandwidthMbps": {
            "type": "integer",
            "title": "bandwidth_mbps",
            "format": "int32"
          }
        },
        "title": "SetWorkspaceBandwidthRequest",
        "additionalProperties": false,
        "description": "SetWorkspaceBandwidthRequest is the whole of what the workspace carries from now on, not a\n change to it: bandwidth_mbps in megabits a second each way, and zero is unshaped."
      },
      "spin.v1.SetWorkspaceBandwidthResponse": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "name": {
            "type": "string",
            "title": "name"
          },
          "state": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.WorkspaceState"
              }
            ],
            "title": "state"
          },
          "bandwidthMbps": {
            "type": "integer",
            "title": "bandwidth_mbps",
            "format": "int32",
            "description": "Megabits a second each way now in force; zero is unshaped."
          }
        },
        "title": "SetWorkspaceBandwidthResponse",
        "additionalProperties": false,
        "description": "SetWorkspaceBandwidthResponse is the bandwidth as recorded, which its host is then sent: a host\n that cannot take the value leaves the machine as it was and is asked again by the next set. It\n names the workspace and no more of it: the rest of its row - its env - is its owner's (I27)."
      },
      "spin.v1.SetWorkspaceNetworkTagsRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "networkTags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "network_tags"
          }
        },
        "title": "SetWorkspaceNetworkTagsRequest",
        "additionalProperties": false
      },
      "spin.v1.SetWorkspaceNetworkTagsResponse": {
        "type": "object",
        "properties": {
          "workspace": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.Workspace"
              }
            ],
            "title": "workspace"
          },
          "droppedConnections": {
            "type": "integer",
            "title": "dropped_connections",
            "format": "int32",
            "description": "dropped_connections is how many of the machine's open connections were cut, because the\n change took a policy away and what a policy no longer allows must not survive in a socket\n that was opened before it. Zero when the change only added."
          }
        },
        "title": "SetWorkspaceNetworkTagsResponse",
        "additionalProperties": false
      },
      "spin.v1.SetWorkspaceNetworkWatchRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "watch": {
            "type": "boolean",
            "title": "watch"
          }
        },
        "title": "SetWorkspaceNetworkWatchRequest",
        "additionalProperties": false,
        "description": "SetWorkspaceNetworkWatchRequest turns the watch of a workspace's network on or off. It holds\n across stops and starts until it is turned off. What is watched goes to the workspace's logs\n as the service \"network\", where the installation collects them, and is read there by whoever\n may read the workspace's logs. The workspace's own credential cannot ask, as it cannot retag."
      },
      "spin.v1.SetWorkspaceNetworkWatchResponse": {
        "type": "object",
        "properties": {
          "workspace": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.Workspace"
              }
            ],
            "title": "workspace"
          }
        },
        "title": "SetWorkspaceNetworkWatchResponse",
        "additionalProperties": false
      },
      "spin.v1.SettingDefinition": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string",
            "title": "key"
          },
          "type": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.SettingType"
              }
            ],
            "title": "type"
          },
          "defaultValue": {
            "type": "string",
            "title": "default_value",
            "description": "What is in force where the installation says nothing, as text of the type."
          },
          "min": {
            "type": [
              "string",
              "null"
            ],
            "title": "min",
            "format": "int64"
          },
          "max": {
            "type": [
              "string",
              "null"
            ],
            "title": "max",
            "format": "int64"
          },
          "choices": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "choices",
            "description": "The values a STRING setting takes; empty is any."
          },
          "reach": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.SettingReach"
              }
            ],
            "title": "reach",
            "description": "What it touches once saved."
          },
          "restart": {
            "type": "boolean",
            "title": "restart",
            "description": "It is read when the control plane starts: a change is in force after its next restart."
          },
          "section": {
            "type": "string",
            "title": "section",
            "description": "Which page it is on: general, workspaces, fleet, network, security, registration,\n telemetry, logs, bill, email, storage, installation, control_plane."
          },
          "label": {
            "type": "string",
            "title": "label",
            "description": "A few words that name it, and a sentence that says what it does and what its zero means."
          },
          "summary": {
            "type": "string",
            "title": "summary"
          },
          "writer": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.SettingWriter"
              }
            ],
            "title": "writer"
          }
        },
        "title": "SettingDefinition",
        "additionalProperties": false,
        "description": "SettingDefinition is one setting of the installation as the code defines it."
      },
      "spin.v1.SettingReach": {
        "type": "string",
        "title": "SettingReach",
        "enum": [
          "SETTING_REACH_UNSPECIFIED",
          "SETTING_REACH_RUNNING_WORKSPACES",
          "SETTING_REACH_NEW_WORKSPACES",
          "SETTING_REACH_NEXT_HEARTBEAT",
          "SETTING_REACH_NEXT_REQUEST",
          "SETTING_REACH_NEXT_PASS"
        ],
        "description": "SettingReach is what a saved installation setting touches, and when: each setting's definition\n declares one (internal/controlplane/settings), so the screen that edits it can say so before\n the save.\n\n- `SETTING_REACH_RUNNING_WORKSPACES`: The workspaces running now, at the control plane's next look at them.\n- `SETTING_REACH_NEW_WORKSPACES`: Workspaces created from now on; those that exist keep what they were made with.\n- `SETTING_REACH_NEXT_HEARTBEAT`: Each runner at its next heartbeat, and the workspaces running on it.\n- `SETTING_REACH_NEXT_REQUEST`: What is asked from now on - a project made, a shell opened, a workspace deleted; what was\n  done before keeps the terms it was done under.\n- `SETTING_REACH_NEXT_PASS`: The next pass of the job that applies it: the autoscaler, the prebuilds' retirement, the\n  collector's read of its policy, the daily look for a release.",
        "x-enum-descriptions": [
          "",
          "The workspaces running now, at the control plane's next look at them.",
          "Workspaces created from now on; those that exist keep what they were made with.",
          "Each runner at its next heartbeat, and the workspaces running on it.",
          "What is asked from now on - a project made, a shell opened, a workspace deleted; what was\n done before keeps the terms it was done under.",
          "The next pass of the job that applies it: the autoscaler, the prebuilds' retirement, the\n collector's read of its policy, the daily look for a release."
        ]
      },
      "spin.v1.SettingType": {
        "type": "string",
        "title": "SettingType",
        "enum": [
          "SETTING_TYPE_UNSPECIFIED",
          "SETTING_TYPE_INT",
          "SETTING_TYPE_BOOL",
          "SETTING_TYPE_STRING",
          "SETTING_TYPE_LIST",
          "SETTING_TYPE_JSON",
          "SETTING_TYPE_DURATION"
        ],
        "description": "SettingType is how a setting's value is written as text, which is how GetSettings answers it\n and SetSettings takes it.\n\n- `SETTING_TYPE_INT`: A whole number in decimal, within the definition's min and max.\n- `SETTING_TYPE_BOOL`: \"true\" or \"false\".\n- `SETTING_TYPE_STRING`: Text; a definition with choices takes only those.\n- `SETTING_TYPE_LIST`: A JSON array of strings.\n- `SETTING_TYPE_JSON`: A JSON document, as the code that reads it defines it.\n- `SETTING_TYPE_DURATION`: A Go duration (\"60s\"); min and max are seconds.",
        "x-enum-descriptions": [
          "",
          "A whole number in decimal, within the definition's min and max.",
          "\"true\" or \"false\".",
          "Text; a definition with choices takes only those.",
          "A JSON array of strings.",
          "A JSON document, as the code that reads it defines it.",
          "A Go duration (\"60s\"); min and max are seconds."
        ]
      },
      "spin.v1.SettingWriter": {
        "type": "string",
        "title": "SettingWriter",
        "enum": [
          "SETTING_WRITER_UNSPECIFIED",
          "SETTING_WRITER_ADMIN",
          "SETTING_WRITER_FILE",
          "SETTING_WRITER_STORE",
          "SETTING_WRITER_CONTROL_PLANE"
        ],
        "description": "SettingWriter is who writes a setting, and so where an administrator changes it.\n\n- `SETTING_WRITER_ADMIN`: SetSettings, and the installation's file seeds it.\n- `SETTING_WRITER_FILE`: The installation's file alone: what whoever made the installation knows, and a change of\n  which the dashboard cannot make whole - the proxy holds the base domain too.\n- `SETTING_WRITER_STORE`: A page of its own, which checks it against the real thing before it is written: the object\n  store, the mail server.\n- `SETTING_WRITER_CONTROL_PLANE`: The control plane, for itself.",
        "x-enum-descriptions": [
          "",
          "SetSettings, and the installation's file seeds it.",
          "The installation's file alone: what whoever made the installation knows, and a change of\n which the dashboard cannot make whole - the proxy holds the base domain too.",
          "A page of its own, which checks it against the real thing before it is written: the object\n store, the mail server.",
          "The control plane, for itself."
        ]
      },
      "spin.v1.ShareProjectRequest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          },
          "sharedWithEveryone": {
            "type": "boolean",
            "title": "shared_with_everyone"
          },
          "userIds": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "user_ids"
          },
          "teamIds": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "team_ids"
          },
          "adminIds": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "admin_ids"
          }
        },
        "title": "ShareProjectRequest",
        "additionalProperties": false,
        "description": "Who sees the project and who administers it, whole. The admins are at least one person, and\n always include the prebuild owner while the project prebuilds."
      },
      "spin.v1.ShareProjectResponse": {
        "type": "object",
        "properties": {
          "project": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.Project"
              }
            ],
            "title": "project"
          }
        },
        "title": "ShareProjectResponse",
        "additionalProperties": false
      },
      "spin.v1.ShareSnapshotRequest": {
        "type": "object",
        "properties": {
          "snapshotId": {
            "type": "string",
            "title": "snapshot_id"
          },
          "email": {
            "type": "string",
            "title": "email",
            "description": "Email of user to share with"
          },
          "acknowledgeFindings": {
            "type": "boolean",
            "title": "acknowledge_findings",
            "description": "acknowledge_findings shares a snapshot whose files hold what looks like credentials. Without\n it such a share is refused, FAILED_PRECONDITION with the SecretFindings as a detail: whoever\n it is shared with gets a copy of those files."
          }
        },
        "title": "ShareSnapshotRequest",
        "additionalProperties": false
      },
      "spin.v1.ShareSnapshotResponse": {
        "type": "object",
        "title": "ShareSnapshotResponse",
        "additionalProperties": false,
        "description": "Empty whether or not the address has an account: anything else would say which."
      },
      "spin.v1.Snapshot": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          },
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "description": {
            "type": "string",
            "title": "description",
            "description": "User-provided description"
          },
          "createdAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "created_at"
          },
          "isPublic": {
            "type": "boolean",
            "title": "is_public",
            "description": "Whether snapshot is publicly visible"
          },
          "shareCount": {
            "type": "integer",
            "title": "share_count",
            "format": "int32",
            "description": "Number of users snapshot is shared with"
          },
          "accessType": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.SnapshotAccessType"
              }
            ],
            "title": "access_type",
            "description": "How user has access"
          },
          "state": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.SnapshotState"
              }
            ],
            "title": "state"
          },
          "withMemory": {
            "type": "boolean",
            "title": "with_memory",
            "description": "with_memory: the snapshot also kept the running machine's memory, so restoring it resumes\n the processes where they were instead of booting the disk. The memory is on the host the\n workspace ran on."
          },
          "parentSnapshotId": {
            "type": "string",
            "title": "parent_snapshot_id",
            "description": "The snapshot the disk this one was taken of had been cloned from. A restore gives the\n workspace a new disk cloned from the snapshot restored, so the snapshots with one parent are\n one disk's, and one whose parent is not ListSnapshotsResponse.base_snapshot_id was taken on a\n disk a restore left detached. Empty for a disk that was not cloned."
          }
        },
        "title": "Snapshot",
        "additionalProperties": false,
        "description": "A snapshot is a rotation of a workspace's volume, published as a commit. It has no name\n outside its id."
      },
      "spin.v1.SnapshotAccessType": {
        "type": "string",
        "title": "SnapshotAccessType",
        "enum": [
          "SNAPSHOT_ACCESS_TYPE_UNSPECIFIED",
          "SNAPSHOT_ACCESS_TYPE_OWNER",
          "SNAPSHOT_ACCESS_TYPE_SHARED",
          "SNAPSHOT_ACCESS_TYPE_PUBLIC"
        ],
        "description": "Access type for snapshots\n\n- `SNAPSHOT_ACCESS_TYPE_OWNER`: Owner of the source workspace\n- `SNAPSHOT_ACCESS_TYPE_SHARED`: Explicitly shared with user\n- `SNAPSHOT_ACCESS_TYPE_PUBLIC`: Public snapshot",
        "x-enum-descriptions": [
          "",
          "Owner of the source workspace",
          "Explicitly shared with user",
          "Public snapshot"
        ]
      },
      "spin.v1.SnapshotShare": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          },
          "snapshotId": {
            "type": "string",
            "title": "snapshot_id"
          },
          "userId": {
            "type": "string",
            "title": "user_id"
          },
          "userEmail": {
            "type": "string",
            "title": "user_email"
          },
          "userName": {
            "type": "string",
            "title": "user_name"
          },
          "grantedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "granted_at"
          },
          "grantedBy": {
            "type": "string",
            "title": "granted_by"
          }
        },
        "title": "SnapshotShare",
        "additionalProperties": false,
        "description": "A share record for a snapshot"
      },
      "spin.v1.SnapshotState": {
        "type": "string",
        "title": "SnapshotState",
        "enum": [
          "SNAPSHOT_STATE_UNSPECIFIED",
          "SNAPSHOT_STATE_CREATING",
          "SNAPSHOT_STATE_PUBLISHED",
          "SNAPSHOT_STATE_FAILED",
          "SNAPSHOT_STATE_DELETING"
        ],
        "description": "How far along a snapshot is. A snapshot is taken by the host serving the volume, so it\n exists before it is usable: CREATING is the window between asking for one and the host\n reporting the commit it published.\n\n- `SNAPSHOT_STATE_CREATING`: Requested; the host has not published a commit yet\n- `SNAPSHOT_STATE_PUBLISHED`: Usable: a workspace can be created from it",
        "x-enum-descriptions": [
          "",
          "Requested; the host has not published a commit yet",
          "Usable: a workspace can be created from it",
          "",
          ""
        ]
      },
      "spin.v1.Span": {
        "type": "object",
        "properties": {
          "traceId": {
            "type": "string",
            "title": "trace_id"
          },
          "spanId": {
            "type": "string",
            "title": "span_id"
          },
          "parentSpanId": {
            "type": "string",
            "title": "parent_span_id",
            "description": "Empty for the trace's first span."
          },
          "service": {
            "type": "string",
            "title": "service"
          },
          "name": {
            "type": "string",
            "title": "name"
          },
          "start": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "start"
          },
          "durationMicros": {
            "type": "string",
            "title": "duration_micros",
            "format": "int64",
            "description": "How long it took, in microseconds."
          },
          "failed": {
            "type": "boolean",
            "title": "failed",
            "description": "Whether it ended in an error, and what it said."
          },
          "statusMessage": {
            "type": "string",
            "title": "status_message"
          },
          "attributes": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Struct"
              }
            ],
            "title": "attributes"
          },
          "events": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/google.protobuf.Struct"
            },
            "title": "events",
            "description": "What happened during it, as the span recorded it: each event's name, time and attributes."
          }
        },
        "title": "Span",
        "additionalProperties": false,
        "description": "Span is one operation of a trace, as OpenTelemetry names its parts."
      },
      "spin.v1.StandbyCost": {
        "type": "object",
        "properties": {
          "day": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "day",
            "description": "The billed day it is from: its first instant, UTC."
          },
          "platform": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.RoleCost"
            },
            "title": "platform",
            "description": "The platform by role, costliest first."
          },
          "idleMicros": {
            "type": "string",
            "title": "idle_micros",
            "format": "int64"
          },
          "unstoredMicros": {
            "type": "string",
            "title": "unstored_micros",
            "format": "int64"
          }
        },
        "title": "StandbyCost",
        "additionalProperties": false,
        "description": "What the installation cost on its last billed day before the reading with nobody's work\n counted: the platform, the runners' capacity no workspace held, and the bucket's bytes no\n workspace keeps. An estimate of a day nobody works: that day is over, the next may be charged\n otherwise, and a day people worked held some of the runners - so it is never said without its\n day (finops.StandbyOf)."
      },
      "spin.v1.StartAppCreationRequest": {
        "type": "object",
        "properties": {
          "forge": {
            "type": "string",
            "title": "forge"
          },
          "organization": {
            "type": "string",
            "title": "organization",
            "description": "The organization the app belongs to; empty is the admin's own account."
          },
          "apiUrl": {
            "type": "string",
            "title": "api_url",
            "description": "Empty is github.com's; a GitHub Enterprise Server's API is https://\u003chost\u003e/api/v3, and its web\n origin https://\u003chost\u003e."
          },
          "webUrl": {
            "type": "string",
            "title": "web_url"
          },
          "public": {
            "type": "boolean",
            "title": "public",
            "description": "Whether any account can install it. A private app installs only on the account that owns it,\n so only that account's repositories are reached."
          }
        },
        "title": "StartAppCreationRequest",
        "additionalProperties": false
      },
      "spin.v1.StartAppCreationResponse": {
        "type": "object",
        "properties": {
          "formUrl": {
            "type": "string",
            "title": "form_url",
            "description": "Where to send the browser: a page of this control plane's that posts the manifest to the forge,\n because the dashboard's own policy lets it post nowhere else."
          },
          "state": {
            "type": "string",
            "title": "state"
          },
          "binding": {
            "type": "string",
            "title": "binding",
            "description": "A secret for the client that began this, kept where only it reads it and never in a URL:\n CompleteAppCreation requires it with the state."
          }
        },
        "title": "StartAppCreationResponse",
        "additionalProperties": false
      },
      "spin.v1.StartConnectRequest": {
        "type": "object",
        "properties": {
          "forge": {
            "type": "string",
            "title": "forge"
          },
          "redirectUri": {
            "type": "string",
            "title": "redirect_uri",
            "description": "The dashboard's /git/callback, over https; anything else is refused. Empty is the\n installation's own."
          }
        },
        "title": "StartConnectRequest",
        "additionalProperties": false
      },
      "spin.v1.StartConnectResponse": {
        "type": "object",
        "properties": {
          "authorizeUrl": {
            "type": "string",
            "title": "authorize_url"
          },
          "state": {
            "type": "string",
            "title": "state"
          },
          "binding": {
            "type": "string",
            "title": "binding",
            "description": "A secret for the client that began this, kept where only it reads it and never in a URL:\n CompleteConnect requires it with the state."
          }
        },
        "title": "StartConnectResponse",
        "additionalProperties": false
      },
      "spin.v1.StartDeviceConnectRequest": {
        "type": "object",
        "properties": {
          "forge": {
            "type": "string",
            "title": "forge"
          }
        },
        "title": "StartDeviceConnectRequest",
        "additionalProperties": false
      },
      "spin.v1.StartDeviceConnectResponse": {
        "type": "object",
        "properties": {
          "handle": {
            "type": "string",
            "title": "handle",
            "description": "What PollDeviceConnect is asked with: a secret of the caller's, polled by them alone. The\n forge's device code stays on the control plane."
          },
          "userCode": {
            "type": "string",
            "title": "user_code",
            "description": "What the person types at verification_uri, signed in to the forge."
          },
          "verificationUri": {
            "type": "string",
            "title": "verification_uri"
          },
          "expiresAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "expires_at"
          },
          "intervalSeconds": {
            "type": "integer",
            "title": "interval_seconds",
            "format": "int32",
            "description": "How long to wait before each poll."
          }
        },
        "title": "StartDeviceConnectResponse",
        "additionalProperties": false
      },
      "spin.v1.StartDeviceLoginRequest": {
        "type": "object",
        "properties": {
          "identityProviderId": {
            "type": "string",
            "title": "identity_provider_id",
            "description": "Optional: use default if empty"
          }
        },
        "title": "StartDeviceLoginRequest",
        "additionalProperties": false
      },
      "spin.v1.StartDeviceLoginResponse": {
        "type": "object",
        "properties": {
          "deviceCode": {
            "type": "string",
            "title": "device_code",
            "description": "Secret code for CLI to poll with"
          },
          "userCode": {
            "type": "string",
            "title": "user_code",
            "description": "Short code user enters (e.g., \"ABCD-1234\")"
          },
          "verificationUrl": {
            "type": "string",
            "title": "verification_url",
            "description": "URL user visits to login"
          },
          "expiresIn": {
            "type": "integer",
            "title": "expires_in",
            "format": "int32",
            "description": "Seconds until codes expire"
          },
          "interval": {
            "type": "integer",
            "title": "interval",
            "format": "int32",
            "description": "Seconds between poll attempts"
          }
        },
        "title": "StartDeviceLoginResponse",
        "additionalProperties": false
      },
      "spin.v1.StartLoginRequest": {
        "type": "object",
        "properties": {
          "identityProviderId": {
            "type": "string",
            "title": "identity_provider_id",
            "description": "ID of the identity provider to use"
          },
          "redirectUri": {
            "type": "string",
            "title": "redirect_uri",
            "description": "Where the identity provider sends the code: the dashboard's /auth/callback, over https.\n Anything else is refused."
          }
        },
        "title": "StartLoginRequest",
        "additionalProperties": false
      },
      "spin.v1.StartLoginResponse": {
        "type": "object",
        "properties": {
          "authUrl": {
            "type": "string",
            "title": "auth_url",
            "description": "URL to redirect user to"
          },
          "state": {
            "type": "string",
            "title": "state",
            "description": "CSRF state token"
          },
          "binding": {
            "type": "string",
            "title": "binding",
            "description": "A secret for the client that began this sign-in, and for nobody else: CompleteLogin\n requires it with the state. The state and the code come back in a URL, which somebody\n who signed in to their own account can send to anybody - and without this, whoever\n opens it is signed in as them. Kept where only this client reads it, never in a URL."
          }
        },
        "title": "StartLoginResponse",
        "additionalProperties": false
      },
      "spin.v1.StartWorkspaceRequest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          },
          "fromDisk": {
            "type": "boolean",
            "title": "from_disk",
            "description": "Boot a suspended workspace from its disk, dropping the memory it was suspended with: what is\n left when that memory was taken on a machine no host runs now (WORKSPACE_FAILURE_MACHINE_CHANGED).\n The guest boots as from a power cut. Refused for a workspace that is not suspended."
          }
        },
        "title": "StartWorkspaceRequest",
        "additionalProperties": false
      },
      "spin.v1.StartWorkspaceResponse": {
        "type": "object",
        "properties": {
          "workspace": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.Workspace"
              }
            ],
            "title": "workspace"
          }
        },
        "title": "StartWorkspaceResponse",
        "additionalProperties": false
      },
      "spin.v1.StatusDisagreement": {
        "type": "object",
        "properties": {
          "kind": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.StatusDisagreementKind"
              }
            ],
            "title": "kind"
          },
          "detail": {
            "type": "string",
            "title": "detail",
            "description": "One sentence naming both sides and the gap between them, for a person to read. The kind\n is what a script branches on."
          }
        },
        "title": "StatusDisagreement",
        "additionalProperties": false
      },
      "spin.v1.StatusDisagreementKind": {
        "type": "string",
        "title": "StatusDisagreementKind",
        "enum": [
          "STATUS_DISAGREEMENT_KIND_UNSPECIFIED",
          "STATUS_DISAGREEMENT_KIND_SUPERVISOR_STALE",
          "STATUS_DISAGREEMENT_KIND_SUPERVISOR_ABSENT",
          "STATUS_DISAGREEMENT_KIND_HOST_UNREACHABLE",
          "STATUS_DISAGREEMENT_KIND_VOLUME_REFUSING",
          "STATUS_DISAGREEMENT_KIND_UNHEALTHY"
        ],
        "description": "- `STATUS_DISAGREEMENT_KIND_SUPERVISOR_STALE`: The control plane says the workspace runs and the supervisor has gone quiet for longer\n  than several heartbeat intervals.\n- `STATUS_DISAGREEMENT_KIND_SUPERVISOR_ABSENT`: The control plane says the workspace runs and no supervisor ever reported.\n- `STATUS_DISAGREEMENT_KIND_HOST_UNREACHABLE`: The host holding this workspace is not ACTIVE, or has stopped heartbeating.\n- `STATUS_DISAGREEMENT_KIND_VOLUME_REFUSING`: The volume under the workspace is refusing to serve.\n- `STATUS_DISAGREEMENT_KIND_UNHEALTHY`: The supervisor reports a failing health check.",
        "x-enum-descriptions": [
          "",
          "The control plane says the workspace runs and the supervisor has gone quiet for longer\n than several heartbeat intervals.",
          "The control plane says the workspace runs and no supervisor ever reported.",
          "The host holding this workspace is not ACTIVE, or has stopped heartbeating.",
          "The volume under the workspace is refusing to serve.",
          "The supervisor reports a failing health check."
        ]
      },
      "spin.v1.StopUserWorkspaceRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id",
            "description": "The workspace's id: an administrator names no workspace of somebody else's by its name."
          },
          "force": {
            "type": "boolean",
            "title": "force",
            "description": "Give up what only its host has rather than publish it first, as StopWorkspace's force does."
          },
          "reason": {
            "type": "string",
            "title": "reason",
            "description": "Why, kept on the audit entry."
          }
        },
        "title": "StopUserWorkspaceRequest",
        "additionalProperties": false
      },
      "spin.v1.StopUserWorkspaceResponse": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "name": {
            "type": "string",
            "title": "name"
          },
          "state": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.WorkspaceState"
              }
            ],
            "title": "state"
          }
        },
        "title": "StopUserWorkspaceResponse",
        "additionalProperties": false,
        "description": "The workspace as the stop left it, and no more of it: the rest of its row is its owner's."
      },
      "spin.v1.StopWorkspaceRequest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          },
          "force": {
            "type": "boolean",
            "title": "force",
            "description": "Force kill instead of graceful"
          }
        },
        "title": "StopWorkspaceRequest",
        "additionalProperties": false
      },
      "spin.v1.StopWorkspaceResponse": {
        "type": "object",
        "properties": {
          "workspace": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.Workspace"
              }
            ],
            "title": "workspace"
          }
        },
        "title": "StopWorkspaceResponse",
        "additionalProperties": false
      },
      "spin.v1.StorageSettings": {
        "type": "object",
        "properties": {
          "bucket": {
            "type": "string",
            "title": "bucket"
          },
          "endpoint": {
            "type": "string",
            "title": "endpoint",
            "description": "Empty is the store's own service for its region."
          },
          "region": {
            "type": "string",
            "title": "region"
          },
          "accessKeyId": {
            "type": "string",
            "title": "access_key_id",
            "description": "The control plane's own credential; empty is the machine's own."
          },
          "secretSet": {
            "type": "boolean",
            "title": "secret_set",
            "description": "Whether the access key's secret is set: the secret itself is never read back."
          },
          "dir": {
            "type": "string",
            "title": "dir"
          },
          "principal": {
            "type": "string",
            "title": "principal",
            "description": "Who the control plane issues each runner's credential to the store as, as the store names it\n (for an S3 store, the role it assumes)."
          }
        },
        "title": "StorageSettings",
        "additionalProperties": false,
        "description": "StorageSettings is where the object store is: a bucket, or on one machine a directory."
      },
      "spin.v1.StorageTally": {
        "type": "object",
        "properties": {
          "objects": {
            "type": "string",
            "title": "objects",
            "format": "int64"
          },
          "bytes": {
            "type": "string",
            "title": "bytes",
            "format": "int64"
          }
        },
        "title": "StorageTally",
        "additionalProperties": false
      },
      "spin.v1.StoredVolume": {
        "type": "object",
        "properties": {
          "volumeId": {
            "type": "string",
            "title": "volume_id"
          },
          "kind": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.StoredVolumeKind"
              }
            ],
            "title": "kind"
          },
          "name": {
            "type": "string",
            "title": "name",
            "description": "The workspace's name, the prebuild's project, ref and commit, the image's ref, or the\n extension and its version."
          },
          "workspaceId": {
            "type": "string",
            "title": "workspace_id",
            "description": "The workspace's, for a workspace's disk and a prebuild."
          },
          "ownerEmail": {
            "type": "string",
            "title": "owner_email",
            "description": "The workspace's owner, or the person whose agent's home it is."
          },
          "current": {
            "type": "boolean",
            "title": "current",
            "description": "Whether it is the workspace's disk now, rather than one it had."
          },
          "own": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.StorageTally"
              }
            ],
            "title": "own",
            "description": "The descriptor, HEAD, the epoch and the commit manifests."
          },
          "layers": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.StorageTally"
              }
            ],
            "title": "layers"
          },
          "checkpoints": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.StorageTally"
              }
            ],
            "title": "checkpoints",
            "description": "Its checkpoints' memory and records."
          },
          "removable": {
            "type": "boolean",
            "title": "removable",
            "description": "Whether RemoveStoredVolume would take it: an image no ref names and nothing was cloned from,\n an extension release nothing runs, an unclaimed volume or an orphan."
          },
          "untaggable": {
            "type": "boolean",
            "title": "untaggable",
            "description": "An image its ref still names, which UntagImage takes the ref off."
          },
          "keptBecause": {
            "type": "string",
            "title": "kept_because",
            "description": "Why it stays, in words, where it is an image, a release or an agent's home that may not go."
          },
          "label": {
            "type": "string",
            "title": "label",
            "description": "What it is and whose, in one line a person reads: \"the prebuild of web main@1a2b3c4,\n ready\", \"ana@example.com's agent's home, mounted by neat-crow\"."
          },
          "fromDescriptor": {
            "type": "boolean",
            "title": "from_descriptor",
            "description": "The database names nothing of it, and kind is what its descriptor.json said it was made as\n when the control plane made it: a volume whose rows were lost, or a database restored from\n behind the store. Removable as an orphan or an unclaimed volume is."
          }
        },
        "title": "StoredVolume",
        "additionalProperties": false,
        "description": "StoredVolume is one volume in the store: what is under volumes/\u003cvolume_id\u003e/, and the layers\n its commits name under layers/."
      },
      "spin.v1.StoredVolumeKind": {
        "type": "string",
        "title": "StoredVolumeKind",
        "enum": [
          "STORED_VOLUME_KIND_UNSPECIFIED",
          "STORED_VOLUME_KIND_WORKSPACE",
          "STORED_VOLUME_KIND_IMAGE",
          "STORED_VOLUME_KIND_EXTENSION",
          "STORED_VOLUME_KIND_UNCLAIMED",
          "STORED_VOLUME_KIND_ORPHAN",
          "STORED_VOLUME_KIND_PREBUILD",
          "STORED_VOLUME_KIND_AGENT_HOME"
        ],
        "description": "- `STORED_VOLUME_KIND_WORKSPACE`: A workspace's disk, now or before.\n- `STORED_VOLUME_KIND_IMAGE`: An image a workspace's disk is cloned from.\n- `STORED_VOLUME_KIND_EXTENSION`: A release of an extension: the supervisor, the VS Code servers.\n- `STORED_VOLUME_KIND_UNCLAIMED`: A volume the database has and nothing names: a clone being made, or a delete not finished.\n- `STORED_VOLUME_KIND_ORPHAN`: Objects under a volume the database does not have.\n- `STORED_VOLUME_KIND_PREBUILD`: A prebuild: the disk of the workspace that built it, which the workspaces opened from it are\n  cloned from.\n- `STORED_VOLUME_KIND_AGENT_HOME`: A person's agent's home, which outlives the workspaces that mount it.",
        "x-enum-descriptions": [
          "",
          "A workspace's disk, now or before.",
          "An image a workspace's disk is cloned from.",
          "A release of an extension: the supervisor, the VS Code servers.",
          "A volume the database has and nothing names: a clone being made, or a delete not finished.",
          "Objects under a volume the database does not have.",
          "A prebuild: the disk of the workspace that built it, which the workspaces opened from it are\n cloned from.",
          "A person's agent's home, which outlives the workspaces that mount it."
        ]
      },
      "spin.v1.SupervisorState": {
        "type": "string",
        "title": "SupervisorState",
        "enum": [
          "SUPERVISOR_STATE_UNSPECIFIED",
          "SUPERVISOR_STATE_INITIALIZING",
          "SUPERVISOR_STATE_READY",
          "SUPERVISOR_STATE_RUNNING_HOOK",
          "SUPERVISOR_STATE_ERROR",
          "SUPERVISOR_STATE_DISCONNECTED"
        ],
        "description": "SupervisorState is what the supervisor inside a VM is doing. Here rather than beside the\n stream that carries it, because it is read from both sides: the supervisor reports it on\n its own connection (spin.agent.v1) and an operator asks for it through\n WorkspaceService.GetWorkspaceStatus. A vocabulary with two definitions is two\n vocabularies."
      },
      "spin.v1.SupervisorStatus": {
        "type": "object",
        "properties": {
          "state": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.SupervisorState"
              }
            ],
            "title": "state"
          },
          "version": {
            "type": "string",
            "title": "version"
          },
          "lastHeartbeat": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "last_heartbeat"
          },
          "connected": {
            "type": "boolean",
            "title": "connected",
            "description": "Whether a control plane holds this supervisor's stream right now. It is read from the\n durable row and not from the local connection table on purpose: a request may be served\n by a control plane other than the one the supervisor is attached to, and that one knows\n nothing about it."
          },
          "health": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.HealthReport"
              }
            ],
            "title": "health"
          }
        },
        "title": "SupervisorStatus",
        "additionalProperties": false,
        "description": "What the supervisor inside the guest last reported. Absent (`connected` false with a zero\n last_heartbeat) means no supervisor of this workspace has ever reached a control plane."
      },
      "spin.v1.SuspendWorkspaceRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          }
        },
        "title": "SuspendWorkspaceRequest",
        "additionalProperties": false
      },
      "spin.v1.SuspendWorkspaceResponse": {
        "type": "object",
        "properties": {
          "workspace": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.Workspace"
              }
            ],
            "title": "workspace"
          },
          "snapshotId": {
            "type": "string",
            "title": "snapshot_id",
            "description": "snapshot_id is the checkpoint the next start resumes, and a snapshot like any other: it is\n listed, it can be restored by name, and deleting it is what makes the workspace start from\n its disk instead."
          }
        },
        "title": "SuspendWorkspaceResponse",
        "additionalProperties": false
      },
      "spin.v1.Team": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          },
          "parentId": {
            "type": "string",
            "title": "parent_id",
            "description": "Empty if root team"
          },
          "name": {
            "type": "string",
            "title": "name"
          },
          "slug": {
            "type": "string",
            "title": "slug"
          },
          "path": {
            "type": "string",
            "title": "path",
            "description": "Materialized path: \"/engineering/backend\""
          },
          "depth": {
            "type": "integer",
            "title": "depth",
            "format": "int32",
            "description": "1, 2, or 3"
          },
          "description": {
            "type": "string",
            "title": "description"
          },
          "memberCount": {
            "type": "integer",
            "title": "member_count",
            "format": "int32",
            "description": "Direct members only"
          },
          "workspaceCount": {
            "type": "integer",
            "title": "workspace_count",
            "format": "int32",
            "description": "Direct workspaces only"
          },
          "createdAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "created_at"
          },
          "updatedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "updated_at"
          },
          "displayName": {
            "type": "string",
            "title": "display_name",
            "description": "Human-friendly name (falls back to name if empty)"
          },
          "isPersonal": {
            "type": "boolean",
            "title": "is_personal",
            "description": "Personal team for a single user (cannot be deleted or left by owner)"
          }
        },
        "title": "Team",
        "additionalProperties": false
      },
      "spin.v1.TeamIdentityProvider": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          },
          "name": {
            "type": "string",
            "title": "name"
          },
          "providerType": {
            "type": "string",
            "title": "provider_type",
            "description": "oidc, github, google, azure-ad"
          },
          "issuerUrl": {
            "type": "string",
            "title": "issuer_url"
          },
          "autoJoinCelExpression": {
            "type": "string",
            "title": "auto_join_cel_expression",
            "description": "CEL expression for auto-membership"
          },
          "roleCelExpression": {
            "type": "string",
            "title": "role_cel_expression",
            "description": "CEL expression for role assignment"
          },
          "enabled": {
            "type": "boolean",
            "title": "enabled"
          },
          "createdAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "created_at"
          },
          "refusedRemoval": {
            "type": "string",
            "title": "refused_removal",
            "description": "Why disabling or deleting it would be refused; empty where it would not be. An installation\n provider that the only administrators who can sign in sign in through (lockout)."
          }
        },
        "title": "TeamIdentityProvider",
        "additionalProperties": false
      },
      "spin.v1.TeamMember": {
        "type": "object",
        "properties": {
          "userId": {
            "type": "string",
            "title": "user_id"
          },
          "email": {
            "type": "string",
            "title": "email"
          },
          "name": {
            "type": "string",
            "title": "name"
          },
          "role": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.TeamRole"
              }
            ],
            "title": "role"
          },
          "joinedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "joined_at"
          }
        },
        "title": "TeamMember",
        "additionalProperties": false
      },
      "spin.v1.TeamRole": {
        "type": "string",
        "title": "TeamRole",
        "enum": [
          "TEAM_ROLE_UNSPECIFIED",
          "TEAM_ROLE_OWNER",
          "TEAM_ROLE_ADMIN",
          "TEAM_ROLE_MEMBER"
        ],
        "description": "Team member role enum\n\n- `TEAM_ROLE_OWNER`: Full control, can delete team\n- `TEAM_ROLE_ADMIN`: Can manage members and settings\n- `TEAM_ROLE_MEMBER`: Can create workspaces, view team resources",
        "x-enum-descriptions": [
          "",
          "Full control, can delete team",
          "Can manage members and settings",
          "Can create workspaces, view team resources"
        ]
      },
      "spin.v1.TeamSecret": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "title": "name"
          },
          "updatedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "updated_at"
          },
          "hosts": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "hosts"
          },
          "ref": {
            "type": "string",
            "title": "ref",
            "description": "Where the team keeps the value; empty where the control plane does."
          }
        },
        "title": "TeamSecret",
        "additionalProperties": false
      },
      "spin.v1.TeamWorkspaceCost": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "name": {
            "type": "string",
            "title": "name"
          },
          "share": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.CostShare"
              }
            ],
            "title": "share"
          }
        },
        "title": "TeamWorkspaceCost",
        "additionalProperties": false,
        "description": "What one of a team's workspaces cost in the month."
      },
      "spin.v1.TelemetryFlow": {
        "type": "object",
        "properties": {
          "sent": {
            "type": "string",
            "title": "sent",
            "format": "int64"
          },
          "failed": {
            "type": "string",
            "title": "failed",
            "format": "int64"
          }
        },
        "title": "TelemetryFlow",
        "additionalProperties": false,
        "description": "TelemetryFlow is what one exporter of the collector did over the last window."
      },
      "spin.v1.TestHostWritebackRequest": {
        "type": "object",
        "properties": {
          "hostId": {
            "type": "string",
            "title": "host_id"
          },
          "limitBytes": {
            "type": "string",
            "title": "limit_bytes",
            "format": "int64",
            "description": "The candidates, as HostPolicy holds them."
          },
          "backgroundBytes": {
            "type": "string",
            "title": "background_bytes",
            "format": "int64"
          }
        },
        "title": "TestHostWritebackRequest",
        "additionalProperties": false
      },
      "spin.v1.TestHostWritebackResponse": {
        "type": "object",
        "properties": {
          "test": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.WritebackTest"
              }
            ],
            "title": "test"
          }
        },
        "title": "TestHostWritebackResponse",
        "additionalProperties": false
      },
      "spin.v1.ThirdPartyAcceptance": {
        "type": "object",
        "properties": {
          "termsVersion": {
            "type": "string",
            "title": "terms_version",
            "description": "The version of the text that was accepted; an older one than the response's counts as none."
          },
          "acceptedBy": {
            "type": "string",
            "title": "accepted_by",
            "description": "Who accepted, by email: kept as it was when they did."
          },
          "acceptedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "accepted_at"
          }
        },
        "title": "ThirdPartyAcceptance",
        "additionalProperties": false,
        "description": "ThirdPartyAcceptance is an administrator's acceptance of an item's terms."
      },
      "spin.v1.ThirdPartyItem": {
        "type": "string",
        "title": "ThirdPartyItem",
        "enum": [
          "THIRD_PARTY_ITEM_UNSPECIFIED",
          "THIRD_PARTY_ITEM_VSCODE_SERVER",
          "THIRD_PARTY_ITEM_AGENT_CLIS"
        ],
        "description": "ThirdPartyItem is what an administrator accepts the terms of, one download at a time: the\n software the control plane fetches together, as one extension.\n\n- `THIRD_PARTY_ITEM_VSCODE_SERVER`: Microsoft's VS Code server and its CLI: the vsc-\u003ccommit\u003e extensions.\n- `THIRD_PARTY_ITEM_AGENT_CLIS`: Claude Code, Codex, T3 Code and the libatomic T3 Code's server is linked against: the agents\n  extension.",
        "x-enum-descriptions": [
          "",
          "Microsoft's VS Code server and its CLI: the vsc-\u003ccommit\u003e extensions.",
          "Claude Code, Codex, T3 Code and the libatomic T3 Code's server is linked against: the agents\n extension."
        ]
      },
      "spin.v1.ThirdPartyPart": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "title": "name"
          },
          "maker": {
            "type": "string",
            "title": "maker",
            "description": "Who makes it and serves the download."
          },
          "license": {
            "type": "string",
            "title": "license"
          },
          "licenseUrl": {
            "type": "string",
            "title": "license_url"
          }
        },
        "title": "ThirdPartyPart",
        "additionalProperties": false,
        "description": "ThirdPartyPart is one program an item downloads, and the license it comes under."
      },
      "spin.v1.ThirdPartyTermsItem": {
        "type": "object",
        "properties": {
          "item": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.ThirdPartyItem"
              }
            ],
            "title": "item"
          },
          "name": {
            "type": "string",
            "title": "name"
          },
          "purpose": {
            "type": "string",
            "title": "purpose",
            "description": "What a workspace gets from it."
          },
          "parts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.ThirdPartyPart"
            },
            "title": "parts"
          },
          "acceptance": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.ThirdPartyAcceptance"
              }
            ],
            "title": "acceptance",
            "description": "Unset where nobody accepted the terms for it."
          },
          "accepted": {
            "type": "boolean",
            "title": "accepted",
            "description": "Whether this installation downloads it: accepted, as the current text."
          }
        },
        "title": "ThirdPartyTermsItem",
        "additionalProperties": false
      },
      "spin.v1.TimelineActor": {
        "type": "string",
        "title": "TimelineActor",
        "enum": [
          "TIMELINE_ACTOR_UNSPECIFIED",
          "TIMELINE_ACTOR_PERSON",
          "TIMELINE_ACTOR_CONTROL_PLANE",
          "TIMELINE_ACTOR_HOST"
        ],
        "description": "TimelineActor is who or what did what a TimelineEvent says.\n\n- `TIMELINE_ACTOR_PERSON`: A person signed in, named by actor_id.\n- `TIMELINE_ACTOR_CONTROL_PLANE`: The control plane, on its own: a reconciliation, a sweep, a job, a decision nobody asked for.\n- `TIMELINE_ACTOR_HOST`: A host, of itself: it joined, said it was going, lost its stream or came back.",
        "x-enum-descriptions": [
          "",
          "A person signed in, named by actor_id.",
          "The control plane, on its own: a reconciliation, a sweep, a job, a decision nobody asked for.",
          "A host, of itself: it joined, said it was going, lost its stream or came back."
        ]
      },
      "spin.v1.TimelineEvent": {
        "type": "object",
        "properties": {
          "source": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.TimelineSource"
              }
            ],
            "title": "source",
            "description": "The record it is read from, and that record's id there: the evidence a reader opens."
          },
          "id": {
            "type": "string",
            "title": "id"
          },
          "at": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "at"
          },
          "actor": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.TimelineActor"
              }
            ],
            "title": "actor",
            "description": "Who or what did it."
          },
          "actorId": {
            "type": "string",
            "title": "actor_id",
            "description": "The person, when actor is PERSON: empty for one whose account has since been deleted, and\n the email is what their row says now."
          },
          "actorEmail": {
            "type": "string",
            "title": "actor_email"
          },
          "what": {
            "type": "string",
            "title": "what",
            "description": "What happened, in its source's own words: an audit action (host_state_changed), a workspace\n event type without its prefix (FAILED), a failed job run's job (storage-gc), or for a\n prebuild prebuild_started, prebuild_built or prebuild_failed."
          },
          "resourceType": {
            "type": "string",
            "title": "resource_type",
            "description": "What it happened to: an audit entry's resource_type and id (workspace, host, settings, job by\n its name), the workspace of a workspace event, the job of a run, the project of a prebuild."
          },
          "resourceId": {
            "type": "string",
            "title": "resource_id"
          },
          "resourceName": {
            "type": "string",
            "title": "resource_name",
            "description": "The name a person knows it by, where the installation still has its row: a workspace's, a\n host's machine's, a team's, a project's. Empty otherwise."
          },
          "details": {
            "type": "string",
            "title": "details",
            "description": "The JSON the record keeps, verbatim: an audit entry's details, a workspace event's, a failed\n run's counts and error, a prebuild's ref, commit and error."
          },
          "traceId": {
            "type": "string",
            "title": "trace_id",
            "description": "The trace of the request or the run that did it; empty when none was sampled. Whether the\n store kept it is LogService.KeptTraces's to say."
          }
        },
        "title": "TimelineEvent",
        "additionalProperties": false,
        "description": "TimelineEvent is one thing that happened, read from the record that keeps it - the audit log, a\n workspace's events, a job's runs, a project's prebuilds - and never a copy of it."
      },
      "spin.v1.TimelineSource": {
        "type": "string",
        "title": "TimelineSource",
        "enum": [
          "TIMELINE_SOURCE_UNSPECIFIED",
          "TIMELINE_SOURCE_AUDIT",
          "TIMELINE_SOURCE_WORKSPACE_EVENT",
          "TIMELINE_SOURCE_JOB_RUN",
          "TIMELINE_SOURCE_PREBUILD"
        ],
        "description": "TimelineSource is the record a TimelineEvent is read from.\n\n- `TIMELINE_SOURCE_AUDIT`: An audit entry (AuditEntry.id).\n- `TIMELINE_SOURCE_WORKSPACE_EVENT`: A workspace's event (WorkspaceEvent.id).\n- `TIMELINE_SOURCE_JOB_RUN`: A job's run that failed (JobRun.run_id).\n- `TIMELINE_SOURCE_PREBUILD`: A project's prebuild (Prebuild.id).",
        "x-enum-descriptions": [
          "",
          "An audit entry (AuditEntry.id).",
          "A workspace's event (WorkspaceEvent.id).",
          "A job's run that failed (JobRun.run_id).",
          "A project's prebuild (Prebuild.id)."
        ]
      },
      "spin.v1.UndeleteWorkspaceRequest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id",
            "description": "The workspace's id: a name is not unique among the ones in the trash."
          }
        },
        "title": "UndeleteWorkspaceRequest",
        "additionalProperties": false
      },
      "spin.v1.UndeleteWorkspaceResponse": {
        "type": "object",
        "properties": {
          "workspace": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.Workspace"
              }
            ],
            "title": "workspace"
          }
        },
        "title": "UndeleteWorkspaceResponse",
        "additionalProperties": false
      },
      "spin.v1.UnexposePortRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "port": {
            "type": "integer",
            "title": "port",
            "format": "int32"
          }
        },
        "title": "UnexposePortRequest",
        "additionalProperties": false
      },
      "spin.v1.UnexposePortResponse": {
        "type": "object",
        "title": "UnexposePortResponse",
        "additionalProperties": false
      },
      "spin.v1.UnshareSnapshotRequest": {
        "type": "object",
        "properties": {
          "snapshotId": {
            "type": "string",
            "title": "snapshot_id"
          },
          "userId": {
            "type": "string",
            "title": "user_id"
          }
        },
        "title": "UnshareSnapshotRequest",
        "additionalProperties": false
      },
      "spin.v1.UnshareSnapshotResponse": {
        "type": "object",
        "title": "UnshareSnapshotResponse",
        "additionalProperties": false
      },
      "spin.v1.UntagImageRequest": {
        "type": "object",
        "properties": {
          "ref": {
            "type": "string",
            "title": "ref"
          }
        },
        "title": "UntagImageRequest",
        "additionalProperties": false
      },
      "spin.v1.UntagImageResponse": {
        "type": "object",
        "title": "UntagImageResponse",
        "additionalProperties": false
      },
      "spin.v1.UpdateEmailSettingsRequest": {
        "type": "object",
        "properties": {
          "host": {
            "type": "string",
            "title": "host"
          },
          "port": {
            "type": "integer",
            "title": "port",
            "format": "int32"
          },
          "username": {
            "type": "string",
            "title": "username"
          },
          "password": {
            "type": [
              "string",
              "null"
            ],
            "title": "password",
            "description": "Absent keeps the password there is."
          },
          "from": {
            "type": "string",
            "title": "from"
          }
        },
        "title": "UpdateEmailSettingsRequest",
        "additionalProperties": false
      },
      "spin.v1.UpdateEmailSettingsResponse": {
        "type": "object",
        "properties": {
          "settings": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.EmailSettings"
              }
            ],
            "title": "settings"
          }
        },
        "title": "UpdateEmailSettingsResponse",
        "additionalProperties": false
      },
      "spin.v1.UpdateHostClassRequest": {
        "type": "object",
        "properties": {
          "class": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.HostClass"
              }
            ],
            "title": "class"
          }
        },
        "title": "UpdateHostClassRequest",
        "additionalProperties": false,
        "description": "The class named class.name, made what class says. Its group is held to it at the autoscaler's\n next pass; machines it started already keep their shape until they go."
      },
      "spin.v1.UpdateHostClassResponse": {
        "type": "object",
        "properties": {
          "class": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.HostClass"
              }
            ],
            "title": "class"
          }
        },
        "title": "UpdateHostClassResponse",
        "additionalProperties": false
      },
      "spin.v1.UpdateNetworkPolicyRequest": {
        "type": "object",
        "properties": {
          "policy": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.NetworkPolicyRule"
              }
            ],
            "title": "policy"
          }
        },
        "title": "UpdateNetworkPolicyRequest",
        "additionalProperties": false,
        "description": "UpdateNetworkPolicyRequest replaces what the policy of that name allows, whole."
      },
      "spin.v1.UpdateNetworkPolicyResponse": {
        "type": "object",
        "title": "UpdateNetworkPolicyResponse",
        "additionalProperties": false
      },
      "spin.v1.UpdateNotificationPreferencesRequest": {
        "type": "object",
        "properties": {
          "preferences": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.NotificationPreference"
            },
            "title": "preferences",
            "description": "Each event named is set; one not named keeps what it was."
          }
        },
        "title": "UpdateNotificationPreferencesRequest",
        "additionalProperties": false
      },
      "spin.v1.UpdateNotificationPreferencesResponse": {
        "type": "object",
        "properties": {
          "preferences": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.NotificationPreference"
            },
            "title": "preferences"
          }
        },
        "title": "UpdateNotificationPreferencesResponse",
        "additionalProperties": false
      },
      "spin.v1.UpdateProjectRequest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          },
          "name": {
            "type": "string",
            "title": "name"
          },
          "slug": {
            "type": "string",
            "title": "slug"
          },
          "description": {
            "type": "string",
            "title": "description"
          },
          "repository": {
            "type": "string",
            "title": "repository"
          },
          "ref": {
            "type": "string",
            "title": "ref"
          },
          "image": {
            "type": "string",
            "title": "image"
          },
          "preset": {
            "type": "string",
            "title": "preset"
          },
          "networkTags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "network_tags"
          },
          "prebuildRefs": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "prebuild_refs"
          },
          "prebuildRebaseEvery": {
            "type": "integer",
            "title": "prebuild_rebase_every",
            "format": "int32"
          },
          "prebuildKeep": {
            "type": "integer",
            "title": "prebuild_keep",
            "format": "int32",
            "description": "Zero is one, as at create"
          }
        },
        "title": "UpdateProjectRequest",
        "additionalProperties": false,
        "description": "Whole: every field is what the project becomes, as a form saves it."
      },
      "spin.v1.UpdateProjectResponse": {
        "type": "object",
        "properties": {
          "project": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.Project"
              }
            ],
            "title": "project"
          }
        },
        "title": "UpdateProjectResponse",
        "additionalProperties": false
      },
      "spin.v1.UpdateResourcePresetRequest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id",
            "description": "Required: preset ID to update"
          },
          "name": {
            "type": "string",
            "title": "name",
            "description": "Optional: new display name"
          },
          "description": {
            "type": "string",
            "title": "description",
            "description": "Optional: new description"
          },
          "cpuCores": {
            "type": "integer",
            "title": "cpu_cores",
            "format": "int32",
            "description": "Optional: new CPU cores"
          },
          "memoryMb": {
            "type": "integer",
            "title": "memory_mb",
            "format": "int32",
            "description": "Optional: new memory"
          },
          "diskGb": {
            "type": "integer",
            "title": "disk_gb",
            "format": "int32",
            "description": "Optional: new disk"
          },
          "burst": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.BurstMode"
              }
            ],
            "title": "burst",
            "description": "Optional: new burst mode"
          },
          "isDefault": {
            "type": "boolean",
            "title": "is_default",
            "description": "Optional: make this the default"
          },
          "enabled": {
            "type": "boolean",
            "title": "enabled",
            "description": "Optional: enable/disable"
          },
          "sortOrder": {
            "type": "integer",
            "title": "sort_order",
            "format": "int32",
            "description": "Optional: new display order"
          },
          "burstFloorCpuCores": {
            "type": "integer",
            "title": "burst_floor_cpu_cores",
            "format": "int32",
            "description": "Optional: new burst floor"
          },
          "burstFloorMemoryMb": {
            "type": "integer",
            "title": "burst_floor_memory_mb",
            "format": "int32",
            "description": "Optional: new burst floor"
          },
          "bandwidthMbps": {
            "type": [
              "integer",
              "null"
            ],
            "title": "bandwidth_mbps",
            "format": "int32",
            "description": "Optional: a new bandwidth. Present, since zero - unshaped - is an answer and not \"keep\"."
          },
          "rpoSeconds": {
            "type": [
              "integer",
              "null"
            ],
            "title": "rpo_seconds",
            "format": "int32",
            "description": "Optional: a new RPO. Present, since zero - the installation's - is an answer and not \"keep\"."
          },
          "hostClass": {
            "type": "string",
            "title": "host_class",
            "description": "Optional: a new host class; empty keeps it. Its workspaces made before keep theirs."
          }
        },
        "title": "UpdateResourcePresetRequest",
        "additionalProperties": false
      },
      "spin.v1.UpdateResourcePresetResponse": {
        "type": "object",
        "properties": {
          "preset": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.ResourcePreset"
              }
            ],
            "title": "preset"
          }
        },
        "title": "UpdateResourcePresetResponse",
        "additionalProperties": false
      },
      "spin.v1.UpdateStorageSettingsRequest": {
        "type": "object",
        "properties": {
          "bucket": {
            "type": "string",
            "title": "bucket"
          },
          "endpoint": {
            "type": "string",
            "title": "endpoint"
          },
          "region": {
            "type": "string",
            "title": "region"
          },
          "accessKeyId": {
            "type": "string",
            "title": "access_key_id"
          },
          "secretAccessKey": {
            "type": [
              "string",
              "null"
            ],
            "title": "secret_access_key",
            "description": "Absent keeps the secret there is."
          },
          "dir": {
            "type": "string",
            "title": "dir"
          },
          "principal": {
            "type": "string",
            "title": "principal"
          }
        },
        "title": "UpdateStorageSettingsRequest",
        "additionalProperties": false
      },
      "spin.v1.UpdateStorageSettingsResponse": {
        "type": "object",
        "properties": {
          "settings": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.StorageSettings"
              }
            ],
            "title": "settings"
          }
        },
        "title": "UpdateStorageSettingsResponse",
        "additionalProperties": false
      },
      "spin.v1.UpdateTeamIdentityProviderRequest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          },
          "name": {
            "type": "string",
            "title": "name"
          },
          "autoJoinCelExpression": {
            "type": "string",
            "title": "auto_join_cel_expression"
          },
          "roleCelExpression": {
            "type": "string",
            "title": "role_cel_expression"
          },
          "enabled": {
            "type": "boolean",
            "title": "enabled"
          }
        },
        "title": "UpdateTeamIdentityProviderRequest",
        "additionalProperties": false
      },
      "spin.v1.UpdateTeamIdentityProviderResponse": {
        "type": "object",
        "properties": {
          "provider": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.TeamIdentityProvider"
              }
            ],
            "title": "provider"
          }
        },
        "title": "UpdateTeamIdentityProviderResponse",
        "additionalProperties": false
      },
      "spin.v1.UpdateTeamMemberRoleRequest": {
        "type": "object",
        "properties": {
          "teamId": {
            "type": "string",
            "title": "team_id"
          },
          "userId": {
            "type": "string",
            "title": "user_id"
          },
          "role": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.TeamRole"
              }
            ],
            "title": "role"
          }
        },
        "title": "UpdateTeamMemberRoleRequest",
        "additionalProperties": false
      },
      "spin.v1.UpdateTeamMemberRoleResponse": {
        "type": "object",
        "properties": {
          "member": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.TeamMember"
              }
            ],
            "title": "member"
          }
        },
        "title": "UpdateTeamMemberRoleResponse",
        "additionalProperties": false
      },
      "spin.v1.UpdateTeamRequest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          },
          "name": {
            "type": "string",
            "title": "name"
          },
          "description": {
            "type": "string",
            "title": "description"
          },
          "displayName": {
            "type": "string",
            "title": "display_name",
            "description": "Human-friendly name"
          }
        },
        "title": "UpdateTeamRequest",
        "additionalProperties": false
      },
      "spin.v1.UpdateTeamResponse": {
        "type": "object",
        "properties": {
          "team": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.Team"
              }
            ],
            "title": "team"
          }
        },
        "title": "UpdateTeamResponse",
        "additionalProperties": false
      },
      "spin.v1.UpdateUserRequest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id",
            "description": "Required: user ID"
          },
          "isInstanceAdmin": {
            "type": [
              "boolean",
              "null"
            ],
            "title": "is_instance_admin",
            "description": "Toggle admin status"
          },
          "disabled": {
            "type": [
              "boolean",
              "null"
            ],
            "title": "disabled",
            "description": "Disable/enable user"
          },
          "disabledReason": {
            "type": [
              "string",
              "null"
            ],
            "title": "disabled_reason",
            "description": "Reason for disabling (shown to user)"
          }
        },
        "title": "UpdateUserRequest",
        "additionalProperties": false
      },
      "spin.v1.UpdateUserResponse": {
        "type": "object",
        "properties": {
          "user": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.User"
              }
            ],
            "title": "user"
          }
        },
        "title": "UpdateUserResponse",
        "additionalProperties": false
      },
      "spin.v1.UpdateUserSettingsRequest": {
        "type": "object",
        "properties": {
          "dotfiles": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.DotfilesConfig"
              }
            ],
            "title": "dotfiles"
          },
          "startupTaskfile": {
            "type": "string",
            "title": "startup_taskfile"
          },
          "defaultShell": {
            "type": "string",
            "title": "default_shell"
          },
          "editorSettings": {
            "type": "object",
            "title": "editor_settings",
            "additionalProperties": {
              "type": "string",
              "title": "value"
            }
          },
          "defaultEnv": {
            "type": "object",
            "title": "default_env",
            "additionalProperties": {
              "type": "string",
              "title": "value"
            }
          }
        },
        "title": "UpdateUserSettingsRequest",
        "additionalProperties": false
      },
      "spin.v1.UpdateUserSettingsResponse": {
        "type": "object",
        "properties": {
          "settings": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.UserSettings"
              }
            ],
            "title": "settings"
          }
        },
        "title": "UpdateUserSettingsResponse",
        "additionalProperties": false
      },
      "spin.v1.UpdateWorkspaceRequest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id",
            "description": "Required: workspace ID or name"
          },
          "name": {
            "type": "string",
            "title": "name",
            "description": "Optional: new name"
          },
          "env": {
            "type": "object",
            "title": "env",
            "additionalProperties": {
              "type": "string",
              "title": "value"
            },
            "description": "Optional: replace environment variables"
          },
          "wakeOnAccess": {
            "type": [
              "boolean",
              "null"
            ],
            "title": "wake_on_access",
            "description": "Note: resource changes require stop/start Optional: Workspace.wake_on_access"
          }
        },
        "title": "UpdateWorkspaceRequest",
        "additionalProperties": false
      },
      "spin.v1.UpdateWorkspaceResponse": {
        "type": "object",
        "properties": {
          "workspace": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.Workspace"
              }
            ],
            "title": "workspace"
          }
        },
        "title": "UpdateWorkspaceResponse",
        "additionalProperties": false
      },
      "spin.v1.User": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          },
          "email": {
            "type": "string",
            "title": "email"
          },
          "name": {
            "type": "string",
            "title": "name"
          },
          "avatarUrl": {
            "type": "string",
            "title": "avatar_url"
          },
          "subscriptionTier": {
            "type": "string",
            "title": "subscription_tier"
          },
          "createdAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "created_at"
          },
          "isInstanceAdmin": {
            "type": "boolean",
            "title": "is_instance_admin"
          },
          "disabled": {
            "type": "boolean",
            "title": "disabled"
          },
          "disabledReason": {
            "type": "string",
            "title": "disabled_reason"
          },
          "lastLoginAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "last_login_at",
            "description": "When they last signed in, by any route; unset for one who never has."
          }
        },
        "title": "User",
        "additionalProperties": false
      },
      "spin.v1.UserHoldings": {
        "type": "object",
        "properties": {
          "apiKeys": {
            "type": "integer",
            "title": "api_keys",
            "format": "int32",
            "description": "API keys not yet expired."
          },
          "teams": {
            "type": "integer",
            "title": "teams",
            "format": "int32"
          }
        },
        "title": "UserHoldings",
        "additionalProperties": false
      },
      "spin.v1.UserSettings": {
        "type": "object",
        "properties": {
          "dotfiles": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.DotfilesConfig"
              }
            ],
            "title": "dotfiles"
          },
          "startupTaskfile": {
            "type": "string",
            "title": "startup_taskfile",
            "description": "Inline Taskfile YAML"
          },
          "defaultShell": {
            "type": "string",
            "title": "default_shell",
            "description": "e.g., /bin/bash, /bin/zsh"
          },
          "editorSettings": {
            "type": "object",
            "title": "editor_settings",
            "additionalProperties": {
              "type": "string",
              "title": "value"
            },
            "description": "IDE preferences"
          },
          "defaultEnv": {
            "type": "object",
            "title": "default_env",
            "additionalProperties": {
              "type": "string",
              "title": "value"
            },
            "description": "Environment variables"
          },
          "updatedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "updated_at"
          }
        },
        "title": "UserSettings",
        "additionalProperties": false
      },
      "spin.v1.VSCodeServerPublish": {
        "type": "object",
        "properties": {
          "state": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.VSCodeServerPublishState"
              }
            ],
            "title": "state"
          },
          "step": {
            "type": "string",
            "title": "step",
            "description": "Which part is running, while it works."
          },
          "detail": {
            "type": "string",
            "title": "detail",
            "description": "Why it failed."
          },
          "version": {
            "type": "string",
            "title": "version",
            "description": "What it released, once it has."
          },
          "updatedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "updated_at"
          }
        },
        "title": "VSCodeServerPublish",
        "additionalProperties": false,
        "description": "VSCodeServerPublish is this control plane's publish: the last one, or the one under way."
      },
      "spin.v1.VSCodeServerPublishState": {
        "type": "string",
        "title": "VSCodeServerPublishState",
        "enum": [
          "VS_CODE_SERVER_PUBLISH_STATE_UNSPECIFIED",
          "VS_CODE_SERVER_PUBLISH_STATE_IDLE",
          "VS_CODE_SERVER_PUBLISH_STATE_WORKING",
          "VS_CODE_SERVER_PUBLISH_STATE_PUBLISHED",
          "VS_CODE_SERVER_PUBLISH_STATE_FAILED"
        ],
        "description": "- `VS_CODE_SERVER_PUBLISH_STATE_IDLE`: Nothing published since this control plane started.",
        "x-enum-descriptions": [
          "",
          "Nothing published since this control plane started.",
          "",
          "",
          ""
        ]
      },
      "spin.v1.ValidateTaskfileRequest": {
        "type": "object",
        "properties": {
          "taskfileContent": {
            "type": "string",
            "title": "taskfile_content"
          }
        },
        "title": "ValidateTaskfileRequest",
        "additionalProperties": false,
        "description": "Taskfile validation"
      },
      "spin.v1.ValidateTaskfileResponse": {
        "type": "object",
        "properties": {
          "valid": {
            "type": "boolean",
            "title": "valid"
          },
          "errors": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "errors"
          },
          "taskNames": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "task_names",
            "description": "List of defined tasks"
          }
        },
        "title": "ValidateTaskfileResponse",
        "additionalProperties": false
      },
      "spin.v1.VolumeRekey": {
        "type": "object",
        "properties": {
          "volumeId": {
            "type": "string",
            "title": "volume_id"
          },
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "workspaceName": {
            "type": "string",
            "title": "workspace_name"
          },
          "state": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.RekeyState"
              }
            ],
            "title": "state"
          },
          "hostId": {
            "type": "string",
            "title": "host_id",
            "description": "The host copying it, empty while pending."
          },
          "reason": {
            "type": "string",
            "title": "reason"
          }
        },
        "title": "VolumeRekey",
        "additionalProperties": false,
        "description": "VolumeRekey is a workspace's disk to re-key or being re-keyed."
      },
      "spin.v1.WaitSnapshotRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "snapshotId": {
            "type": "string",
            "title": "snapshot_id"
          },
          "timeoutSeconds": {
            "type": "integer",
            "title": "timeout_seconds",
            "format": "int32",
            "description": "At most 600; zero is 300."
          }
        },
        "title": "WaitSnapshotRequest",
        "additionalProperties": false,
        "description": "WaitSnapshotRequest waits for one of a workspace's snapshots to be published. FAILED_PRECONDITION\n when it failed or is being deleted; DEADLINE_EXCEEDED when timeout_seconds pass first."
      },
      "spin.v1.WaitSnapshotResponse": {
        "type": "object",
        "properties": {
          "snapshot": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.Snapshot"
              }
            ],
            "title": "snapshot"
          }
        },
        "title": "WaitSnapshotResponse",
        "additionalProperties": false
      },
      "spin.v1.WaitWorkspaceRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "state": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.WorkspaceState"
              }
            ],
            "title": "state"
          },
          "timeoutSeconds": {
            "type": "integer",
            "title": "timeout_seconds",
            "format": "int32",
            "description": "At most 600; zero is 300."
          }
        },
        "title": "WaitWorkspaceRequest",
        "additionalProperties": false,
        "description": "A workspace's state is held by four parties that can disagree, and the disagreement is\n the diagnosis. The control plane has a lifecycle state it set; the supervisor inside the\n guest reports what it is doing and how it is; the host either heartbeats or does not; the\n volume either serves the disk or refuses with a reason. Asking any one of them alone\n produces the two failures this answers: a workspace the control plane calls RUNNING whose\n supervisor stopped reporting ten minutes ago, and one that looks broken because its host\n is unreachable, which is a different repair.\n\n It is its own RPC and not fields on GetWorkspace because those are different questions.\n WaitWorkspaceRequest names the state to wait for: RUNNING or STOPPED.\n\n Answered with the workspace once it is in that state. Refused as soon as waiting cannot end\n there: FAILED_PRECONDITION with the failure reason when the workspace failed, or when it is\n neither in that state nor wanted in it (a stop was asked for while waiting for RUNNING).\n DEADLINE_EXCEEDED when timeout_seconds pass first."
      },
      "spin.v1.WaitWorkspaceResponse": {
        "type": "object",
        "properties": {
          "workspace": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.Workspace"
              }
            ],
            "title": "workspace"
          }
        },
        "title": "WaitWorkspaceResponse",
        "additionalProperties": false
      },
      "spin.v1.Workspace": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          },
          "name": {
            "type": "string",
            "title": "name"
          },
          "teamId": {
            "type": "string",
            "title": "team_id",
            "description": "Every workspace has one: its owner's personal team unless another was named"
          },
          "hostId": {
            "type": "string",
            "title": "host_id"
          },
          "image": {
            "type": "string",
            "title": "image",
            "description": "Container image used for this workspace"
          },
          "resources": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.Resources"
              }
            ],
            "title": "resources"
          },
          "state": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.WorkspaceState"
              }
            ],
            "title": "state"
          },
          "url": {
            "type": "string",
            "title": "url",
            "description": "Output only: https://{name}.{base domain}; empty until setup records a domain"
          },
          "env": {
            "type": "object",
            "title": "env",
            "additionalProperties": {
              "type": "string",
              "title": "value"
            }
          },
          "createdAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "created_at"
          },
          "updatedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "updated_at"
          },
          "snapshotCount": {
            "type": "integer",
            "title": "snapshot_count",
            "format": "int32",
            "description": "Number of snapshots in history"
          },
          "failureReason": {
            "type": "string",
            "title": "failure_reason",
            "description": "Reason for failure (only set when state=FAILED)"
          },
          "networkTags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "network_tags",
            "description": "The network policies this workspace runs under, by name. Read back because what a\n workspace may reach is worth seeing without asking the host that enforces it."
          },
          "hostConnected": {
            "type": "boolean",
            "title": "host_connected",
            "description": "host_connected says the host this workspace is on is talking to the control plane now.\n\n A workspace's state is its host's last word, and a host that stops talking stops\n correcting it: RUNNING is not transitional, so nothing fails it and nothing moves it, and\n a workspace whose machine died with its host reads as healthy for ever. The honest answer\n is not a different state - a host that cannot be reached may be running the machine\n perfectly well behind a broken network - but to say that the state is old and why.\n\n False for a workspace with no host at all (a stopped one), so read it beside the state."
          },
          "waitingReason": {
            "type": "string",
            "title": "waiting_reason",
            "description": "waiting_reason is why a WAITING workspace has no host yet, as of the last attempt to place\n it: which runner was full of what, or that none is connected. Empty in every other state."
          },
          "failure": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.WorkspaceFailure"
              }
            ],
            "title": "failure",
            "description": "failure is which part failed when state=FAILED, UNSPECIFIED in every other state: what a\n client says a person can do is decided by it, and failure_reason is the detail."
          },
          "networkWatch": {
            "type": "boolean",
            "title": "network_watch",
            "description": "network_watch says its host records where it connects into its logs\n (SetWorkspaceNetworkWatch)."
          },
          "floorCpuCores": {
            "type": "integer",
            "title": "floor_cpu_cores",
            "format": "int32",
            "description": "What its preset started it at. resources.cpu_cores and memory_mb are what it holds now, and\n above these they are a grant (GrantWorkspaceResources)."
          },
          "floorMemoryMb": {
            "type": "integer",
            "title": "floor_memory_mb",
            "format": "int32"
          },
          "grantExpiresAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "grant_expires_at",
            "description": "When its grant is given back on its own; unset for one kept until it is given back, and for\n a workspace holding none."
          },
          "quarantineHeld": {
            "type": "boolean",
            "title": "quarantine_held",
            "description": "quarantine_held says a quarantine holds it: in force (state QUARANTINED), or asked for and\n its stop still on the way or ended FAILED. Until an administrator releases it, its own\n person cannot start, move or delete it, whatever the state says."
          },
          "progress": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.WorkspaceProgress"
              }
            ],
            "title": "progress",
            "description": "progress is where a transition is while one is under way - CREATING, STARTING, STOPPING,\n WAITING - and unset at rest: which attempt, why the one before failed, what the host is doing\n now, since when and until when before the control plane gives up on it."
          },
          "allowedActions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.WorkspaceAction"
            },
            "title": "allowed_actions",
            "description": "allowed_actions are what the server takes from this workspace as it is: its state, a\n quarantine's hold, and the failure it ended in. A client offers these and no others."
          },
          "failureSummary": {
            "type": "string",
            "title": "failure_summary",
            "description": "failure_summary says in a sentence what failed when state=FAILED, decided by failure: what\n a client shows above failure_reason, so the dashboard and the CLI say the same thing. What to\n do next is each client's, from allowed_actions."
          },
          "readyAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "ready_at",
            "description": "ready_at is when the workspace's supervisor answered for its current run: the workspace is\n usable, not only its machine handed off. Unset before, and while it is not running."
          },
          "traceId": {
            "type": "string",
            "title": "trace_id",
            "description": "trace_id is the trace of the request that asked for its current generation, which runs through\n the host's operation and the state it reported. Empty when that request was not sampled."
          },
          "durability": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.WorkspaceDurability"
              }
            ],
            "title": "durability",
            "description": "durability is how much of its disk is in the object store, in every state - running,\n stopped or suspended. Answered by GetWorkspace only, and only for a workspace with a volume:\n a listing does not ask every volume."
          },
          "role": {
            "type": "string",
            "title": "role",
            "description": "role is the caller's in it: \"owner\", or \"guest\" - who may connect, see it and open its\n ports, and nothing that changes it."
          },
          "checkoutPath": {
            "type": "string",
            "title": "checkout_path",
            "description": "checkout_path is where the workspace's project is checked out (projects.CheckoutPath), empty\n for a workspace that opened none: where its agent works unless told otherwise. GetWorkspace\n alone says it."
          },
          "memoryMachineGone": {
            "type": "boolean",
            "title": "memory_machine_gone",
            "description": "memory_machine_gone says it is suspended with memory taken on a machine no host of the\n installation registers now (WORKSPACE_FAILURE_MACHINE_CHANGED): a start cannot resume it, and\n WORKSPACE_ACTION_START_FROM_DISK, which drops the memory, is what is offered instead."
          },
          "suspendsAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "suspends_at",
            "description": "The question before a suspension: when the installation suspends it unless somebody keeps it\n (KeepWorkspace), asked ten minutes ahead, and which of the two suspensions is due\n (WORKSPACE_EVENT_TYPE_IDLE_SUSPENDED or WORKSPACE_EVENT_TYPE_RUNNING_CAP_SUSPENDED). Unset\n while none is due within the warning: somebody used it since, or it is kept."
          },
          "suspendsFor": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.WorkspaceEventType"
              }
            ],
            "title": "suspends_for"
          },
          "keptUntil": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "kept_until",
            "description": "An answer: kept awake until then, and neither suspension fires before it."
          },
          "leases": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.WorkspaceLease"
            },
            "title": "leases",
            "description": "The leases its processes hold, as its supervisor last reported them: while one is held\n and within the installation's workspace_lease_max_minutes of its start, nobody is asked,\n nothing idle is suspended, and the running cap waits for the lease's end."
          },
          "projectId": {
            "type": "string",
            "title": "project_id",
            "description": "The project it opened and the ref it was opened at; empty for a workspace that opened none."
          },
          "ref": {
            "type": "string",
            "title": "ref"
          },
          "wakeOnAccess": {
            "type": "boolean",
            "title": "wake_on_access",
            "description": "Suspended, it is resumed by a signed-in visitor of one of its published ports\n (OpenWorkspaceProxySession). Never by an anonymous one: that would undo the idle suspension\n for whoever has a public port's URL."
          },
          "suspendedSnapshotId": {
            "type": "string",
            "title": "suspended_snapshot_id",
            "description": "The snapshot it was suspended into: its next start resumes it rather than booting its disk.\n Empty when a start boots the disk - never suspended, resumed since, or the snapshot deleted."
          },
          "fromPrebuildId": {
            "type": "string",
            "title": "from_prebuild_id",
            "description": "The prebuild its disk is a clone of; empty for one that opened with none."
          },
          "agentMinMemoryMb": {
            "type": "integer",
            "title": "agent_min_memory_mb",
            "format": "int32",
            "description": "What it has to hold for its agent to start there, in MB (the supervisor refuses below it)."
          },
          "projectError": {
            "type": "string",
            "title": "project_error",
            "description": "project_error is what its guest last said went wrong with its project - the clone, its\n .spin.yaml or its create tasks - as the guest said it; empty when all of it went, or nothing\n has reported. The next boot tries again. A running workspace with one is DEGRADED."
          },
          "ownerId": {
            "type": "string",
            "title": "owner_id",
            "description": "Whose it is: on a team's workspace, which member's. owner_id is in every answer; the name and\n email are answered by GetWorkspace and ListWorkspaces, whose callers - its owner and the\n guests its owner let in - are who may see it at all."
          },
          "ownerName": {
            "type": "string",
            "title": "owner_name"
          },
          "ownerEmail": {
            "type": "string",
            "title": "owner_email"
          },
          "hostClass": {
            "type": "string",
            "title": "host_class",
            "description": "host_class is the host class it runs on (HostClass.name), from its preset: placed only on a\n host of it, \"default\" where its preset named none."
          },
          "attempts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.WorkspaceAttempt"
            },
            "title": "attempts",
            "description": "attempts are the attempts its host failed at its current generation, oldest first: each one\n the host retried, and the last when the host ended the generation FAILED. Kept once it\n settles - FAILED says which attempt it was and what the ones before it hit - and gone with\n the next start, which is a new generation. An attempt whose report never reached the control\n plane is not here: the host reports why the attempt before failed, and a lost report is\n replaced by the next."
          },
          "projectReportedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "project_reported_at",
            "description": "project_reported_at is when its guest said how its project went in this run, unset until it\n has: an empty project_error before then is a clone still going, not one that went.\n project_head is the commit it checked out, as the guest said it; empty when it did not say one."
          },
          "projectHead": {
            "type": "string",
            "title": "project_head"
          },
          "hostName": {
            "type": "string",
            "title": "host_name",
            "description": "host_name is the name host_id's machine registered, for a person to tell hosts apart; empty\n with no host, or one that registered none. Answered by GetWorkspace and ListWorkspaces, so a\n list row says where each runs without a status read per row; never placed or trusted by."
          },
          "withoutPrebuild": {
            "type": "string",
            "title": "without_prebuild",
            "description": "without_prebuild is why a workspace opening a project at a ref it prebuilds started from none\n of its prebuilds, and cloned the repository at its first boot: none ready, the ready one of\n another image, its disk not cloneable yet. Empty with from_prebuild_id set, or for a project\n that prebuilds nothing."
          }
        },
        "title": "Workspace",
        "additionalProperties": false
      },
      "spin.v1.WorkspaceAction": {
        "type": "string",
        "title": "WorkspaceAction",
        "enum": [
          "WORKSPACE_ACTION_UNSPECIFIED",
          "WORKSPACE_ACTION_START",
          "WORKSPACE_ACTION_STOP",
          "WORKSPACE_ACTION_FORCE_STOP",
          "WORKSPACE_ACTION_DELETE",
          "WORKSPACE_ACTION_FORCE_DELETE",
          "WORKSPACE_ACTION_SUSPEND",
          "WORKSPACE_ACTION_START_FROM_DISK"
        ],
        "description": "WorkspaceAction is an act a person can ask of a workspace.\n\n- `WORKSPACE_ACTION_FORCE_STOP`: Stop without waiting for the guest: also what ends a stop that does not finish.\n- `WORKSPACE_ACTION_SUSPEND`: Put down with its memory, to be resumed where it was.\n- `WORKSPACE_ACTION_START_FROM_DISK`: Boot a suspended workspace from its disk, dropping its memory (StartWorkspaceRequest.from_disk):\n  offered when that memory's machine is run by no host (Workspace.memory_machine_gone).",
        "x-enum-descriptions": [
          "",
          "",
          "",
          "Stop without waiting for the guest: also what ends a stop that does not finish.",
          "",
          "",
          "Put down with its memory, to be resumed where it was.",
          "Boot a suspended workspace from its disk, dropping its memory (StartWorkspaceRequest.from_disk):\n offered when that memory's machine is run by no host (Workspace.memory_machine_gone)."
        ]
      },
      "spin.v1.WorkspaceAgentThreads": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "workspaceName": {
            "type": "string",
            "title": "workspace_name"
          },
          "state": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.WorkspaceState"
              }
            ],
            "title": "state"
          },
          "projectId": {
            "type": "string",
            "title": "project_id",
            "description": "Empty for a workspace that opened no project."
          },
          "projectName": {
            "type": "string",
            "title": "project_name"
          },
          "environmentId": {
            "type": "string",
            "title": "environment_id",
            "description": "As ListAgentThreadsResponse.environment_id: the first part of a thread's page."
          },
          "threads": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.AgentThread"
            },
            "title": "threads",
            "description": "Newest first."
          }
        },
        "title": "WorkspaceAgentThreads",
        "additionalProperties": false,
        "description": "WorkspaceAgentThreads is one workspace's chats with what a rail names it by: the workspace, its\n state, and the project it opened."
      },
      "spin.v1.WorkspaceAttempt": {
        "type": "object",
        "properties": {
          "attempt": {
            "type": "integer",
            "title": "attempt",
            "format": "int32",
            "description": "attempt is its number, from 1, of the host's attempts at the generation (WorkspaceProgress\n .attempts is how many it makes); zero where the host never said which it was on."
          },
          "failure": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.WorkspaceFailure"
              }
            ],
            "title": "failure",
            "description": "Which part failed, and the host's words for why."
          },
          "reason": {
            "type": "string",
            "title": "reason"
          },
          "failedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "failed_at",
            "description": "failed_at is when the control plane heard that it failed."
          }
        },
        "title": "WorkspaceAttempt",
        "additionalProperties": false,
        "description": "WorkspaceAttempt is one attempt a host made at a workspace's generation that failed."
      },
      "spin.v1.WorkspaceCost": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "name": {
            "type": "string",
            "title": "name"
          },
          "teamId": {
            "type": "string",
            "title": "team_id"
          },
          "teamName": {
            "type": "string",
            "title": "team_name",
            "description": "Empty where the team was deleted since."
          },
          "ownerId": {
            "type": "string",
            "title": "owner_id"
          },
          "ownerEmail": {
            "type": "string",
            "title": "owner_email",
            "description": "Empty where the owner was deleted since."
          },
          "computeMicros": {
            "type": "string",
            "title": "compute_micros",
            "format": "int64",
            "description": "Its share of the runners: what it held of them."
          },
          "storageMicros": {
            "type": "string",
            "title": "storage_micros",
            "format": "int64",
            "description": "Its share of the volumes' bucket: what its volumes kept."
          },
          "sentBytes": {
            "type": "string",
            "title": "sent_bytes",
            "format": "int64",
            "description": "What its traffic came to in the month: its machine's network out and back, and its sessions -\n ssh, the editor, forwarded ports - through the relay, both ways. Counted, not yet costed."
          },
          "receivedBytes": {
            "type": "string",
            "title": "received_bytes",
            "format": "int64"
          },
          "forwardedBytes": {
            "type": "string",
            "title": "forwarded_bytes",
            "format": "int64"
          }
        },
        "title": "WorkspaceCost",
        "additionalProperties": false,
        "description": "What one workspace cost in the month, in millionths of the bill's currency, and whose it was on\n the last day it cost anything."
      },
      "spin.v1.WorkspaceDeparture": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "workspaceName": {
            "type": "string",
            "title": "workspace_name"
          },
          "ownerEmail": {
            "type": "string",
            "title": "owner_email"
          },
          "state": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.WorkspaceState"
              }
            ],
            "title": "state"
          },
          "drain": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.DepartureFate"
              }
            ],
            "title": "drain",
            "description": "What a drain that moves the host's workspaces (DrainHostRequest.suspend) does to it: MOVES or\n STAYS."
          },
          "removal": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.DepartureFate"
              }
            ],
            "title": "removal",
            "description": "What Host.removal does to it: LOSES_PLACE or HOLDS. UNSPECIFIED where the host has no removal."
          },
          "taken": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.DepartureFate"
              }
            ],
            "title": "taken",
            "description": "What removing the host as taken (RemoveHostRequest.taken) does to it: LOSES_PLACE or STOPS.\n UNSPECIFIED for a host that is revoked, whose revoke already is that."
          }
        },
        "title": "WorkspaceDeparture",
        "additionalProperties": false,
        "description": "WorkspaceDeparture is one workspace on a host and what each way of taking the host out does to it."
      },
      "spin.v1.WorkspaceDurability": {
        "type": "object",
        "properties": {
          "lastPublishedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "last_published_at",
            "description": "last_published_at is when its last commit reached the object store, as its host last said;\n from a snapshot, when that snapshot was taken."
          },
          "unpublishedSeconds": {
            "type": "string",
            "title": "unpublished_seconds",
            "format": "int64",
            "description": "What is written and not yet published, as of the host's report plus the time since."
          },
          "unpublishedBytes": {
            "type": "string",
            "title": "unpublished_bytes",
            "format": "int64"
          },
          "stalled": {
            "type": "boolean",
            "title": "stalled",
            "description": "stalled says publishing has not kept up with the bound it runs to (the volume's RPO)."
          },
          "reportedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "reported_at",
            "description": "reported_at is the host's report these are as of; unset when they are a snapshot's."
          },
          "snapshotId": {
            "type": "string",
            "title": "snapshot_id",
            "description": "snapshot_id is the published snapshot the last copy is, when no host serves the disk, and\n published_bytes how much of the disk it holds. Empty and zero while they are a host's report."
          },
          "publishedBytes": {
            "type": "string",
            "title": "published_bytes",
            "format": "int64"
          }
        },
        "title": "WorkspaceDurability",
        "additionalProperties": false,
        "description": "WorkspaceDurability is what of a workspace's disk is published, so it survives its host. While\n a host serves the disk - running, or stopped with its disk kept there - it is that host's last\n report; once none does - suspended, or its disk handed back to the store - it is the newest\n published snapshot of the disk (snapshot_id), which is what a start boots from."
      },
      "spin.v1.WorkspaceEvent": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "id"
          },
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "type": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.WorkspaceEventType"
              }
            ],
            "title": "type"
          },
          "timestamp": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "timestamp"
          },
          "details": {
            "type": "string",
            "title": "details",
            "description": "Additional info (JSON)"
          }
        },
        "title": "WorkspaceEvent",
        "additionalProperties": false,
        "description": "Timeline event for workspace state changes"
      },
      "spin.v1.WorkspaceEventType": {
        "type": "string",
        "title": "WorkspaceEventType",
        "enum": [
          "WORKSPACE_EVENT_TYPE_UNSPECIFIED",
          "WORKSPACE_EVENT_TYPE_CREATED",
          "WORKSPACE_EVENT_TYPE_STARTED",
          "WORKSPACE_EVENT_TYPE_STOPPED",
          "WORKSPACE_EVENT_TYPE_SNAPSHOT_CREATED",
          "WORKSPACE_EVENT_TYPE_DELETED",
          "WORKSPACE_EVENT_TYPE_FAILED",
          "WORKSPACE_EVENT_TYPE_RESTORED",
          "WORKSPACE_EVENT_TYPE_RESUMED",
          "WORKSPACE_EVENT_TYPE_BOOTED",
          "WORKSPACE_EVENT_TYPE_QUARANTINED",
          "WORKSPACE_EVENT_TYPE_UNQUARANTINED",
          "WORKSPACE_EVENT_TYPE_PLACED",
          "WORKSPACE_EVENT_TYPE_TRASHED",
          "WORKSPACE_EVENT_TYPE_UNDELETED",
          "WORKSPACE_EVENT_TYPE_MOVED",
          "WORKSPACE_EVENT_TYPE_DISPLACED",
          "WORKSPACE_EVENT_TYPE_STOP_BACKUP_FAILED",
          "WORKSPACE_EVENT_TYPE_IDLE_SUSPENDED",
          "WORKSPACE_EVENT_TYPE_RUNNING_CAP_SUSPENDED",
          "WORKSPACE_EVENT_TYPE_SUSPENSION_DUE",
          "WORKSPACE_EVENT_TYPE_KEPT",
          "WORKSPACE_EVENT_TYPE_UNRESPONSIVE",
          "WORKSPACE_EVENT_TYPE_REHOMED",
          "WORKSPACE_EVENT_TYPE_HELD",
          "WORKSPACE_EVENT_TYPE_RECOVERED_BY_ADMIN",
          "WORKSPACE_EVENT_TYPE_OUT_OF_MEMORY",
          "WORKSPACE_EVENT_TYPE_OVERSIZED"
        ],
        "description": "- `WORKSPACE_EVENT_TYPE_CREATED`: Workspace was created\n- `WORKSPACE_EVENT_TYPE_STARTED`: Workspace was started\n- `WORKSPACE_EVENT_TYPE_STOPPED`: Workspace was stopped; its disk is kept, and no snapshot is taken\n- `WORKSPACE_EVENT_TYPE_SNAPSHOT_CREATED`: Manual snapshot\n- `WORKSPACE_EVENT_TYPE_DELETED`: Workspace was deleted\n- `WORKSPACE_EVENT_TYPE_FAILED`: Workspace start failed\n- `WORKSPACE_EVENT_TYPE_RESTORED`: Its disk was put back to a snapshot\n- `WORKSPACE_EVENT_TYPE_RESUMED`: It went on from a snapshot's memory\n- `WORKSPACE_EVENT_TYPE_BOOTED`: Suspended, its memory could not be resumed, and its disk was booted\n- `WORKSPACE_EVENT_TYPE_QUARANTINED`: An administrator held it: stopped, and startable by nobody until released\n- `WORKSPACE_EVENT_TYPE_UNQUARANTINED`: The hold was released: back to stopped, where it was held from\n- `WORKSPACE_EVENT_TYPE_PLACED`: A workspace that waited for a host was given one, and its disk there\n- `WORKSPACE_EVENT_TYPE_TRASHED`: Deleted into the trash: its disk kept, its owner able to undelete it\n- `WORKSPACE_EVENT_TYPE_UNDELETED`: Taken back out of the trash\n- `WORKSPACE_EVENT_TYPE_MOVED`: Suspended on its host and resumed on another, which had room for what it was granted\n- `WORKSPACE_EVENT_TYPE_DISPLACED`: Its host was drained or went away: suspended there, it is resumed on another on its own\n- `WORKSPACE_EVENT_TYPE_STOP_BACKUP_FAILED`: A stop on a host that can be taken away could not publish its disk first, so it runs on\n- `WORKSPACE_EVENT_TYPE_IDLE_SUSPENDED`: Nobody used it for as long as the installation allows: suspended with its processes, a start resumes them\n- `WORKSPACE_EVENT_TYPE_RUNNING_CAP_SUSPENDED`: It ran at a stretch for as long as the installation allows: suspended with its processes, a start resumes them\n- `WORKSPACE_EVENT_TYPE_SUSPENSION_DUE`: A suspension is minutes away and the question was asked: its terminals, its page, the CLI; a keep answers it\n- `WORKSPACE_EVENT_TYPE_KEPT`: Somebody kept it awake until a time: no suspension before it\n- `WORKSPACE_EVENT_TYPE_UNRESPONSIVE`: Its supervisor said nothing for longer than the control plane waits: stopped by force, and a start brings it back\n- `WORKSPACE_EVENT_TYPE_REHOMED`: Its host stopped answering and it was moved to another on its own, giving up what that host had not published\n- `WORKSPACE_EVENT_TYPE_HELD`: Its host stopped answering and moving it would give up more than the installation does on its own: it waits for its owner\n- `WORKSPACE_EVENT_TYPE_RECOVERED_BY_ADMIN`: An administrator moved it off a host that is gone, giving up for its owner what that host had not published; its details say who and why\n- `WORKSPACE_EVENT_TYPE_OUT_OF_MEMORY`: It ran out of memory: its guest's kernel killed a process (cause \"guest\", with the kills and\n  their victims), its host found it short at its ceiling for a while (cause \"ceiling\"), or its\n  host killed the machine (cause \"host\"). Its details say what it held, its grant and its\n  ceiling. Said, never acted on: nothing resizes a workspace on its own.\n- `WORKSPACE_EVENT_TYPE_OVERSIZED`: It held far more than it used for a week: the most memory its processes used stayed under half\n  its own, and a smaller preset would fit what it used. Its details say what it used, what it\n  holds, and that preset. Said, never acted on: nothing resizes a workspace on its own.",
        "x-enum-descriptions": [
          "",
          "Workspace was created",
          "Workspace was started",
          "Workspace was stopped; its disk is kept, and no snapshot is taken",
          "Manual snapshot",
          "Workspace was deleted",
          "Workspace start failed",
          "Its disk was put back to a snapshot",
          "It went on from a snapshot's memory",
          "Suspended, its memory could not be resumed, and its disk was booted",
          "An administrator held it: stopped, and startable by nobody until released",
          "The hold was released: back to stopped, where it was held from",
          "A workspace that waited for a host was given one, and its disk there",
          "Deleted into the trash: its disk kept, its owner able to undelete it",
          "Taken back out of the trash",
          "Suspended on its host and resumed on another, which had room for what it was granted",
          "Its host was drained or went away: suspended there, it is resumed on another on its own",
          "A stop on a host that can be taken away could not publish its disk first, so it runs on",
          "Nobody used it for as long as the installation allows: suspended with its processes, a start resumes them",
          "It ran at a stretch for as long as the installation allows: suspended with its processes, a start resumes them",
          "A suspension is minutes away and the question was asked: its terminals, its page, the CLI; a keep answers it",
          "Somebody kept it awake until a time: no suspension before it",
          "Its supervisor said nothing for longer than the control plane waits: stopped by force, and a start brings it back",
          "Its host stopped answering and it was moved to another on its own, giving up what that host had not published",
          "Its host stopped answering and moving it would give up more than the installation does on its own: it waits for its owner",
          "An administrator moved it off a host that is gone, giving up for its owner what that host had not published; its details say who and why",
          "It ran out of memory: its guest's kernel killed a process (cause \"guest\", with the kills and\n their victims), its host found it short at its ceiling for a while (cause \"ceiling\"), or its\n host killed the machine (cause \"host\"). Its details say what it held, its grant and its\n ceiling. Said, never acted on: nothing resizes a workspace on its own.",
          "It held far more than it used for a week: the most memory its processes used stayed under half\n its own, and a smaller preset would fit what it used. Its details say what it used, what it\n holds, and that preset. Said, never acted on: nothing resizes a workspace on its own."
        ]
      },
      "spin.v1.WorkspaceFailure": {
        "type": "string",
        "title": "WorkspaceFailure",
        "enum": [
          "WORKSPACE_FAILURE_UNSPECIFIED",
          "WORKSPACE_FAILURE_VOLUME",
          "WORKSPACE_FAILURE_EXTENSION",
          "WORKSPACE_FAILURE_NETWORK",
          "WORKSPACE_FAILURE_RESOURCES",
          "WORKSPACE_FAILURE_MACHINE",
          "WORKSPACE_FAILURE_GUEST",
          "WORKSPACE_FAILURE_RELEASE_GONE",
          "WORKSPACE_FAILURE_EXITED",
          "WORKSPACE_FAILURE_STOP",
          "WORKSPACE_FAILURE_TIMED_OUT",
          "WORKSPACE_FAILURE_NO_HOST",
          "WORKSPACE_FAILURE_MACHINE_CHANGED",
          "WORKSPACE_FAILURE_GUEST_PANIC"
        ],
        "description": "WorkspaceFailure is why a FAILED workspace failed: which part of its run, closed so what a\n person can do about it - and a failure rate split by the repair it needs - is decided by the\n kind rather than by the text of an error. The reason beside it is the detail.\n\n One enum for the client and the host's report (spin.agent.v1.ObservedWorkspace): the kind a\n person is shown is the one the host named, with no second list to keep in step.\n\n- `WORKSPACE_FAILURE_UNSPECIFIED`: Not classified. A failure that lands here is a site missing its classification.\n- `WORKSPACE_FAILURE_VOLUME`: Its disk could not be served or made: the host is not serving its volume (its refusal says\n  why), or what the disk was to be made from is gone.\n- `WORKSPACE_FAILURE_EXTENSION`: An extension could not be attached, or the releases it starts with could not be named.\n- `WORKSPACE_FAILURE_NETWORK`: The machine's network namespace or its tags could not be set up.\n- `WORKSPACE_FAILURE_RESOURCES`: The machine could not be given the cores or memory it was asked for.\n- `WORKSPACE_FAILURE_MACHINE`: QEMU could not be prepared or did not boot.\n- `WORKSPACE_FAILURE_GUEST`: The guest booted and did not take its identity or its own filesystem.\n- `WORKSPACE_FAILURE_RELEASE_GONE`: A resume needs an extension release that is no longer in the object store: the memory\n  cannot be resumed anywhere, and the control plane boots the disk with the newest releases.\n- `WORKSPACE_FAILURE_EXITED`: The machine ended without being asked to, and not by a panic of its guest's kernel: its guest\n  reset it, or its QEMU was killed, exited with an error or crashed. The detail says which.\n- `WORKSPACE_FAILURE_STOP`: The machine could not be stopped or removed.\n- `WORKSPACE_FAILURE_TIMED_OUT`: Its host did not bring a start or a stop to an end before the deadline: unreachable, or its\n  attempts outlasted it. The control plane's verdict (the stuck sweep), never a host's.\n- `WORKSPACE_FAILURE_NO_HOST`: No host could take it: none came with room while it waited, or its disk is only on a host\n  that is not connected. The control plane's verdict, never a host's.\n- `WORKSPACE_FAILURE_MACHINE_CHANGED`: Its memory was taken on a machine no host of the installation runs now: the machine's\n  contract moved (a release that changed it), or the processor did. The memory resumes nowhere;\n  the workspace stays suspended, and booting it from its disk, which drops the memory, is its\n  owner's to choose (StartWorkspaceRequest.from_disk).\n- `WORKSPACE_FAILURE_GUEST_PANIC`: The guest's kernel panicked, which ended its machine. The cause is inside the guest: the\n  detail quotes the console's panic line, and the console has what led to it.",
        "x-enum-descriptions": [
          "Not classified. A failure that lands here is a site missing its classification.",
          "Its disk could not be served or made: the host is not serving its volume (its refusal says\n why), or what the disk was to be made from is gone.",
          "An extension could not be attached, or the releases it starts with could not be named.",
          "The machine's network namespace or its tags could not be set up.",
          "The machine could not be given the cores or memory it was asked for.",
          "QEMU could not be prepared or did not boot.",
          "The guest booted and did not take its identity or its own filesystem.",
          "A resume needs an extension release that is no longer in the object store: the memory\n cannot be resumed anywhere, and the control plane boots the disk with the newest releases.",
          "The machine ended without being asked to, and not by a panic of its guest's kernel: its guest\n reset it, or its QEMU was killed, exited with an error or crashed. The detail says which.",
          "The machine could not be stopped or removed.",
          "Its host did not bring a start or a stop to an end before the deadline: unreachable, or its\n attempts outlasted it. The control plane's verdict (the stuck sweep), never a host's.",
          "No host could take it: none came with room while it waited, or its disk is only on a host\n that is not connected. The control plane's verdict, never a host's.",
          "Its memory was taken on a machine no host of the installation runs now: the machine's\n contract moved (a release that changed it), or the processor did. The memory resumes nowhere;\n the workspace stays suspended, and booting it from its disk, which drops the memory, is its\n owner's to choose (StartWorkspaceRequest.from_disk).",
          "The guest's kernel panicked, which ended its machine. The cause is inside the guest: the\n detail quotes the console's panic line, and the console has what led to it."
        ]
      },
      "spin.v1.WorkspaceGuest": {
        "type": "object",
        "properties": {
          "userId": {
            "type": "string",
            "title": "user_id"
          },
          "email": {
            "type": "string",
            "title": "email"
          },
          "name": {
            "type": "string",
            "title": "name"
          },
          "invitedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "invited_at"
          }
        },
        "title": "WorkspaceGuest",
        "additionalProperties": false
      },
      "spin.v1.WorkspaceHostStatus": {
        "type": "object",
        "properties": {
          "hostId": {
            "type": "string",
            "title": "host_id"
          },
          "state": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.HostState"
              }
            ],
            "title": "state"
          },
          "lastHeartbeat": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "last_heartbeat"
          },
          "hostname": {
            "type": "string",
            "title": "hostname",
            "description": "Which host it is, as a person reads it: the name its machine goes by (Host.hostname), and the\n class of the group that launched it (\"default\" for one no group launched). What its owner and\n guests are shown of the host and no more: its capacity, what else it runs and its policy are\n an administrator's (HostService)."
          },
          "hostClass": {
            "type": "string",
            "title": "host_class"
          },
          "machineType": {
            "type": "string",
            "title": "machine_type",
            "description": "The host's machine as its cloud names it, said when the host joined (Host.machine_type,\n Host.zone): what kind of machine the workspace runs on, and where. Empty for a host that\n joined with no cloud. The machine's id and whether it may be taken back stay an\n administrator's."
          },
          "zone": {
            "type": "string",
            "title": "zone"
          }
        },
        "title": "WorkspaceHostStatus",
        "additionalProperties": false,
        "description": "Whether the machine's host is reachable at all. A workspace cannot be healthier than the\n host under it, and \"my workspace is broken\" is most often this."
      },
      "spin.v1.WorkspaceLease": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "title": "name",
            "description": "name is the command, or the .spin.yaml task, that holds it."
          },
          "since": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "since"
          },
          "until": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "until",
            "description": "until is when the lease stops counting whether or not the process lives: since plus the\n installation's workspace_lease_max_minutes."
          }
        },
        "title": "WorkspaceLease",
        "additionalProperties": false,
        "description": "WorkspaceLease is a process in the workspace keeping it awake while it lives."
      },
      "spin.v1.WorkspaceLogFieldValuesRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "field": {
            "type": "string",
            "title": "field"
          },
          "query": {
            "type": "string",
            "title": "query"
          },
          "from": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "from"
          },
          "to": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "to"
          },
          "limit": {
            "type": "integer",
            "title": "limit",
            "format": "int32"
          }
        },
        "title": "WorkspaceLogFieldValuesRequest",
        "additionalProperties": false
      },
      "spin.v1.WorkspaceLogFieldValuesResponse": {
        "type": "object",
        "properties": {
          "values": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/spin.v1.FieldValue"
            },
            "title": "values"
          },
          "other": {
            "type": "string",
            "title": "other",
            "format": "int64"
          }
        },
        "title": "WorkspaceLogFieldValuesResponse",
        "additionalProperties": false
      },
      "spin.v1.WorkspaceNetworkStatus": {
        "type": "object",
        "properties": {
          "policy": {
            "type": "string",
            "title": "policy"
          },
          "declared": {
            "type": "boolean",
            "title": "declared",
            "description": "declared says a policy of this name exists: the installation's, or a team's."
          },
          "installed": {
            "type": "boolean",
            "title": "installed",
            "description": "installed says the workspace's host last reported enforcing a policy of this name. False\n for a workspace on no host."
          }
        },
        "title": "WorkspaceNetworkStatus",
        "additionalProperties": false,
        "description": "WorkspaceNetworkStatus is one policy a workspace runs under, and whether it holds there: the\n installation declares it, and the workspace's host reports having installed it. A tag no policy\n is declared for, or one its host has not installed, is what a start is refused over."
      },
      "spin.v1.WorkspacePhase": {
        "type": "string",
        "title": "WorkspacePhase",
        "enum": [
          "WORKSPACE_PHASE_UNSPECIFIED",
          "WORKSPACE_PHASE_DISK",
          "WORKSPACE_PHASE_EXTENSIONS",
          "WORKSPACE_PHASE_NETWORK",
          "WORKSPACE_PHASE_MACHINE",
          "WORKSPACE_PHASE_FIRST_BOOT",
          "WORKSPACE_PHASE_GUEST",
          "WORKSPACE_PHASE_BACKUP"
        ],
        "description": "WorkspacePhase is what a host is doing to bring a workspace up.\n\n- `WORKSPACE_PHASE_DISK`: Waiting for its disk to be served on the host.\n- `WORKSPACE_PHASE_EXTENSIONS`: Holding the extension releases it runs with.\n- `WORKSPACE_PHASE_NETWORK`: Setting up its network.\n- `WORKSPACE_PHASE_MACHINE`: Booting its machine, or resuming it from a checkpoint.\n- `WORKSPACE_PHASE_FIRST_BOOT`: Its first boot of a disk another person's workspace was cloned from.\n- `WORKSPACE_PHASE_GUEST`: The machine is up and its workspace inside is starting.\n- `WORKSPACE_PHASE_BACKUP`: Stopping on a host that can be taken away: its disk is being published before the machine\n  stops, the control plane's doing rather than the host's, and retried if it restarts.",
        "x-enum-descriptions": [
          "",
          "Waiting for its disk to be served on the host.",
          "Holding the extension releases it runs with.",
          "Setting up its network.",
          "Booting its machine, or resuming it from a checkpoint.",
          "Its first boot of a disk another person's workspace was cloned from.",
          "The machine is up and its workspace inside is starting.",
          "Stopping on a host that can be taken away: its disk is being published before the machine\n stops, the control plane's doing rather than the host's, and retried if it restarts."
        ]
      },
      "spin.v1.WorkspaceProgress": {
        "type": "object",
        "properties": {
          "attempt": {
            "type": "integer",
            "title": "attempt",
            "format": "int32",
            "description": "attempt is the host's attempt at the current generation, from 1, and attempts how many it\n makes before the workspace fails. Zero before the host has made one."
          },
          "attempts": {
            "type": "integer",
            "title": "attempts",
            "format": "int32"
          },
          "lastFailure": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.WorkspaceFailure"
              }
            ],
            "title": "last_failure",
            "description": "Why the attempt before this one failed, while this one is in progress: what a retry hides."
          },
          "lastReason": {
            "type": "string",
            "title": "last_reason"
          },
          "phase": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.WorkspacePhase"
              }
            ],
            "title": "phase",
            "description": "phase is what the host is doing now; UNSPECIFIED when it has not said."
          },
          "since": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "since",
            "description": "since is when the transition began, and deadline when the control plane gives up on it - a\n wait for a host, or a start or a stop the host does not finish - and fails the workspace."
          },
          "deadline": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "deadline"
          },
          "typical": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Duration"
              }
            ],
            "title": "typical",
            "description": "typical is how long a start usually takes on the workspace's host class: the median, from\n the request to RUNNING (the same measure as since), of the newest starts that came up there.\n Unset for a transition that is not a start, and where too few have come up to say. Per step\n it is not: what a host says of its phases is kept only while one is under way."
          }
        },
        "title": "WorkspaceProgress",
        "additionalProperties": false,
        "description": "WorkspaceProgress is a transition under way."
      },
      "spin.v1.WorkspaceProxyStatus": {
        "type": "string",
        "title": "WorkspaceProxyStatus",
        "enum": [
          "WORKSPACE_PROXY_STATUS_UNSPECIFIED",
          "WORKSPACE_PROXY_STATUS_ACCESSIBLE",
          "WORKSPACE_PROXY_STATUS_NOT_RUNNING",
          "WORKSPACE_PROXY_STATUS_NOT_FOUND",
          "WORKSPACE_PROXY_STATUS_PORT_NOT_EXPOSED",
          "WORKSPACE_PROXY_STATUS_WAKING"
        ],
        "description": "Proxy status for workspace access\n\n- `WORKSPACE_PROXY_STATUS_ACCESSIBLE`: Port exposed, workspace running\n- `WORKSPACE_PROXY_STATUS_NOT_RUNNING`: Return 503\n- `WORKSPACE_PROXY_STATUS_NOT_FOUND`: Return 404\n- `WORKSPACE_PROXY_STATUS_PORT_NOT_EXPOSED`: Return 403\n- `WORKSPACE_PROXY_STATUS_WAKING`: Not running, and woken for this caller (Workspace.wake_on_access): the proxy opens a session,\n  which resumes it and waits a while, and shows a page that asks again while it is not up.",
        "x-enum-descriptions": [
          "",
          "Port exposed, workspace running",
          "Return 503",
          "Return 404",
          "Return 403",
          "Not running, and woken for this caller (Workspace.wake_on_access): the proxy opens a session,\n which resumes it and waits a while, and shows a page that asks again while it is not up."
        ]
      },
      "spin.v1.WorkspaceRuntime": {
        "type": "object",
        "properties": {
          "cpuCores": {
            "type": "integer",
            "title": "cpu_cores",
            "format": "int32"
          },
          "memoryBytes": {
            "type": "string",
            "title": "memory_bytes",
            "format": "int64"
          },
          "memoryUsedBytes": {
            "type": "string",
            "title": "memory_used_bytes",
            "format": "int64"
          },
          "cpuSeconds": {
            "type": "number",
            "title": "cpu_seconds",
            "format": "double"
          },
          "machineStartedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "machine_started_at"
          }
        },
        "title": "WorkspaceRuntime",
        "additionalProperties": false,
        "description": "WorkspaceRuntime is a running workspace's machine as its host measures it from outside the\n guest. Answers \"is my workspace out of memory\" and \"did it get the cores it borrowed\" for the\n one person asking, which no metric may: those are labelled by host, never by workspace."
      },
      "spin.v1.WorkspaceState": {
        "type": "string",
        "title": "WorkspaceState",
        "enum": [
          "WORKSPACE_STATE_UNSPECIFIED",
          "WORKSPACE_STATE_CREATING",
          "WORKSPACE_STATE_STARTING",
          "WORKSPACE_STATE_RUNNING",
          "WORKSPACE_STATE_STOPPING",
          "WORKSPACE_STATE_STOPPED",
          "WORKSPACE_STATE_FAILED",
          "WORKSPACE_STATE_DELETED",
          "WORKSPACE_STATE_WAITING",
          "WORKSPACE_STATE_QUARANTINED",
          "WORKSPACE_STATE_DEGRADED"
        ],
        "description": "WorkspaceState is where a workspace is in its life. Each value's comment is what the API's\n document says of it (buf.gen.openapi.yaml's with-enum-value-descriptions), and the website's\n table of states is generated from it: it is written for a person reading that table, in the\n site's words (a runner, the CLI's commands). Why a value is what it is goes in a comment\n apart, above the value's own, which the document does not carry.\n\n- `WORKSPACE_STATE_UNSPECIFIED`: Never a workspace's state: a client that reads it read a field nothing set.\n- `WORKSPACE_STATE_CREATING`: The workspace exists and has not run yet.\n- `WORKSPACE_STATE_STARTING`: A runner is preparing its disk and starting its machine.\n- `WORKSPACE_STATE_RUNNING`: Its machine is up.\n- `WORKSPACE_STATE_STOPPING`: Its machine is shutting down, and then what its disk wrote since its last commit is\n  uploaded to the bucket. A stop stays here until the upload is done, and says why it is not;\n  `spin workspace stop --force` does not wait for it.\n- `WORKSPACE_STATE_STOPPED`: Not running. Its disk is kept, and the next start boots from it.\n- `WORKSPACE_STATE_FAILED`: A start or a stop failed: `spin workspace status` says which part, and why. It stays so\n  until it is started again.\n- `WORKSPACE_STATE_DELETED`: In the trash, with its disk, for the days the installation keeps it there\n  (`workspace_trash_days`): `spin workspace undelete` brings it back, stopped. An installation\n  that keeps no trash erases it at once.\n- `WORKSPACE_STATE_WAITING`: Wanted running, and no runner has room for it yet. On AWS, where runners scale to none, one\n  is being started, and the workspace starts on it once it is up.\n- `WORKSPACE_STATE_QUARANTINED`: Held by an administrator with `spin workspace quarantine`: it cannot start until\n  `spin workspace unquarantine` releases it, and its disk is kept as it was.\n- `WORKSPACE_STATE_DEGRADED`: Its machine is up, and what was asked of it inside did not finish: its project's checkout,\n  .spin.yaml or create tasks. Everything a running workspace allows is allowed; `spin workspace\n  get` says what failed, and the next boot tries again.",
        "x-enum-descriptions": [
          "Never a workspace's state: a client that reads it read a field nothing set.",
          "The workspace exists and has not run yet.",
          "A runner is preparing its disk and starting its machine.",
          "Its machine is up.",
          "Its machine is shutting down, and then what its disk wrote since its last commit is\n uploaded to the bucket. A stop stays here until the upload is done, and says why it is not;\n `spin workspace stop --force` does not wait for it.",
          "Not running. Its disk is kept, and the next start boots from it.",
          "A start or a stop failed: `spin workspace status` says which part, and why. It stays so\n until it is started again.",
          "In the trash, with its disk, for the days the installation keeps it there\n (`workspace_trash_days`): `spin workspace undelete` brings it back, stopped. An installation\n that keeps no trash erases it at once.",
          "Wanted running, and no runner has room for it yet. On AWS, where runners scale to none, one\n is being started, and the workspace starts on it once it is up.",
          "Held by an administrator with `spin workspace quarantine`: it cannot start until\n `spin workspace unquarantine` releases it, and its disk is kept as it was.",
          "Its machine is up, and what was asked of it inside did not finish: its project's checkout,\n .spin.yaml or create tasks. Everything a running workspace allows is allowed; `spin workspace\n get` says what failed, and the next boot tries again."
        ]
      },
      "spin.v1.WorkspaceSuspendFailure": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "error": {
            "type": "string",
            "title": "error"
          }
        },
        "title": "WorkspaceSuspendFailure",
        "additionalProperties": false
      },
      "spin.v1.WorkspaceVolumeStatus": {
        "type": "object",
        "properties": {
          "volumeId": {
            "type": "string",
            "title": "volume_id"
          },
          "state": {
            "type": "string",
            "title": "state"
          },
          "refusal": {
            "type": "string",
            "title": "refusal"
          },
          "refusalDetail": {
            "type": "string",
            "title": "refusal_detail"
          }
        },
        "title": "WorkspaceVolumeStatus",
        "additionalProperties": false,
        "description": "Whether the disk under the workspace is being served. `refusal` is the token an alert\n keys on; `refusal_detail` is the sentence the agent sent with it."
      },
      "spin.v1.WriteFileRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "title": "workspace_id"
          },
          "path": {
            "type": "string",
            "title": "path",
            "description": "path is absolute, or relative to root's home."
          },
          "content": {
            "type": "string",
            "title": "content",
            "format": "byte"
          }
        },
        "title": "WriteFileRequest",
        "additionalProperties": false
      },
      "spin.v1.WriteFileResponse": {
        "type": "object",
        "title": "WriteFileResponse",
        "additionalProperties": false
      },
      "spin.v1.WritebackPreset": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "title": "name",
            "description": "name is how the preset is told apart; label is how a person is shown it."
          },
          "label": {
            "type": "string",
            "title": "label"
          },
          "limitBytes": {
            "type": "string",
            "title": "limit_bytes",
            "format": "int64",
            "description": "Both zero is unset."
          },
          "backgroundBytes": {
            "type": "string",
            "title": "background_bytes",
            "format": "int64"
          },
          "measured": {
            "type": "string",
            "title": "measured",
            "description": "measured is what it did, in words."
          }
        },
        "title": "WritebackPreset",
        "additionalProperties": false,
        "description": "WritebackPreset is a pair of writeback thresholds measured on a Spin OS metal host (NVMe, a\n 4 KiB write+fsync in one workspace beside another writing 2 GiB flat out)."
      },
      "spin.v1.WritebackRun": {
        "type": "object",
        "properties": {
          "writerBytesPerSecond": {
            "type": "string",
            "title": "writer_bytes_per_second",
            "format": "int64"
          },
          "probeP50Us": {
            "type": "string",
            "title": "probe_p50_us",
            "format": "int64"
          },
          "probeP99Us": {
            "type": "string",
            "title": "probe_p99_us",
            "format": "int64"
          },
          "probeMaxUs": {
            "type": "string",
            "title": "probe_max_us",
            "format": "int64"
          },
          "probes": {
            "type": "integer",
            "title": "probes",
            "format": "int32"
          }
        },
        "title": "WritebackRun",
        "additionalProperties": false,
        "description": "WritebackRun mirrors spin.agent.v1.WritebackRun, which is what the host reports."
      },
      "spin.v1.WritebackTest": {
        "type": "object",
        "properties": {
          "hostId": {
            "type": "string",
            "title": "host_id"
          },
          "limitBytes": {
            "type": "string",
            "title": "limit_bytes",
            "format": "int64"
          },
          "backgroundBytes": {
            "type": "string",
            "title": "background_bytes",
            "format": "int64"
          },
          "candidate": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.WritebackRun"
              }
            ],
            "title": "candidate",
            "description": "candidate ran under the thresholds above, current under the ones the host held."
          },
          "current": {
            "allOf": [
              {
                "$ref": "#/components/schemas/spin.v1.WritebackRun"
              }
            ],
            "title": "current"
          },
          "testedAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "tested_at"
          },
          "expiresAt": {
            "allOf": [
              {
                "$ref": "#/components/schemas/google.protobuf.Timestamp"
              }
            ],
            "title": "expires_at"
          }
        },
        "title": "WritebackTest",
        "additionalProperties": false,
        "description": "WritebackTest is one TestHostWriteback: the thresholds tested, both runs, and until when\n SetHostPolicy takes those thresholds for that host on the strength of it."
      }
    }
  },
  "security": [],
  "tags": [
    {
      "name": "PasskeyService",
      "description": "PasskeyService is a person's passkeys: WebAuthn credentials of their account, under the\n installation's base domain (internal/passkey). A passkey signs a challenge the control plane\n issued, never a document: what turns a session into a key that logs in (SSHKeyService.AddSSHKey)\n is an assertion of one, so a session alone - stolen, or an agent's - is no shell."
    },
    {
      "name": "AuthService"
    },
    {
      "name": "WorkspaceService"
    },
    {
      "name": "SettingsService"
    },
    {
      "name": "AdminService",
      "description": "AdminService manages installation-wide settings, user management, and resource presets\n Only accessible to instance administrators --- Installation Settings ---"
    },
    {
      "name": "ExecService",
      "description": "ExecService runs commands and moves files in a running workspace, as its root, for a caller who\n is no terminal: a program or an agent holding a key with workspace:exec. The control plane logs\n in over the same session a terminal's goes over (a host's stream from the guest's vsock, met at\n the control plane rather than at the relay) with a certificate of its own for five minutes, and\n every call is recorded with who made it and on which credential (audit: workspace_exec)."
    },
    {
      "name": "ForgeService",
      "description": "ForgeService is a person's account on a forge, connected through the installation's GitHub App\n (spin#758): the control plane keeps the token, lists the person's repositories with it, and a\n host's egress proxy sets it on their workspaces' brokered requests. No workspace holds it."
    },
    {
      "name": "HostService"
    },
    {
      "name": "HostShellService",
      "description": "HostShellService is a root shell on a host, asked for by an administrator, for a while, with a\n reason (spin#712). The host is emptied of its workspaces first - unless the request is an\n incident's, which says so - and retired after, whatever happened in it: once a person has had root\n on a host it runs no workspace again. Every session is recorded by the control plane, which\n carries it; the terminal itself is a WebSocket at /api/host-shells/\u003cid\u003e/terminal\n (internal/hostshell)."
    },
    {
      "name": "LogService",
      "description": "LogService is what the installation logged, as its store of logs and traces keeps it\n (internal/logstore). Every search is confined by the control plane to what the caller may see;\n what the caller types is searched inside that and cannot widen it."
    },
    {
      "name": "ProjectService",
      "description": "ProjectService is the installation's projects (spin#720): a repository and the shape of the\n workspace that opens it (CreateWorkspaceRequest.project_id). Anybody signed in makes one where\n the installation lets everybody (the setting project_creation), and is its first admin.\n A project is seen by everybody while it is shared with everyone, and otherwise by its admins and\n whom it is shared with; the instance's admins see and administer every one. Whoever sees one\n opens workspaces from it, in a team of theirs."
    },
    {
      "name": "RunnerTokenService"
    },
    {
      "name": "SetupService",
      "description": "SetupService handles initial platform setup and admin bootstrap.\n Most endpoints require admin authentication, except GetSetupStatus and PasswordLogin."
    },
    {
      "name": "ShareService",
      "description": "ShareService manages snapshot sharing\n Snapshots can be shared with specific users or made public\n Users can create new workspaces from shared snapshots"
    },
    {
      "name": "SSHKeyService",
      "description": "SSHKeyService is the keys that log in as the person, to every workspace that lets them in: a key\n of their own, for good, or a browser's or a CLI's enrolled for twelve hours. Each is added with an\n assertion of a passkey of theirs (PasskeyService), so a session alone adds none."
    },
    {
      "name": "TeamService"
    }
  ]
}