Skip to content
SHC Docs

app response models

Generated file. Do not edit by hand. Regenerate from the repo root with CGO_ENABLED=0 go run scripts/gen-response-models-md.go.

Part of the API response model reference, which explains the Response model and Origin columns. Route inventory: routes.md. Named payload structs: payload-shapes.md.

MethodPathResponse modelOrigin
GET/.well-known/cloud/v1machine-only cloud-discovery document for the request host’s registrable domain (SHC-866), read by an onboarding client that has no account yet and never by an operator, so no client method is generated. Public and unauthenticated by format, because the document has to say how to authenticate before anything can authenticate, and NOT the API envelope: a bare {version, domain, providers, services} object served as application/json with Cache-Control: no-cache. The body is rendered by the ingress reconcile, so the handler is a lookup: 404 on a cold daemon until the first sweep lands, and on any host this estate does not serveannotation
GET/.well-known/cloud/v1/ca/{file}machine-only PEM of the trust anchor a cloud-discovery device_login names (FZ-8668): the CA a joined computer pins for LDAPS, fetched by the installer before any sign-in, so no client method is generated. Public material served as application/x-pem-file; 404 for a sha no published device_login names on the request host’s registrable domainannotation
GET/.well-known/shc/v1machine-only SHC document for the request host’s registrable domain (FZ-9759, based docs/cloud-discovery.md 3.8): where the SHC app finds the Console, read before it signs in, so no client method is generated. Public and unauthenticated by format, and NOT the API envelope: a bare {console, tenant} object served as application/json with Cache-Control: no-cache, console the Console’s https origin and tenant present only when the domain’s deployments sit in one tenant. Rendered by the ingress reconcile beside the cloud-discovery document, so 404 on a cold daemon, on a headless estate and on any host this estate does not serveannotation
GET/api/healthmap[string]anyhandler
GET/api/method/shc.app.detailMethodResponse[AppDetailResponse]handler
GET/api/method/shc.app.iconcatalog icon file bytes (image/png/image/svg+xml/… per the packaged file’s extension; self-authenticating, because <img> tags fetch it; 404 when the app has no packaged icon)annotation
POST/api/method/shc.app.uploadMethodResponse[AppUpload]handler
GET/api/method/shc.cert.deliveryMethodResponse[CertDeliveryMessage]handler
GET/api/method/shc.cert.edgeMethodResponse[CertEdgeMessage]handler
POST/api/method/shc.cluster.confirm_restoreMethodResponse[any]handler
POST/api/method/shc.cluster.host_setMethodResponse[ClusterHostChange]handler
GET/api/method/shc.cluster.host_showMethodResponse[ClusterHostShowMessage]handler
GET/api/method/shc.ingress.catMethodResponse[IngressCatMessage]handler
GET/api/method/shc.ingress.lsMethodResponse[IngressLsMessage]handler
GET/api/method/shc.integration.graphMethodResponse[DocResponse[Graph]]handler
GET/api/method/shc.integration.listMethodResponse[DocResponse[[]IntegrationStateRow]]handler
POST/api/method/shc.integration.provisionMethodResponse[IntegrationProvision]handler
GET/api/method/shc.operation.listMethodResponse[OperationListMessage]handler
GET/api/method/shc.plug.listMethodResponse[DocResponse[[]PlugRow]]handler
GET/api/method/shc.socket.listMethodResponse[DocResponse[[]SocketRow]]handler
POST/api/method/shc.stack.installAsyncOperationResponsehandler
POST/api/method/shc.stack.lease_clearMethodResponse[{cleared}]handler
POST/api/method/shc.stack.lease_renewMethodResponse[leaseResponse]handler
GET/api/method/shc.stack.lease_showMethodResponse[leaseResponse]handler
POST/api/method/shc.stack.protectMethodResponse[protectResponse]handler
GET/api/method/shc.stack.protect_showMethodResponse[protectResponse]handler
POST/api/method/shc.stack.repointMethodResponse[RepointPlan]handler
GET/api/method/shc.stack.servicesMethodResponse[StackServicesResponse]handler
GET/api/method/shc.stack.statusMethodResponse[StackResponse]handler
POST/api/method/shc.stack.uninstallAsyncOperationResponsehandler
POST/api/method/shc.stack.unprotectMethodResponse[protectResponse]handler
POST/api/method/shc.stack.updateAsyncOperationResponsehandler
POST/api/method/shc.stack.update_planMethodResponse[UpdatePlan]handler
POST/api/method/shc.stack.update_rollbackMethodResponse[UpdateRollbackResult]handler
GET/api/method/shc.stack.usageMethodResponse[StackUsageResponse]handler
POST/api/method/shc.system.completeMethodResponse[SystemPlanResponse]handler
POST/api/method/shc.system.keycloak_reset_admin_passwordMethodResponse[SystemKeycloakAdminPasswordResetResult]handler
POST/api/method/shc.system.openobserve_reset_admin_passwordMethodResponse[SystemOpenObserveAdminPasswordResetResult]handler
POST/api/method/shc.system.planMethodResponse[SystemPlanResponse]handler
GET/api/method/shc.system.readyMethodResponse[{ready}]handler
GET/api/resource/AppListResponse[AppResponse]handler
GET/api/resource/App/{name}DocResponse[AppResponse]handler
GET/api/resource/DeploymentListResponse[StackResponse]handler
DELETE/api/resource/Deployment/{name}AsyncOperationResponsehandler
GET/api/resource/Deployment/{name}DocResponse[StackResponse]handler
GET/api/resource/EnvironmentListResponse[CoordinateResponse]handler
GET/api/resource/StackListResponse[CoordinateResponse]handler
GET/api/statusmap[string]anyhandler
POST/api/telemetry{ok}, the fixed literal {"ok": true} acknowledgementannotation