{"openapi":"3.1.0","info":{"title":"CloudBurrow Control API","version":"v0.3.0","description":"Inspect and manage a CloudBurrow instance on its local control port. This reference covers v0.3.0. Every admin operation requires the bearer token for that instance. Use the control address reported by cloudburrow status for a custom port. The cloudburrow diagnose CLI collects a diagnostic bundle using local files and the readiness and event endpoints below."},"servers":[{"url":"http://127.0.0.1:9000","description":"Default local control listener"}],"externalDocs":{"description":"Pinned CloudBurrow source","url":"https://github.com/cloudburrow/cloudburrow/blob/0ea25940d357e11a52853ca2d35617fc5253ffb0/docs/configuration.md#admin-api"},"tags":[{"name":"Health and metrics"},{"name":"Instance and fixtures"},{"name":"State archives"},{"name":"Fault injection"},{"name":"Local models"}],"paths":{"/healthz":{"get":{"tags":["Health and metrics"],"operationId":"getHealth","summary":"Check process liveness","description":"Returns 200 while the control server is serving.","externalDocs":{"description":"Pinned CloudBurrow source","url":"https://github.com/cloudburrow/cloudburrow/blob/0ea25940d357e11a52853ca2d35617fc5253ffb0/internal/lifecycle/control.go"},"responses":{"200":{"description":"Process is serving.","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","const":"ok"}},"required":["status"]},"example":{"status":"ok"}}}}}}},"/readyz":{"get":{"tags":["Health and metrics"],"operationId":"getReadiness","summary":"Check instance readiness","description":"Wait for 200 before using the instance. The response gives the startup status of each component.","externalDocs":{"description":"Pinned CloudBurrow source","url":"https://github.com/cloudburrow/cloudburrow/blob/0ea25940d357e11a52853ca2d35617fc5253ffb0/internal/lifecycle/control.go"},"responses":{"200":{"description":"All components are ready.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Readiness"},"example":{"ready":true,"state":"ready","components":{"cluster":true,"metadata":true}}}}},"503":{"description":"At least one component has yet to start or failed to start.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Readiness"},"example":{"ready":false,"state":"starting","components":{"cluster":false,"metadata":false}}}}}}}},"/metrics":{"get":{"tags":["Health and metrics"],"operationId":"getMetrics","summary":"Read Prometheus metrics","description":"Request counters and latency histograms are reported for enabled services with call observers. Check cloudburrow_service_measured for the current instance.","externalDocs":{"description":"Pinned CloudBurrow source","url":"https://github.com/cloudburrow/cloudburrow/blob/0ea25940d357e11a52853ca2d35617fc5253ffb0/cmd/cloudburrow/metrics.go"},"responses":{"200":{"description":"Prometheus text exposition. This sample shows two lines from a response.","content":{"text/plain":{"schema":{"type":"string"},"example":"cloudburrow_requests_total{service=\"tasks\",method=\"ListQueues\",code=\"OK\"} 1\ncloudburrow_service_measured{service=\"tasks\"} 1\n"}}}}}},"/admin/reset":{"post":{"tags":["Instance and fixtures"],"operationId":"resetState","summary":"Reset local state","description":"Deletes CloudBurrow-managed state from the selected services and clears their fault rules while keeping the cluster. Use Get instance capabilities to see which services accept a project-scoped reset. An invalid service selection is rejected before deletion begins.","externalDocs":{"description":"Pinned CloudBurrow source","url":"https://github.com/cloudburrow/cloudburrow/blob/0ea25940d357e11a52853ca2d35617fc5253ffb0/internal/admin/admin.go#L275"},"parameters":[{"name":"service","in":"query","required":false,"description":"Select named components. Repeat the parameter or pass comma-separated names. Omit it to reset all registered components.","schema":{"type":"array","items":{"type":"string"}},"example":["tasks"]},{"name":"project","in":"query","required":false,"description":"Restrict the operation to a project ID.","schema":{"type":"string"},"example":"cloudburrow"},{"name":"reseed","in":"query","required":false,"description":"Reapply matching resources from the startup seed after reset. Requires a startup seed file and cannot be combined with project.","schema":{"type":"boolean","default":false},"example":false}],"security":[{"AdminBearer":[]}],"responses":{"200":{"description":"Selected state reset.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResetResult"},"example":{"reset":["tasks"]}}}},"400":{"description":"Unknown service, unsupported project scope, or invalid reseed request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResetRefusal"}}}},"401":{"description":"The instance token is missing or invalid. The request does not change state.","headers":{"WWW-Authenticate":{"schema":{"type":"string","example":"Bearer realm=\"cloudburrow admin\""}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"A reset or reseed failed. Some state may already have been deleted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResetResult"},"example":{"reset":["tasks"],"failed":{"pubsub":"example backend error"}}}}}}}},"/admin/seed":{"post":{"tags":["Instance and fixtures"],"operationId":"seedState","summary":"Seed local resources","description":"Creates resources through the enabled services’ APIs. The server validates the full document before applying it. If a service fails during application, the error can identify the components already seeded.","externalDocs":{"description":"Pinned CloudBurrow source","url":"https://github.com/cloudburrow/cloudburrow/blob/0ea25940d357e11a52853ca2d35617fc5253ffb0/docs/seed.schema.json"},"parameters":[{"name":"ifNotExists","in":"query","required":false,"description":"Set ifNotExists on every component in the document.","schema":{"type":"boolean","default":false},"example":true}],"requestBody":{"required":true,"description":"The component names and fields depend on the running services. The pinned seed schema defines the component-specific document shapes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SeedDocument"},"example":{"components":{"tasks":{"ifNotExists":true,"queues":["projects/cloudburrow/locations/us-central1/queues/example-work"]}}}}}},"security":[{"AdminBearer":[]}],"responses":{"200":{"description":"Resources seeded.","content":{"application/json":{"schema":{"type":"object","properties":{"seeded":{"type":"array","items":{"type":"string"}}},"required":["seeded"]},"example":{"seeded":["tasks"]}}}},"400":{"description":"Invalid component or seed document.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SeedError"}}}},"401":{"description":"The instance token is missing or invalid. The request does not change state.","headers":{"WWW-Authenticate":{"schema":{"type":"string","example":"Bearer realm=\"cloudburrow admin\""}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"A resource already exists and skipping existing resources was not requested.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SeedError"}}}},"500":{"description":"A service failed while applying the seed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SeedError"}}}}}}},"/admin/events":{"get":{"tags":["Instance and fixtures"],"operationId":"listEvents","summary":"List recent local events","description":"Returns matching events from a bounded in-memory recorder, newest first. Available event kinds and detail fields depend on the service.","externalDocs":{"description":"Pinned CloudBurrow source","url":"https://github.com/cloudburrow/cloudburrow/blob/0ea25940d357e11a52853ca2d35617fc5253ffb0/internal/admin/admin.go"},"parameters":[{"name":"service","in":"query","required":false,"description":"Match a service name exactly.","schema":{"type":"string"},"example":"tasks"},{"name":"kind","in":"query","required":false,"description":"Match an event kind exactly.","schema":{"type":"string"},"example":"request"},{"name":"since","in":"query","required":false,"description":"Include only events strictly after this RFC 3339 timestamp.","schema":{"type":"string","format":"date-time"},"example":"2026-01-01T11:59:00Z"},{"name":"limit","in":"query","required":false,"description":"Maximum number of events. Zero or a negative value returns all matches still in the recorder.","schema":{"type":"integer","default":100},"example":20}],"security":[{"AdminBearer":[]}],"responses":{"200":{"description":"Matching events.","content":{"application/json":{"schema":{"type":"object","properties":{"events":{"type":"array","items":{"$ref":"#/components/schemas/Event"}},"count":{"type":"integer"}},"required":["events","count"]},"example":{"events":[{"time":"2026-01-01T12:00:00Z","service":"tasks","kind":"request","target":"ListQueues","detail":{"project":"cloudburrow","code":"OK","duration_ms":"1","transport":"grpc"}}],"count":1}}}},"400":{"description":"The limit or timestamp could not be parsed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"The instance token is missing or invalid. The request does not change state.","headers":{"WWW-Authenticate":{"schema":{"type":"string","example":"Bearer realm=\"cloudburrow admin\""}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/admin/state/export":{"post":{"tags":["State archives"],"operationId":"exportState","summary":"Export a state archive","description":"Streams the state that registered snapshot-capable services can capture. Read manifest.json for coverage and omissions. An archive can hold secret values in plaintext. Keep it private. A mid-stream failure can produce an unreadable archive.","externalDocs":{"description":"Pinned CloudBurrow source","url":"https://github.com/cloudburrow/cloudburrow/blob/0ea25940d357e11a52853ca2d35617fc5253ffb0/docs/compatibility.md#state-snapshots"},"security":[{"AdminBearer":[]}],"responses":{"200":{"description":"Gzip-compressed tar archive.","headers":{"Content-Disposition":{"schema":{"type":"string","example":"attachment; filename=\"cloudburrow-state.tar.gz\""}}},"content":{"application/gzip":{"schema":{"type":"string","format":"binary","description":"A gzip-compressed tar archive. The first entry is manifest.json."}}}},"401":{"description":"The instance token is missing or invalid. The request does not change state.","headers":{"WWW-Authenticate":{"schema":{"type":"string","example":"Bearer realm=\"cloudburrow admin\""}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/admin/state/import":{"post":{"tags":["State archives"],"operationId":"importState","summary":"Import a state archive","description":"Replaces local data in each captured service with the archive’s contents. Resources created since export can be lost. The importer checks archive format and service availability before loading. A failure during loading can leave earlier services changed.","externalDocs":{"description":"Pinned CloudBurrow source","url":"https://github.com/cloudburrow/cloudburrow/blob/0ea25940d357e11a52853ca2d35617fc5253ffb0/docs/compatibility.md#state-snapshots"},"requestBody":{"required":true,"description":"Use an archive produced by the export operation.","content":{"application/gzip":{"schema":{"type":"string","format":"binary","description":"A gzip-compressed tar archive. The first entry is manifest.json."}}}},"security":[{"AdminBearer":[]}],"responses":{"200":{"description":"Captured state loaded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StateImportResult"},"example":{"loaded":["tasks"],"not_captured":[{"name":"run","captured":false,"reason":"redeploy services from their images"}]}}}},"400":{"description":"Invalid archive, incompatible version, or a captured service is missing. Nothing was loaded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"The instance token is missing or invalid. The request does not change state.","headers":{"WWW-Authenticate":{"schema":{"type":"string","example":"Bearer realm=\"cloudburrow admin\""}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Could not prepare or apply the archive. The loaded list reports earlier changes when present.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StateImportError"}}}}}}},"/admin/faults":{"post":{"tags":["Fault injection"],"operationId":"createFault","summary":"Add a fault rule","description":"Changes how matching calls behave on this local instance. If neither a status nor a delay is supplied, matching calls fail with UNAVAILABLE. Use a count to bound the effect.","externalDocs":{"description":"Pinned CloudBurrow source","url":"https://github.com/cloudburrow/cloudburrow/blob/0ea25940d357e11a52853ca2d35617fc5253ffb0/docs/compatibility.md#fault-injection--adminfaults"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FaultInput"},"example":{"service":"tasks","method":"GetQueue","project":"cloudburrow","code":"UNAVAILABLE","count":2}}}},"security":[{"AdminBearer":[]}],"responses":{"201":{"description":"Rule installed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FaultRule"},"example":{"id":"fault-1","service":"tasks","method":"GetQueue","project":"cloudburrow","code":"UNAVAILABLE","count":2,"probability":1,"remaining":2,"injected":0}}}},"400":{"description":"Malformed rule, invalid fault settings, or a service the instance cannot interpose.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"The instance token is missing or invalid. The request does not change state.","headers":{"WWW-Authenticate":{"schema":{"type":"string","example":"Bearer realm=\"cloudburrow admin\""}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"get":{"tags":["Fault injection"],"operationId":"listFaults","summary":"List fault rules","description":"Lists rules with injection counters, eligible services, refusal reasons, and accepted gRPC codes and HTTP statuses.","externalDocs":{"description":"Pinned CloudBurrow source","url":"https://github.com/cloudburrow/cloudburrow/blob/0ea25940d357e11a52853ca2d35617fc5253ffb0/docs/compatibility.md#fault-injection--adminfaults"},"security":[{"AdminBearer":[]}],"responses":{"200":{"description":"Current fault rules and the instance’s fault injection options.","content":{"application/json":{"schema":{"type":"object","properties":{"faults":{"type":"array","items":{"$ref":"#/components/schemas/FaultRule"}},"interposed":{"type":"array","items":{"type":"string"}},"refused":{"type":"array","items":{"type":"object","properties":{"service":{"type":"string"},"reason":{"type":"string"}},"required":["service","reason"]}},"codes":{"type":"array","items":{"type":"string"}},"httpStatuses":{"type":"array","items":{"type":"integer"}}},"required":["faults","interposed","refused","codes","httpStatuses"]},"example":{"faults":[{"id":"fault-1","service":"tasks","method":"GetQueue","project":"cloudburrow","code":"UNAVAILABLE","count":2,"probability":1,"remaining":2,"injected":0}],"interposed":["tasks"],"refused":[],"codes":["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"],"httpStatuses":[400,401,403,404,409,429,499,500,501,503,504]}}}},"401":{"description":"The instance token is missing or invalid. The request does not change state.","headers":{"WWW-Authenticate":{"schema":{"type":"string","example":"Bearer realm=\"cloudburrow admin\""}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Fault injection"],"operationId":"deleteFaults","summary":"Remove fault rules","description":"Delete one rule by ID. Omitting the ID removes all rules from this local instance.","externalDocs":{"description":"Pinned CloudBurrow source","url":"https://github.com/cloudburrow/cloudburrow/blob/0ea25940d357e11a52853ca2d35617fc5253ffb0/docs/compatibility.md#fault-injection--adminfaults"},"parameters":[{"name":"id","in":"query","required":false,"description":"Rule ID returned when it was added.","schema":{"type":"string"},"example":"fault-1"}],"security":[{"AdminBearer":[]}],"responses":{"200":{"description":"Number of rules deleted.","content":{"application/json":{"schema":{"type":"object","properties":{"deleted":{"type":"integer"}},"required":["deleted"]},"example":{"deleted":1}}}},"401":{"description":"The instance token is missing or invalid. The request does not change state.","headers":{"WWW-Authenticate":{"schema":{"type":"string","example":"Bearer realm=\"cloudburrow admin\""}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No rule has that ID.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/admin/instance":{"get":{"tags":["Instance and fixtures"],"operationId":"getInstance","summary":"Get instance capabilities","description":"See which components can reset, seed, or export state. The byProject flag says whether reset can be limited to one project. Reseed lists the components in the startup seed, if configured.","externalDocs":{"description":"Pinned CloudBurrow source","url":"https://github.com/cloudburrow/cloudburrow/blob/0ea25940d357e11a52853ca2d35617fc5253ffb0/internal/admin/instance.go"},"security":[{"AdminBearer":[]}],"responses":{"200":{"description":"Supported operations for this instance.","content":{"application/json":{"schema":{"type":"object","properties":{"reset":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"byProject":{"type":"boolean"}},"required":["name","byProject"]}},"reseed":{"type":"array","items":{"type":"string"}},"seed":{"type":"array","items":{"type":"string"}},"state":{"$ref":"#/components/schemas/Manifest"}},"required":["reset","reseed","seed","state"]},"example":{"reset":[{"name":"tasks","byProject":true}],"reseed":[],"seed":["tasks"],"state":{"format":"cloudburrow-state","version":1,"created":"2026-01-01T12:00:00Z","contains_secret_values":false,"services":[{"name":"tasks","captured":true}]}}}}},"401":{"description":"The instance token is missing or invalid. The request does not change state.","headers":{"WWW-Authenticate":{"schema":{"type":"string","example":"Bearer realm=\"cloudburrow admin\""}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/admin/purge":{"post":{"tags":["Instance and fixtures"],"operationId":"purgeProject","summary":"Purge a deleted project","description":"Permanently deletes a project pending deletion and clears its data from services that can reset by project. The project ID becomes reusable and its project number is retired.","externalDocs":{"description":"Pinned CloudBurrow source","url":"https://github.com/cloudburrow/cloudburrow/blob/0ea25940d357e11a52853ca2d35617fc5253ffb0/internal/admin/purge.go"},"parameters":[{"name":"project","in":"query","required":true,"description":"ID of the project pending deletion.","schema":{"type":"string"},"example":"example-project"}],"security":[{"AdminBearer":[]}],"responses":{"200":{"description":"Project purged.","content":{"application/json":{"schema":{"type":"object","properties":{"purged":{"type":"string"}},"required":["purged"]},"example":{"purged":"example-project"}}}},"400":{"description":"The project is missing from the request or is not pending deletion.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"The instance token is missing or invalid. The request does not change state.","headers":{"WWW-Authenticate":{"schema":{"type":"string","example":"Bearer realm=\"cloudburrow admin\""}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Project not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"The purge failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"This instance has no project registry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/admin/local-models":{"get":{"tags":["Local models"],"operationId":"listLocalModels","summary":"List local model states","description":"Lists the available model actions and each catalog entry’s download and load state. Pinned entries also report the exact byte size and cache verification details.","externalDocs":{"description":"Pinned CloudBurrow source","url":"https://github.com/cloudburrow/cloudburrow/blob/0ea25940d357e11a52853ca2d35617fc5253ffb0/internal/admin/localmodels.go"},"security":[{"AdminBearer":[]}],"responses":{"200":{"description":"Local model states and available actions.","content":{"application/json":{"schema":{"type":"object","properties":{"models":{"type":"array","items":{"$ref":"#/components/schemas/ModelState"}},"actions":{"type":"array","items":{"type":"string","enum":["download","cancel","load","unload","delete"]}}},"required":["models","actions"]},"example":{"models":[{"id":"embeddinggemma-300m-onnx-community","repo":"onnx-community/embeddinggemma-300m-ONNX","publisher":"community","official":false,"access":"open","license":"gemma","modality":"embedding","notes":"Community ONNX conversion under Gemma terms.","pinned":true,"revision":"5090578d9565bb06545b4552f76e6bc2c93e4a66","bytes":329781810,"files":[{"path":"onnx/model_quantized.onnx","bytes":567874,"sha256":"172efde319fe1542dc41f31be6154910b05b78f7a861c265c4600eec906bd6d8","present":true,"verified":true},{"path":"onnx/model_quantized.onnx_data","bytes":308890624,"sha256":"705626e28e4c23c82ade34566b4197d97f534c12275fa406dfb71e9937d388c0","present":false,"verified":false},{"path":"tokenizer.json","bytes":20323312,"sha256":"4dda02faaf32bc91031dc8c88457ac272b00c1016cc679757d1c441b248b9c47","present":false,"verified":false}],"state":"partial","downloaded":567874,"loadable":true,"loaded":false},{"id":"gemma-3n-e2b-it","repo":"google/gemma-3n-E2B-it-litert-lm","publisher":"google","official":false,"access":"gated","license":"gemma","modality":"text-generation","notes":"Published by the verified Google organisation. Requires accepting the Gemma licence.","pinned":false,"state":"not-pinned","downloaded":0,"loadable":false,"loaded":false}],"actions":["download","cancel","load","unload","delete"]}}}},"401":{"description":"The instance token is missing or invalid. The request does not change state.","headers":{"WWW-Authenticate":{"schema":{"type":"string","example":"Bearer realm=\"cloudburrow admin\""}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Local model management is unavailable on this instance.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/admin/local-models/{id}/{action}":{"post":{"tags":["Local models"],"operationId":"applyLocalModelAction","summary":"Run a local model action","description":"Downloads, cancels, loads, unloads, or deletes a model in this instance’s local model manager. Download requires the exact pinned byte count reported by List local model states. Delete removes the cached model files. Check the returned state to see whether the action has finished. Cancel stops an active download and retains verified files.","externalDocs":{"description":"Pinned CloudBurrow source","url":"https://github.com/cloudburrow/cloudburrow/blob/0ea25940d357e11a52853ca2d35617fc5253ffb0/internal/localai/http.go"},"parameters":[{"name":"id","in":"path","required":true,"description":"Catalog ID returned by List local model states.","schema":{"type":"string"},"example":"embeddinggemma-300m-onnx-community"},{"name":"action","in":"path","required":true,"description":"Action to apply.","schema":{"type":"string","enum":["download","cancel","load","unload","delete"]},"example":"cancel"}],"requestBody":{"required":false,"description":"For download only, send the exact positive bytes value from the current catalog entry.","content":{"application/json":{"schema":{"type":"object","properties":{"confirmBytes":{"type":"integer","format":"int64","minimum":1}},"required":["confirmBytes"]}}}},"security":[{"AdminBearer":[]}],"responses":{"200":{"description":"Model state after the request, or the ID if the state is no longer listed.","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ModelState"},{"type":"object","properties":{"id":{"type":"string"}},"required":["id"]}]},"example":{"id":"embeddinggemma-300m-onnx-community","repo":"onnx-community/embeddinggemma-300m-ONNX","publisher":"community","official":false,"access":"open","license":"gemma","modality":"embedding","notes":"Community ONNX conversion under Gemma terms.","pinned":true,"revision":"5090578d9565bb06545b4552f76e6bc2c93e4a66","bytes":329781810,"files":[{"path":"onnx/model_quantized.onnx","bytes":567874,"sha256":"172efde319fe1542dc41f31be6154910b05b78f7a861c265c4600eec906bd6d8","present":true,"verified":true},{"path":"onnx/model_quantized.onnx_data","bytes":308890624,"sha256":"705626e28e4c23c82ade34566b4197d97f534c12275fa406dfb71e9937d388c0","present":false,"verified":false},{"path":"tokenizer.json","bytes":20323312,"sha256":"4dda02faaf32bc91031dc8c88457ac272b00c1016cc679757d1c441b248b9c47","present":false,"verified":false}],"state":"partial","downloaded":567874,"loadable":true,"loaded":false}}}},"400":{"description":"The download size is missing or does not match the pinned size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"The instance token is missing or invalid. The request does not change state.","headers":{"WWW-Authenticate":{"schema":{"type":"string","example":"Bearer realm=\"cloudburrow admin\""}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Model management is unavailable, the model ID is unknown, or the action is unknown.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"The model manager is busy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"412":{"description":"The model’s pin, license access, cache, runtime, or file verification does not permit the action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"The action failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Error":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]},"Readiness":{"type":"object","properties":{"ready":{"type":"boolean"},"state":{"type":"string","enum":["new","starting","ready","stopping","stopped","failed","unknown"]},"components":{"type":"object","additionalProperties":{"type":"boolean"}},"timing":{"type":"object","additionalProperties":{"type":"object","properties":{"started_at":{"type":"string","format":"date-time"},"ready_after_ms":{"type":"integer"}},"required":["started_at","ready_after_ms"]}},"error":{"type":"string"}},"required":["ready","state","components"]},"ResetResult":{"type":"object","properties":{"reset":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"failed":{"type":"object","additionalProperties":{"type":"string"}},"reseeded":{"type":"array","items":{"type":"string"}}},"required":["reset"]},"ResetRefusal":{"type":"object","properties":{"error":{"type":"string"},"unknown":{"type":"array","items":{"type":"string"}},"known":{"type":"array","items":{"type":"string"}},"cannot_scope_by_project":{"type":"array","items":{"type":"string"}}},"required":["error"]},"SeedDocument":{"type":"object","properties":{"components":{"type":"object","additionalProperties":{"type":"object","description":"Component-specific fixture fields. See the pinned seed schema."},"properties":{"tasks":{"type":"object","properties":{"ifNotExists":{"type":"boolean","default":false},"queues":{"type":"array","items":{"type":"string","pattern":"^projects/[^/]+/locations/[^/]+/queues/[^/]+$"}}},"additionalProperties":false}}}},"required":["components"]},"SeedError":{"type":"object","properties":{"error":{"type":"string"},"component":{"type":"string"},"seeded":{"type":"array","items":{"type":"string"}}},"required":["error"]},"Event":{"type":"object","properties":{"time":{"type":"string","format":"date-time"},"service":{"type":"string"},"kind":{"type":"string"},"target":{"type":"string"},"detail":{"type":"object","additionalProperties":{"type":"string"}}},"required":["time","service","kind","target"]},"ManifestService":{"type":"object","properties":{"name":{"type":"string"},"captured":{"type":"boolean"},"reason":{"type":"string"}},"required":["name","captured"]},"Manifest":{"type":"object","properties":{"format":{"type":"string","const":"cloudburrow-state"},"version":{"type":"integer","const":1},"producer":{"type":"string"},"instance":{"type":"string"},"created":{"type":"string","format":"date-time"},"contains_secret_values":{"type":"boolean"},"services":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/ManifestService"}},{"type":"null"}]}},"required":["format","version","created","contains_secret_values","services"]},"StateImportResult":{"type":"object","properties":{"loaded":{"type":"array","items":{"type":"string"}},"not_captured":{"type":"array","items":{"$ref":"#/components/schemas/ManifestService"}}},"required":["loaded"]},"StateImportError":{"type":"object","properties":{"error":{"type":"string"},"loaded":{"type":"array","items":{"type":"string"}}},"required":["error"]},"FaultInput":{"type":"object","properties":{"service":{"type":"string","description":"An enabled service listed in interposed by List fault rules."},"method":{"type":"string","default":"*","description":"A glob over method names."},"project":{"type":"string","description":"Apply only to calls for this project."},"probability":{"type":"number","minimum":0,"maximum":1,"default":1,"description":"Probability of a matching call being faulted. The server treats zero as one."},"code":{"type":"string","description":"A gRPC error name such as UNAVAILABLE. Provide this or httpStatus."},"httpStatus":{"type":"integer","enum":[400,401,403,404,409,429,499,500,501,503,504],"description":"HTTP status with a mapped gRPC code. Provide this or code."},"latencyMs":{"type":"integer","minimum":0,"maximum":600000,"description":"Delay in milliseconds. Set a delay alone to leave the status unchanged."},"count":{"type":"integer","minimum":0,"default":0,"description":"Maximum number of injected faults. Zero leaves the rule active without a count limit."},"seed":{"type":"integer","format":"int64","description":"Optional random seed for repeatable probabilistic tests."}},"required":["service"],"additionalProperties":false,"not":{"required":["code","httpStatus"]}},"FaultRule":{"type":"object","properties":{"id":{"type":"string"},"service":{"type":"string","description":"An enabled service listed in interposed by List fault rules."},"method":{"type":"string","default":"*","description":"A glob over method names."},"project":{"type":"string","description":"Apply only to calls for this project."},"probability":{"type":"number","minimum":0,"maximum":1,"default":1,"description":"Probability of a matching call being faulted. The server treats zero as one."},"code":{"type":"string","description":"A gRPC error name such as UNAVAILABLE. Provide this or httpStatus."},"httpStatus":{"type":"integer","enum":[400,401,403,404,409,429,499,500,501,503,504],"description":"HTTP status with a mapped gRPC code. Provide this or code."},"latencyMs":{"type":"integer","minimum":0,"maximum":600000,"description":"Delay in milliseconds. Set a delay alone to leave the status unchanged."},"count":{"type":"integer","minimum":0,"default":0,"description":"Maximum number of injected faults. Zero leaves the rule active without a count limit."},"seed":{"type":"integer","format":"int64","description":"Optional random seed for repeatable probabilistic tests."},"remaining":{"type":"integer"},"injected":{"type":"integer"}},"required":["id","service","injected"]},"ModelFile":{"type":"object","properties":{"path":{"type":"string"},"bytes":{"type":"integer","format":"int64"},"sha256":{"type":"string"},"present":{"type":"boolean"},"verified":{"type":"boolean"}},"required":["path","bytes","sha256","present","verified"]},"ModelState":{"type":"object","properties":{"id":{"type":"string"},"repo":{"type":"string"},"publisher":{"type":"string"},"official":{"type":"boolean"},"access":{"type":"string"},"license":{"type":"string"},"modality":{"type":"string"},"notes":{"type":"string"},"pinned":{"type":"boolean"},"revision":{"type":"string"},"bytes":{"type":"integer","format":"int64"},"files":{"type":"array","items":{"$ref":"#/components/schemas/ModelFile"}},"state":{"type":"string","enum":["not-pinned","absent","partial","corrupt","downloading","downloaded"]},"downloaded":{"type":"integer","format":"int64"},"error":{"type":"string"},"downloadNote":{"type":"string"},"loadable":{"type":"boolean"},"loadNote":{"type":"string"},"loaded":{"type":"boolean"}},"required":["id","repo","publisher","official","access","license","modality","notes","pinned","state","downloaded","loadable","loaded"]}},"securitySchemes":{"AdminBearer":{"type":"http","scheme":"bearer","description":"Read the owner-only admin-token file in the running instance’s state directory. This token is specific to that instance."}}},"x-cloudburrow":{"ref":"release","sha":"0ea25940d357e11a52853ca2d35617fc5253ffb0"}}