{ "components": { "schemas": { "EscalateIn": { "properties": { "to_tier": { "pattern": "^TP[1-5]$", "title": "To Tier", "type": "string" }, "top_k": { "maximum": 100.0, "minimum": 1.0, "title": "Top K", "type": "integer" } }, "required": [ "top_k", "to_tier" ], "title": "EscalateIn", "type": "object" }, "EstimateIn": { "properties": { "caps": { "additionalProperties": { "type": "number" }, "default": {}, "description": "optional {wall_seconds, credits}: credits are US dollars", "title": "Caps", "type": "object" }, "cell_id": { "title": "Cell Id", "type": "string" }, "conditions": { "additionalProperties": true, "default": {}, "title": "Conditions", "type": "object" }, "seed": { "default": 0, "title": "Seed", "type": "integer" }, "tier": { "pattern": "^TP[1-5]$", "title": "Tier", "type": "string" }, "workspace_id": { "title": "Workspace Id", "type": "string" } }, "required": [ "workspace_id", "cell_id", "tier" ], "title": "EstimateIn", "type": "object" }, "HTTPValidationError": { "properties": { "detail": { "items": { "$ref": "#/components/schemas/ValidationError" }, "title": "Detail", "type": "array" } }, "title": "HTTPValidationError", "type": "object" }, "InviteIn": { "properties": { "code": { "maxLength": 40, "minLength": 6, "title": "Code", "type": "string" } }, "required": [ "code" ], "title": "InviteIn", "type": "object" }, "KeyIn": { "properties": { "days": { "default": 90, "title": "Days", "type": "integer" }, "scopes": { "items": { "type": "string" }, "title": "Scopes", "type": "array" }, "user_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "User Id" } }, "required": [ "scopes" ], "title": "KeyIn", "type": "object" }, "ProtocolIn": { "properties": { "conditions": { "additionalProperties": true, "title": "Conditions", "type": "object" }, "description": { "default": "", "title": "Description", "type": "string" }, "name": { "title": "Name", "type": "string" }, "shared": { "default": false, "title": "Shared", "type": "boolean" } }, "required": [ "name", "conditions" ], "title": "ProtocolIn", "type": "object" }, "SignupIn": { "properties": { "email": { "pattern": "^[^@\\s]+@[^@\\s]+$", "title": "Email", "type": "string" }, "invite_code": { "anyOf": [ { "maxLength": 40, "type": "string" }, { "type": "null" } ], "description": "Compute comes with an invite; without one the org has none", "title": "Invite Code" }, "org_name": { "maxLength": 200, "minLength": 1, "title": "Org Name", "type": "string" } }, "required": [ "org_name", "email" ], "title": "SignupIn", "type": "object" }, "SubmitIn": { "properties": { "project_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Project Id" }, "quote_id": { "title": "Quote Id", "type": "string" } }, "required": [ "quote_id" ], "title": "SubmitIn", "type": "object" }, "SweepIn": { "properties": { "axes": { "additionalProperties": { "items": {}, "type": "array" }, "description": "e.g. {\"carbon_sources.glucose\": [1, 2, 5, 10]}", "title": "Axes", "type": "object" }, "base": { "$ref": "#/components/schemas/EstimateIn" }, "name": { "default": "sweep", "title": "Name", "type": "string" }, "workspace_id": { "title": "Workspace Id", "type": "string" } }, "required": [ "workspace_id", "base", "axes" ], "title": "SweepIn", "type": "object" }, "UserIn": { "properties": { "email": { "title": "Email", "type": "string" }, "kind": { "default": "human", "pattern": "^(human|service)$", "title": "Kind", "type": "string" }, "role": { "pattern": "^(owner|admin|member|viewer)$", "title": "Role", "type": "string" } }, "required": [ "email", "role" ], "title": "UserIn", "type": "object" }, "ValidationError": { "properties": { "ctx": { "title": "Context", "type": "object" }, "input": { "title": "Input" }, "loc": { "items": { "anyOf": [ { "type": "string" }, { "type": "integer" } ] }, "title": "Location", "type": "array" }, "msg": { "title": "Message", "type": "string" }, "type": { "title": "Error Type", "type": "string" } }, "required": [ "loc", "msg", "type" ], "title": "ValidationError", "type": "object" }, "WaitlistIn": { "properties": { "affiliation": { "default": "", "maxLength": 200, "title": "Affiliation", "type": "string" }, "email": { "maxLength": 254, "pattern": "^[^@\\s]+@[^@\\s]+\\.[^@\\s]+$", "title": "Email", "type": "string" }, "name": { "default": "", "maxLength": 200, "title": "Name", "type": "string" }, "use_case": { "default": "", "maxLength": 2000, "title": "Use Case", "type": "string" } }, "required": [ "email" ], "title": "WaitlistIn", "type": "object" }, "WebhookIn": { "properties": { "url": { "title": "Url", "type": "string" } }, "required": [ "url" ], "title": "WebhookIn", "type": "object" }, "WorkspaceIn": { "properties": { "hot_retention_days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Hot Retention Days" }, "monthly_budget_credits": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Monthly Budget Credits" }, "name": { "title": "Name", "type": "string" } }, "required": [ "name" ], "title": "WorkspaceIn", "type": "object" } } }, "info": { "description": "Drylab: in-silico cell experiments with explicit validation status. Screening and triage, not a substitute for wet-lab experiments.", "title": "Drylab", "version": "1.0.0" }, "openapi": "3.1.0", "paths": { "/auth/config": { "get": { "operationId": "auth_config", "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" } }, "summary": "Which sign-in methods this deployment offers", "tags": [ "identity" ] } }, "/healthz": { "get": { "operationId": "healthz", "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" } }, "summary": "Healthz", "tags": [ "ops" ] } }, "/metrics": { "get": { "operationId": "metrics", "parameters": [ { "in": "header", "name": "x-ops-token", "required": true, "schema": { "title": "X-Ops-Token", "type": "string" } } ], "responses": { "200": { "content": { "text/plain": { "schema": { "type": "string" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Metrics", "tags": [ "ops" ] } }, "/readyz": { "get": { "operationId": "readyz", "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" } }, "summary": "Readyz", "tags": [ "ops" ] } }, "/v1/audit": { "get": { "operationId": "audit_log", "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "default": 100, "maximum": 1000, "minimum": 1, "title": "Limit", "type": "integer" } }, { "in": "query", "name": "before_id", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Before Id" } }, { "in": "query", "name": "format", "required": false, "schema": { "default": "json", "pattern": "^(json|jsonl)$", "title": "Format", "type": "string" } }, { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Tenant audit log (append-only)", "tags": [ "identity" ] } }, "/v1/capabilities": { "get": { "operationId": "capabilities", "parameters": [ { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Capability matrix: cell x tier x status", "tags": [ "registry" ] } }, "/v1/cells": { "get": { "operationId": "cells", "parameters": [ { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Cells", "tags": [ "registry" ] } }, "/v1/cells/{cell_id}/form": { "get": { "operationId": "cell_form", "parameters": [ { "in": "path", "name": "cell_id", "required": true, "schema": { "title": "Cell Id", "type": "string" } }, { "in": "query", "name": "tier", "required": false, "schema": { "default": "TP2", "title": "Tier", "type": "string" } }, { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "The knobs for a cell and tier, as a form (no JSON needed)", "tags": [ "registry" ] } }, "/v1/cells/{cell_id}/genes": { "get": { "operationId": "cell_genes", "parameters": [ { "in": "path", "name": "cell_id", "required": true, "schema": { "title": "Cell Id", "type": "string" } }, { "in": "query", "name": "tier", "required": false, "schema": { "default": "TP2", "title": "Tier", "type": "string" } }, { "in": "query", "name": "q", "required": false, "schema": { "default": "", "title": "Q", "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 20, "title": "Limit", "type": "integer" } }, { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Search a cell's genes by id or name", "tags": [ "registry" ] } }, "/v1/compare": { "get": { "operationId": "compare", "parameters": [ { "in": "query", "name": "a", "required": true, "schema": { "title": "A", "type": "string" } }, { "in": "query", "name": "b", "required": true, "schema": { "title": "B", "type": "string" } }, { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Compare", "tags": [ "runs" ] } }, "/v1/datasets": { "post": { "operationId": "dataset_upload", "parameters": [ { "in": "query", "name": "workspace_id", "required": true, "schema": { "title": "Workspace Id", "type": "string" } }, { "in": "query", "name": "name", "required": true, "schema": { "title": "Name", "type": "string" } }, { "description": "allow use for training/tuning; default never", "in": "query", "name": "training_opt_in", "required": false, "schema": { "default": false, "description": "allow use for training/tuning; default never", "title": "Training Opt In", "type": "boolean" } }, { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "responses": { "201": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Upload biological data (raw body)", "tags": [ "data" ] } }, "/v1/estimates": { "post": { "operationId": "estimate", "parameters": [ { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EstimateIn" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Estimate runtime, cost (USD) and confidence before running", "tags": [ "runs" ] } }, "/v1/invites/redeem": { "post": { "operationId": "redeem_invite", "parameters": [ { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InviteIn" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Redeem an invite code: a monthly compute allowance (USD) for your organization", "tags": [ "identity" ] } }, "/v1/keys": { "get": { "operationId": "key_list", "parameters": [ { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "API keys: your own, or the whole org for admins (never the secret)", "tags": [ "identity" ] }, "post": { "operationId": "key_issue", "parameters": [ { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/KeyIn" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Key Issue", "tags": [ "identity" ] } }, "/v1/keys/{key_id}": { "delete": { "operationId": "key_revoke", "parameters": [ { "in": "path", "name": "key_id", "required": true, "schema": { "title": "Key Id", "type": "string" } }, { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "responses": { "204": { "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Key Revoke", "tags": [ "identity" ] } }, "/v1/keys/{key_id}/rotate": { "post": { "operationId": "key_rotate", "parameters": [ { "in": "path", "name": "key_id", "required": true, "schema": { "title": "Key Id", "type": "string" } }, { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "responses": { "201": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Key Rotate", "tags": [ "identity" ] } }, "/v1/me": { "get": { "operationId": "me", "parameters": [ { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Me", "tags": [ "identity" ] } }, "/v1/models": { "get": { "operationId": "models", "parameters": [ { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Models", "tags": [ "registry" ] } }, "/v1/ops/dashboard": { "get": { "operationId": "ops_dashboard", "parameters": [ { "in": "header", "name": "x-ops-token", "required": true, "schema": { "title": "X-Ops-Token", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "What is queued, failing, costing, and who is affected (aggregates only)", "tags": [ "ops" ] } }, "/v1/protocols": { "get": { "operationId": "protocol_list", "parameters": [ { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Protocol List", "tags": [ "experiments" ] }, "post": { "operationId": "protocol_save", "parameters": [ { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProtocolIn" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Save a named, versioned condition set", "tags": [ "experiments" ] } }, "/v1/protocols/{name}/{version}": { "get": { "operationId": "protocol_get", "parameters": [ { "in": "path", "name": "name", "required": true, "schema": { "title": "Name", "type": "string" } }, { "in": "path", "name": "version", "required": true, "schema": { "title": "Version", "type": "integer" } }, { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Protocol Get", "tags": [ "experiments" ] } }, "/v1/runs": { "get": { "operationId": "list_runs", "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "maximum": 200, "minimum": 1, "title": "Limit", "type": "integer" } }, { "in": "query", "name": "before", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Before" } }, { "in": "query", "name": "workspace_id", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Workspace Id" } }, { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "List Runs", "tags": [ "runs" ] }, "post": { "operationId": "submit", "parameters": [ { "description": "seconds to wait for sync tiers", "in": "query", "name": "wait", "required": false, "schema": { "default": 0, "description": "seconds to wait for sync tiers", "maximum": 60, "minimum": 0, "title": "Wait", "type": "number" } }, { "description": "same key = same run, never charged twice", "in": "header", "name": "idempotency-key", "required": true, "schema": { "description": "same key = same run, never charged twice", "title": "Idempotency-Key", "type": "string" } }, { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SubmitIn" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Confirm a quote; queues the run", "tags": [ "runs" ] } }, "/v1/runs/{run_id}": { "get": { "operationId": "get_run", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } }, { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Run", "tags": [ "runs" ] } }, "/v1/runs/{run_id}/cancel": { "post": { "operationId": "cancel", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } }, { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Cancel", "tags": [ "runs" ] } }, "/v1/runs/{run_id}/consistency": { "get": { "operationId": "consistency", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } }, { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Cross-tier agreement on the same scenario", "tags": [ "runs" ] } }, "/v1/runs/{run_id}/escalate": { "post": { "operationId": "escalate", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } }, { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EscalateIn" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Promote top screen hits to a higher tier", "tags": [ "experiments" ] } }, "/v1/runs/{run_id}/evidence": { "get": { "operationId": "run_evidence", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } }, { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "What supports this result: reproduced by the gate, cited from a paper, or theoretical", "tags": [ "runs" ] } }, "/v1/runs/{run_id}/export": { "get": { "operationId": "export", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } }, { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "responses": { "200": { "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Zip bundle with provenance and validation caveats", "tags": [ "runs" ] } }, "/v1/runs/{run_id}/lineage": { "get": { "operationId": "lineage", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } }, { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Lineage", "tags": [ "runs" ] } }, "/v1/runs/{run_id}/notebook": { "get": { "operationId": "notebook", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } }, { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Runnable Jupyter notebook using the SDK", "tags": [ "runs" ] } }, "/v1/runs/{run_id}/reproduces/{other_id}": { "get": { "operationId": "reproduces", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } }, { "in": "path", "name": "other_id", "required": true, "schema": { "title": "Other Id", "type": "string" } }, { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Byte-level comparison of two runs' results", "tags": [ "runs" ] } }, "/v1/runs/{run_id}/rerun": { "post": { "operationId": "rerun", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } }, { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "responses": { "201": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Rerun", "tags": [ "runs" ] } }, "/v1/runs/{run_id}/result": { "get": { "operationId": "get_result", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } }, { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Result", "tags": [ "runs" ] } }, "/v1/signup": { "post": { "operationId": "signup", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SignupIn" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Open signup (only when Neon Auth is not configured)", "tags": [ "identity" ] } }, "/v1/sweeps/estimate": { "post": { "operationId": "sweep_estimate", "parameters": [ { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SweepIn" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Quote a full-factorial parameter sweep", "tags": [ "experiments" ] } }, "/v1/sweeps/{sweep_id}": { "get": { "operationId": "sweep_get", "parameters": [ { "in": "path", "name": "sweep_id", "required": true, "schema": { "title": "Sweep Id", "type": "string" } }, { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Sweep Get", "tags": [ "experiments" ] } }, "/v1/sweeps/{sweep_id}/submit": { "post": { "operationId": "sweep_submit", "parameters": [ { "in": "path", "name": "sweep_id", "required": true, "schema": { "title": "Sweep Id", "type": "string" } }, { "in": "header", "name": "idempotency-key", "required": true, "schema": { "title": "Idempotency-Key", "type": "string" } }, { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "responses": { "201": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Sweep Submit", "tags": [ "experiments" ] } }, "/v1/usage": { "get": { "operationId": "usage", "parameters": [ { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Usage", "tags": [ "billing" ] } }, "/v1/users": { "post": { "operationId": "user_add", "parameters": [ { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserIn" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Add a user or service account (admin)", "tags": [ "identity" ] } }, "/v1/validation": { "get": { "operationId": "validation", "parameters": [ { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Latest validation report (JSON)", "tags": [ "registry" ] } }, "/v1/waitlist": { "post": { "operationId": "join_waitlist", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WaitlistIn" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Join the waitlist (no account needed)", "tags": [ "identity" ] } }, "/v1/webhooks": { "get": { "operationId": "webhook_list", "parameters": [ { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Webhook List", "tags": [ "identity" ] }, "post": { "operationId": "webhook_add", "parameters": [ { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookIn" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Webhook Add", "tags": [ "identity" ] } }, "/v1/workspaces": { "get": { "operationId": "ws_list", "parameters": [ { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Ws List", "tags": [ "workspaces" ] }, "post": { "operationId": "ws_create", "parameters": [ { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WorkspaceIn" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Ws Create", "tags": [ "workspaces" ] } }, "/v1/workspaces/{ws_id}": { "patch": { "operationId": "ws_update", "parameters": [ { "in": "path", "name": "ws_id", "required": true, "schema": { "title": "Ws Id", "type": "string" } }, { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WorkspaceIn" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Change budget or retention (admin)", "tags": [ "workspaces" ] } }, "/v1/workspaces/{ws_id}/budget": { "get": { "operationId": "ws_budget", "parameters": [ { "in": "path", "name": "ws_id", "required": true, "schema": { "title": "Ws Id", "type": "string" } }, { "description": "Bearer vcl__ (scripts, SDK, CLI)", "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Bearer vcl__ (scripts, SDK, CLI)", "title": "Authorization" } } ], "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Ws Budget", "tags": [ "billing" ] } } } }