@selvajs/selva 4.20.0-beta.1 → 4.20.0-beta.11

package/build/server/chunks/entries/endpoints/auth/supabase/callback/_server.ts.js-DtDsKTcy.js

@@ -0,0 +1,61 @@
+import { a as getAuthProvider } from '../../../../../chunks/providers.server.js-CzinZrUx.js';
+import { A as ApiErrorCode } from '../../../../../chunks/access.js-BataxwA1.js';
+import { a as apiError } from '../../../../../chunks/api-errors.js-Byluujl8.js';
+import { s as safeRedirectTarget } from '../../../../../chunks/redirect.js-2M2qGbv2.js';
+import { s as setSessionCookie, a as setRefreshCookie } from '../../../../../chunks/admin-auth.server.js-BtJ_IOxF.js';
+import { b as bootstrapUserSession } from '../../../../../chunks/auth-bootstrap.server.js-CYsctN6Z.js';
+import { c as consumeOAuthState } from '../../../../../chunks/oauthState.server.js-BVkqxviq.js';
+import { redirect } from '@sveltejs/kit';
+import '../../../../../chunks/shared-server.js-BGs15m2r.js';
+import '../../../../../chunks/src.js-CkFJvvTE.js';
+import 'zod';
+import '../../../../../chunks/definitions.js-NVX3pi7y.js';
+import '../../../../../chunks/schema-extraction.js-DkKllia4.js';
+import '../../../../../chunks/grasshopper.js-julMp0aw.js';
+import '../../../../../chunks/schema.js-7vN0UnrG.js';
+import 'node:crypto';
+import '../../../../../chunks/compute.js-Bb_Yprms.js';
+import 'node:dns/promises';
+import 'node:net';
+import 'node:url';
+import 'node:path';
+import 'node:fs';
+import 'node:fs/promises';
+import '@supabase/supabase-js';
+import '../../../../../chunks/api.js-BvSDWhma.js';
+import '../../../../../chunks/rate-limit.js-Br3luBbc.js';
+import '../../../../../chunks/api-token-codec.js-DtGv_8ta.js';
+import '../../../../../chunks/token-codec.js-CxK2DiO-.js';
+import 'node:zlib';
+import '../../../../../chunks/tokens.js-D5GADjWd.js';
+import '../../../../../chunks/visibility.js-CmBHwx8m.js';
+import '../../../../../chunks/request-context.js-B7sipZtt.js';
+
+//#region src/routes/auth/supabase/callback/+server.ts
+/**
+* GET /auth/supabase/callback?code=...&redirectTo=/library
+*
+* Completes a Supabase OAuth round-trip. Exchanges the authorization code
+* for a session, sets the session cookie, and redirects to `redirectTo`.
+*
+* Post-verification flow (data-row seeding + first-admin bootstrap) lives in
+* `bootstrapUserSession` so the email-link and OAuth paths follow the same
+* sequence in the same order.
+*/
+var GET = async ({ url, cookies }) => {
+	if (!consumeOAuthState(cookies, url.searchParams.get("selva_state"))) apiError(400, ApiErrorCode.VALIDATION_FAILED, "Sign-in session expired. Please try again.");
+	const code = url.searchParams.get("code");
+	if (!code) apiError(400, ApiErrorCode.VALIDATION_FAILED, "Missing authorization code");
+	const oauth = getAuthProvider().oauth;
+	if (!oauth) apiError(501, ApiErrorCode.INTERNAL, "OAuth is not supported by the configured auth provider.");
+	const result = await oauth.exchangeOAuthCode(code);
+	if (!result) apiError(401, ApiErrorCode.UNAUTHORIZED, "OAuth exchange failed");
+	await bootstrapUserSession(result.user);
+	setSessionCookie(cookies, result.sessionToken);
+	setRefreshCookie(cookies, result.refreshToken);
+	const dest = safeRedirectTarget(url.searchParams.get("redirectTo"), "/library");
+	redirect(303, dest);
+};
+
+export { GET };
+//# sourceMappingURL=_server.ts.js-DtDsKTcy.js.map

package/build/server/chunks/entries/endpoints/auth/supabase/callback/_server.ts.js-DtDsKTcy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_server.ts.js-DtDsKTcy.js","sources":["../../../../../../../../.svelte-kit/output/server/entries/endpoints/auth/supabase/callback/_server.ts.js"],"sourcesContent":["import { r as getAuthProvider } from \"../../../../../chunks/providers.server.js\";\nimport { O as ApiErrorCode } from \"../../../../../chunks/access.js\";\nimport { t as apiError } from \"../../../../../chunks/api-errors.js\";\nimport { t as safeRedirectTarget } from \"../../../../../chunks/redirect.js\";\nimport { l as setRefreshCookie, u as setSessionCookie } from \"../../../../../chunks/admin-auth.server.js\";\nimport { t as bootstrapUserSession } from \"../../../../../chunks/auth-bootstrap.server.js\";\nimport { t as consumeOAuthState } from \"../../../../../chunks/oauthState.server.js\";\nimport { redirect } from \"@sveltejs/kit\";\n//#region src/routes/auth/supabase/callback/+server.ts\n/**\n* GET /auth/supabase/callback?code=...&redirectTo=/library\n*\n* Completes a Supabase OAuth round-trip. Exchanges the authorization code\n* for a session, sets the session cookie, and redirects to `redirectTo`.\n*\n* Post-verification flow (data-row seeding + first-admin bootstrap) lives in\n* `bootstrapUserSession` so the email-link and OAuth paths follow the same\n* sequence in the same order.\n*/\nvar GET = async ({ url, cookies }) => {\n\tif (!consumeOAuthState(cookies, url.searchParams.get(\"selva_state\"))) apiError(400, ApiErrorCode.VALIDATION_FAILED, \"Sign-in session expired. Please try again.\");\n\tconst code = url.searchParams.get(\"code\");\n\tif (!code) apiError(400, ApiErrorCode.VALIDATION_FAILED, \"Missing authorization code\");\n\tconst oauth = getAuthProvider().oauth;\n\tif (!oauth) apiError(501, ApiErrorCode.INTERNAL, \"OAuth is not supported by the configured auth provider.\");\n\tconst result = await oauth.exchangeOAuthCode(code);\n\tif (!result) apiError(401, ApiErrorCode.UNAUTHORIZED, \"OAuth exchange failed\");\n\tawait bootstrapUserSession(result.user);\n\tsetSessionCookie(cookies, result.sessionToken);\n\tsetRefreshCookie(cookies, result.refreshToken);\n\tconst dest = safeRedirectTarget(url.searchParams.get(\"redirectTo\"), \"/library\");\n\tredirect(303, dest);\n};\n//#endregion\nexport { GET };\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACG,IAAC,GAAG,GAAG,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK;AACtC,CAAC,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC,iBAAiB,EAAE,4CAA4C,CAAC;AAClK,CAAC,MAAM,IAAI,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC;AAC1C,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC,iBAAiB,EAAE,4BAA4B,CAAC;AACvF,CAAC,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC,KAAK;AACtC,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC,QAAQ,EAAE,yDAAyD,CAAC;AAC5G,CAAC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC;AACnD,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC,YAAY,EAAE,uBAAuB,CAAC;AAC/E,CAAC,MAAM,oBAAoB,CAAC,MAAM,CAAC,IAAI,CAAC;AACxC,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,YAAY,CAAC;AAC/C,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,YAAY,CAAC;AAC/C,CAAC,MAAM,IAAI,GAAG,kBAAkB,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,UAAU,CAAC;AAChF,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;AACpB;;;;"}

package/build/server/chunks/entries/endpoints/auth/supabase/start/_server.ts.js-D5HHzmYM.js

@@ -0,0 +1,66 @@
+import { a as getAuthProvider } from '../../../../../chunks/providers.server.js-CzinZrUx.js';
+import { A as ApiErrorCode } from '../../../../../chunks/access.js-BataxwA1.js';
+import { a as apiError } from '../../../../../chunks/api-errors.js-Byluujl8.js';
+import { i as issueOAuthState } from '../../../../../chunks/oauthState.server.js-BVkqxviq.js';
+import { redirect } from '@sveltejs/kit';
+import '../../../../../chunks/shared-server.js-BGs15m2r.js';
+import '../../../../../chunks/src.js-CkFJvvTE.js';
+import 'zod';
+import '../../../../../chunks/definitions.js-NVX3pi7y.js';
+import '../../../../../chunks/schema-extraction.js-DkKllia4.js';
+import '../../../../../chunks/grasshopper.js-julMp0aw.js';
+import '../../../../../chunks/schema.js-7vN0UnrG.js';
+import 'node:crypto';
+import '../../../../../chunks/compute.js-Bb_Yprms.js';
+import 'node:dns/promises';
+import 'node:net';
+import 'node:url';
+import 'node:path';
+import 'node:fs';
+import 'node:fs/promises';
+import '@supabase/supabase-js';
+import '../../../../../chunks/api.js-BvSDWhma.js';
+import '../../../../../chunks/rate-limit.js-Br3luBbc.js';
+
+//#region src/routes/auth/supabase/start/+server.ts
+var ALLOWED_PROVIDERS = [
+	"google",
+	"github",
+	"azure",
+	"gitlab"
+];
+function isAllowedProvider(value) {
+	return value !== null && ALLOWED_PROVIDERS.includes(value);
+}
+/**
+* GET /auth/supabase/start?provider=google&redirectTo=/library
+*
+* Initiates an OAuth sign-in via Supabase Auth. The Supabase project must
+* have the named provider enabled in its dashboard. Bounces the browser to
+* the IdP's authorize endpoint; the IdP returns to `/auth/supabase/callback`
+* with a `?code=...`.
+*
+* `redirectTo` is preserved through the round trip via `?redirectTo=...` on
+* the callback URL we hand to Supabase.
+*
+* A CSRF nonce rides along the same way. Supabase owns the real OAuth `state`
+* and doesn't expose it, and `exchangeOAuthCode` takes only `code` — so the
+* nonce is our own, carried on the callback URL and compared against a cookie.
+* Without it the callback accepts an attacker's `?code=` and silently signs the
+* victim into the attacker's account. See `oauthState.server.ts`.
+*/
+var GET = async ({ url, cookies }) => {
+	const provider = url.searchParams.get("provider");
+	if (!isAllowedProvider(provider)) apiError(400, ApiErrorCode.VALIDATION_FAILED, `Invalid provider. Allowed: ${ALLOWED_PROVIDERS.join(", ")}`);
+	const oauth = getAuthProvider().oauth;
+	if (!oauth) apiError(501, ApiErrorCode.INTERNAL, "OAuth is not supported by the configured auth provider.");
+	const redirectTo = url.searchParams.get("redirectTo") ?? "/library";
+	const callbackUrl = new URL("/auth/supabase/callback", url.origin);
+	if (redirectTo.startsWith("/")) callbackUrl.searchParams.set("redirectTo", redirectTo);
+	callbackUrl.searchParams.set("selva_state", issueOAuthState(cookies));
+	const authorizationUrl = await oauth.getOAuthAuthorizationUrl(provider, callbackUrl.toString());
+	redirect(303, authorizationUrl);
+};
+
+export { GET };
+//# sourceMappingURL=_server.ts.js-D5HHzmYM.js.map

package/build/server/chunks/entries/endpoints/auth/supabase/start/_server.ts.js-D5HHzmYM.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_server.ts.js-D5HHzmYM.js","sources":["../../../../../../../../.svelte-kit/output/server/entries/endpoints/auth/supabase/start/_server.ts.js"],"sourcesContent":["import { r as getAuthProvider } from \"../../../../../chunks/providers.server.js\";\nimport { O as ApiErrorCode } from \"../../../../../chunks/access.js\";\nimport { t as apiError } from \"../../../../../chunks/api-errors.js\";\nimport { n as issueOAuthState } from \"../../../../../chunks/oauthState.server.js\";\nimport { redirect } from \"@sveltejs/kit\";\n//#region src/routes/auth/supabase/start/+server.ts\nvar ALLOWED_PROVIDERS = [\n\t\"google\",\n\t\"github\",\n\t\"azure\",\n\t\"gitlab\"\n];\nfunction isAllowedProvider(value) {\n\treturn value !== null && ALLOWED_PROVIDERS.includes(value);\n}\n/**\n* GET /auth/supabase/start?provider=google&redirectTo=/library\n*\n* Initiates an OAuth sign-in via Supabase Auth. The Supabase project must\n* have the named provider enabled in its dashboard. Bounces the browser to\n* the IdP's authorize endpoint; the IdP returns to `/auth/supabase/callback`\n* with a `?code=...`.\n*\n* `redirectTo` is preserved through the round trip via `?redirectTo=...` on\n* the callback URL we hand to Supabase.\n*\n* A CSRF nonce rides along the same way. Supabase owns the real OAuth `state`\n* and doesn't expose it, and `exchangeOAuthCode` takes only `code` — so the\n* nonce is our own, carried on the callback URL and compared against a cookie.\n* Without it the callback accepts an attacker's `?code=` and silently signs the\n* victim into the attacker's account. See `oauthState.server.ts`.\n*/\nvar GET = async ({ url, cookies }) => {\n\tconst provider = url.searchParams.get(\"provider\");\n\tif (!isAllowedProvider(provider)) apiError(400, ApiErrorCode.VALIDATION_FAILED, `Invalid provider. Allowed: ${ALLOWED_PROVIDERS.join(\", \")}`);\n\tconst oauth = getAuthProvider().oauth;\n\tif (!oauth) apiError(501, ApiErrorCode.INTERNAL, \"OAuth is not supported by the configured auth provider.\");\n\tconst redirectTo = url.searchParams.get(\"redirectTo\") ?? \"/library\";\n\tconst callbackUrl = new URL(\"/auth/supabase/callback\", url.origin);\n\tif (redirectTo.startsWith(\"/\")) callbackUrl.searchParams.set(\"redirectTo\", redirectTo);\n\tcallbackUrl.searchParams.set(\"selva_state\", issueOAuthState(cookies));\n\tconst authorizationUrl = await oauth.getOAuthAuthorizationUrl(provider, callbackUrl.toString());\n\tredirect(303, authorizationUrl);\n};\n//#endregion\nexport { GET };\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAKA;AACA,IAAI,iBAAiB,GAAG;AACxB,CAAC,QAAQ;AACT,CAAC,QAAQ;AACT,CAAC,OAAO;AACR,CAAC;AACD,CAAC;AACD,SAAS,iBAAiB,CAAC,KAAK,EAAE;AAClC,CAAC,OAAO,KAAK,KAAK,IAAI,IAAI,iBAAiB,CAAC,QAAQ,CAAC,KAAK,CAAC;AAC3D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACG,IAAC,GAAG,GAAG,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK;AACtC,CAAC,MAAM,QAAQ,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC;AAClD,CAAC,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC,iBAAiB,EAAE,CAAC,2BAA2B,EAAE,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC9I,CAAC,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC,KAAK;AACtC,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC,QAAQ,EAAE,yDAAyD,CAAC;AAC5G,CAAC,MAAM,UAAU,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,UAAU;AACpE,CAAC,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,yBAAyB,EAAE,GAAG,CAAC,MAAM,CAAC;AACnE,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC,YAAY,CAAC,GAAG,CAAC,YAAY,EAAE,UAAU,CAAC;AACvF,CAAC,WAAW,CAAC,YAAY,CAAC,GAAG,CAAC,aAAa,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;AACtE,CAAC,MAAM,gBAAgB,GAAG,MAAM,KAAK,CAAC,wBAAwB,CAAC,QAAQ,EAAE,WAAW,CAAC,QAAQ,EAAE,CAAC;AAChG,CAAC,QAAQ,CAAC,GAAG,EAAE,gBAAgB,CAAC;AAChC;;;;"}

package/build/server/chunks/entries/endpoints/docs/api/openapi.yaml/_server.ts.js-DzqQf3SR.js

@@ -0,0 +1,11 @@
+//#region openapi/v1.yaml?raw
+var v1_default = "# Generated from the Zod validators and the route registry in\n# src/lib/server/api/v1/. Do not edit by hand — `pnpm test` fails when this\n# file drifts from the code. Regenerate with `pnpm openapi:generate`.\nopenapi: \"3.1.0\"\ninfo:\n  title: Selva API\n  version: \"1.0.0\"\n  description: \"The tenant-scoped Selva API. Every endpoint acts as the calling identity and is confined to that identity's organization.\\n\\n**Stability.** Public endpoints are additive-only within v1: new optional fields and parameters may appear, but nothing is removed, renamed, or changed in type or meaning. A breaking change ships as a new route under `/api/v2` alongside this one. Anything deprecated inside v1 keeps working for a stated window and returns a `Deprecation` header while it does.\\n\\n**Operations marked `x-internal` carry none of that promise.** They exist to serve the Selva web UI and may change or disappear without notice.\\n\\n**Existence is never disclosed.** A resource the caller may not see returns `404`, not `403`. `403` means the resource is visible but the action is not allowed.\\n\\n**No CORS.** `/api/v1` sends no cross-origin headers; it serves same-origin browser requests and non-browser clients holding a token.\\n\\n**Scopes.** Each operation names the API-token scope it needs as `x-scope`: `read`, `write`, `solve` or `upload`. `write`, `solve` and `upload` each include `read`, and `write` includes `upload`. `upload` allows creating definitions, uploading versions, checking a file's schema before upload and making a version live, and nothing else: it cannot edit metadata, delete or share.\\n\\nInstance administration lives at `/api/admin`, is session-only, is never reachable with a bearer token, and is not described here.\"\n  license:\n    name: MIT\nservers:\n  - url: /\n    description: The instance serving this document.\nsecurity:\n  - cookieAuth: []\n  - bearerAuth: []\ncomponents:\n  securitySchemes:\n    cookieAuth:\n      type: apiKey\n      in: cookie\n      name: session\n      description: Browser session cookie. Same-origin only.\n    bearerAuth:\n      type: http\n      scheme: bearer\n      description: \"An API token (`selva_…`), sent as `Authorization: Bearer <token>` and never in the URL. It acts as the user who created it, in one org, narrowed by its scopes. `/api/v1` is the only prefix that accepts one; `/api/admin` never does.\"\n  parameters:\n    limit:\n      name: limit\n      in: query\n      required: false\n      description: \"Page size. Out-of-range values clamp rather than fail, so a client walking a cursor is never stopped by pagination plumbing. Default 50.\"\n      schema:\n        type: integer\n        minimum: 1\n        maximum: 200\n    cursor:\n      name: cursor\n      in: query\n      required: false\n      description: \"An opaque cursor from a previous response's `nextCursor`. Do not construct or parse one.\"\n      schema:\n        type: string\n    orderBy:\n      name: orderBy\n      in: query\n      required: false\n      schema:\n        type: string\n        enum:\n          - createdAt\n          - updatedAt\n          - name\n    orderDir:\n      name: orderDir\n      in: query\n      required: false\n      schema:\n        type: string\n        enum:\n          - asc\n          - desc\n    idempotencyKey:\n      name: Idempotency-Key\n      in: header\n      required: false\n      description: \"A client-chosen key, 1 to 255 characters. Repeating the request with the same key within the retention window replays the first successful response instead of running it again; the replay carries `Idempotency-Replayed: true`. Keys are scoped to the calling token (or user, for a browser session). Reusing a key with a different method, path or body returns `422`. A failed attempt is not kept, so a corrected retry runs. The store is per-process and in-memory: it absorbs retries, does not survive a restart, and is not shared between app instances.\"\n      schema:\n        type: string\n        minLength: 1\n        maxLength: 255\n  schemas:\n    Page:\n      type: object\n      description: \"The envelope every collection returns. `nextCursor` is absent on the last page.\"\n      properties:\n        items:\n          type: array\n          items:\n            type: object\n        nextCursor:\n          type: string\n      required:\n        - items\n    Error:\n      type: object\n      description: \"Every failure carries this shape. Branch on `code`, not on the human-readable `message`.\"\n      properties:\n        message:\n          type: string\n        code:\n          type: string\n          enum:\n            - VALIDATION_FAILED\n            - UNAUTHORIZED\n            - FORBIDDEN\n            - NOT_FOUND\n            - CONFLICT\n            - UNPROCESSABLE\n            - COMPUTE_UNAVAILABLE\n            - SETUP_REQUIRED\n            - INTERNAL\n            - API_TOKENS_UNAVAILABLE\n            - RATE_LIMITED\n            - API_TOKEN_HOLDER_REFUSED\n        fields:\n          type: object\n          description: \"Per-field messages, keyed by dotted path. Present on validation failures.\"\n          additionalProperties:\n            type: string\n        details:\n          type: object\n          description: \"Machine-readable context. A scope refusal carries `requiredScope`, e.g. `write:org:<id>`.\"\n          additionalProperties:\n            type: string\n      required:\n        - message\n        - code\npaths:\n  /api/v1/openapi.json:\n    get:\n      summary: \"This document, as JSON.\"\n      operationId: getOpenapi\n      tags:\n        - Openapi\n      x-scope: read\n      responses:\n        \"200\":\n          description: Success.\n          content:\n            application/json:\n              schema:\n                type: object\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n  /api/v1/me:\n    get:\n      summary: \"The calling identity, its acting org, its effective permissions, and for a token its id, scopes and expiry.\"\n      operationId: getMe\n      tags:\n        - Me\n      x-scope: read\n      responses:\n        \"200\":\n          description: \"`apiToken: { id, scopes, expiresAt }` is present only when the caller is an API token.\"\n          content:\n            application/json:\n              schema:\n                type: object\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n  /api/v1/me/token:\n    delete:\n      summary: Revoke the API token that sent this request. A key can revoke itself and nothing else; a browser session gets 400.\n      operationId: deleteMeToken\n      tags:\n        - Me\n      x-scope: read\n      responses:\n        \"204\":\n          description: Success. No content.\n        \"400\":\n          description: Validation failed.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n  \"/api/v1/me/starred/{guid}\":\n    put:\n      summary: Star a definition. Idempotent.\n      operationId: putMeStarredByGuid\n      tags:\n        - Me\n      x-scope: write\n      parameters:\n        - name: guid\n          in: path\n          required: true\n          schema:\n            type: string\n      responses:\n        \"204\":\n          description: Success. No content.\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"404\":\n          description: \"No such resource, or the caller cannot see it.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n    delete:\n      summary: Unstar a definition. Idempotent.\n      operationId: deleteMeStarredByGuid\n      tags:\n        - Me\n      x-scope: write\n      parameters:\n        - name: guid\n          in: path\n          required: true\n          schema:\n            type: string\n      responses:\n        \"204\":\n          description: Success. No content.\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n  /api/v1/definitions:\n    get:\n      summary: List definitions the caller can see.\n      operationId: getDefinitions\n      tags:\n        - Definitions\n      x-scope: read\n      parameters:\n        - $ref: \"#/components/parameters/limit\"\n        - $ref: \"#/components/parameters/cursor\"\n        - $ref: \"#/components/parameters/orderBy\"\n        - $ref: \"#/components/parameters/orderDir\"\n        - name: projectId\n          in: query\n          required: false\n          description: Restrict to one project.\n          schema:\n            type: string\n        - name: status\n          in: query\n          required: false\n          description: \"One of `draft`, `published`, `archived`.\"\n          schema:\n            type: string\n        - name: documentId\n          in: query\n          required: false\n          description: \"A Grasshopper document GUID. Returns only definitions last uploaded from that document which the caller can upload a new version of. Not a GUID: 400.\"\n          schema:\n            type: string\n      responses:\n        \"200\":\n          description: \"Each item has `sourceDocumentId`: the Grasshopper document GUID the definition was last uploaded from, or null.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Page\"\n        \"400\":\n          description: Validation failed.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n    post:\n      summary: Create a definition from a Grasshopper file.\n      operationId: postDefinitions\n      tags:\n        - Definitions\n      x-scope: upload\n      parameters:\n        - $ref: \"#/components/parameters/idempotencyKey\"\n      requestBody:\n        required: true\n        content:\n          multipart/form-data:\n            schema:\n              type: object\n              properties:\n                file:\n                  type: string\n                  description: \"The `.gh` or `.ghx` file.\"\n                projectId:\n                  type: string\n                  description: Owning project.\n                displayName:\n                  type: string\n                  description: Human-readable name.\n                description:\n                  type: string\n                  description: Long description.\n                category:\n                  type: string\n                  description: Grouping label.\n                tags:\n                  type: string\n                  description: Comma-separated tags.\n                image:\n                  type: string\n                  description: Cover image.\n                computeServerId:\n                  type: string\n                  description: Pin to a compute server.\n              required:\n                - file\n                - projectId\n                - displayName\n      responses:\n        \"201\":\n          description: Success.\n          content:\n            application/json:\n              schema:\n                type: object\n        \"400\":\n          description: Validation failed.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"422\":\n          description: Well-formed but not processable.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n  \"/api/v1/definitions/{guid}\":\n    get:\n      summary: Definition record plus its live and draft version summaries.\n      operationId: getDefinitionsByGuid\n      tags:\n        - Definitions\n      x-scope: read\n      parameters:\n        - name: guid\n          in: path\n          required: true\n          schema:\n            type: string\n      responses:\n        \"200\":\n          description: \"`canEdit` is true when the caller can upload a version and make one live; for an API token that includes its scopes. `sourceDocumentId` is the Grasshopper document GUID it was last uploaded from, or null.\"\n          content:\n            application/json:\n              schema:\n                type: object\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"404\":\n          description: \"No such resource, or the caller cannot see it.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n    patch:\n      summary: Update definition metadata.\n      operationId: patchDefinitionsByGuid\n      tags:\n        - Definitions\n      x-scope: write\n      parameters:\n        - name: guid\n          in: path\n          required: true\n          schema:\n            type: string\n      responses:\n        \"204\":\n          description: Success. No content.\n        \"400\":\n          description: Validation failed.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"404\":\n          description: \"No such resource, or the caller cannot see it.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n    delete:\n      summary: Soft-delete a definition.\n      operationId: deleteDefinitionsByGuid\n      tags:\n        - Definitions\n      x-scope: write\n      parameters:\n        - name: guid\n          in: path\n          required: true\n          schema:\n            type: string\n      responses:\n        \"204\":\n          description: Success. No content.\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"404\":\n          description: \"No such resource, or the caller cannot see it.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n  \"/api/v1/definitions/{guid}/solve\":\n    post:\n      summary: Solve a definition. The primary action of the API.\n      operationId: postDefinitionsByGuidSolve\n      tags:\n        - Definitions\n      x-scope: solve\n      parameters:\n        - name: guid\n          in: path\n          required: true\n          schema:\n            type: string\n        - $ref: \"#/components/parameters/idempotencyKey\"\n      requestBody:\n        required: true\n        content:\n          application/json:\n            schema:\n              type: object\n              properties:\n                inputs:\n                  default: []\n                  type: array\n                  items: {}\n                values:\n                  default: {}\n                  type: object\n                  propertyNames:\n                    type: string\n                  additionalProperties: {}\n                channel:\n                  default: live\n                  type: string\n                  enum:\n                    - live\n                    - draft\n                versionId:\n                  type: string\n                definitionUrl:\n                  type: string\n      responses:\n        \"200\":\n          description: Success.\n          content:\n            application/json:\n              schema:\n                type: object\n        \"400\":\n          description: Validation failed.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"404\":\n          description: \"No such resource, or the caller cannot see it.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"422\":\n          description: Well-formed but not processable.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n  \"/api/v1/definitions/{guid}/schema\":\n    get:\n      summary: \"The live version's UI schema. 404 when nothing is published.\"\n      operationId: getDefinitionsByGuidSchema\n      tags:\n        - Definitions\n      x-scope: read\n      parameters:\n        - name: guid\n          in: path\n          required: true\n          schema:\n            type: string\n      responses:\n        \"200\":\n          description: Success.\n          content:\n            application/json:\n              schema:\n                type: object\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"404\":\n          description: \"No such resource, or the caller cannot see it.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n  \"/api/v1/definitions/{guid}/versions\":\n    get:\n      summary: \"List versions, newest first.\"\n      operationId: getDefinitionsByGuidVersions\n      tags:\n        - Definitions\n      x-scope: read\n      parameters:\n        - name: guid\n          in: path\n          required: true\n          schema:\n            type: string\n        - $ref: \"#/components/parameters/limit\"\n        - $ref: \"#/components/parameters/cursor\"\n        - $ref: \"#/components/parameters/orderBy\"\n        - $ref: \"#/components/parameters/orderDir\"\n      responses:\n        \"200\":\n          description: A page of results.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Page\"\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"404\":\n          description: \"No such resource, or the caller cannot see it.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n    post:\n      summary: Upload a new version.\n      operationId: postDefinitionsByGuidVersions\n      tags:\n        - Definitions\n      x-scope: upload\n      parameters:\n        - name: guid\n          in: path\n          required: true\n          schema:\n            type: string\n        - $ref: \"#/components/parameters/idempotencyKey\"\n      requestBody:\n        required: true\n        content:\n          multipart/form-data:\n            schema:\n              type: object\n              properties:\n                file:\n                  type: string\n                  description: \"The `.gh` or `.ghx` file.\"\n                changeNote:\n                  type: string\n                  description: Truncated to 1000 characters.\n              required:\n                - file\n      responses:\n        \"201\":\n          description: Success.\n          content:\n            application/json:\n              schema:\n                type: object\n        \"400\":\n          description: Validation failed.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"404\":\n          description: \"No such resource, or the caller cannot see it.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"422\":\n          description: Well-formed but not processable.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n  \"/api/v1/definitions/{guid}/versions/{versionId}\":\n    get:\n      summary: \"One version, without its cached schema.\"\n      operationId: getDefinitionsByGuidVersionsByVersionId\n      tags:\n        - Definitions\n      x-scope: read\n      parameters:\n        - name: guid\n          in: path\n          required: true\n          schema:\n            type: string\n        - name: versionId\n          in: path\n          required: true\n          schema:\n            type: string\n      responses:\n        \"200\":\n          description: Success.\n          content:\n            application/json:\n              schema:\n                type: object\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"404\":\n          description: \"No such resource, or the caller cannot see it.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n    delete:\n      summary: Delete a version. 409 when it is the live or draft pointer.\n      operationId: deleteDefinitionsByGuidVersionsByVersionId\n      tags:\n        - Definitions\n      x-scope: write\n      parameters:\n        - name: guid\n          in: path\n          required: true\n          schema:\n            type: string\n        - name: versionId\n          in: path\n          required: true\n          schema:\n            type: string\n      responses:\n        \"204\":\n          description: Success. No content.\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"404\":\n          description: \"No such resource, or the caller cannot see it.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"409\":\n          description: The request conflicts with the current state.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n  \"/api/v1/definitions/{guid}/versions/{versionId}/schema\":\n    get:\n      summary: \"That version's cached UI schema. No compute round-trip.\"\n      operationId: getDefinitionsByGuidVersionsByVersionIdSchema\n      tags:\n        - Definitions\n      x-scope: read\n      parameters:\n        - name: guid\n          in: path\n          required: true\n          schema:\n            type: string\n        - name: versionId\n          in: path\n          required: true\n          schema:\n            type: string\n      responses:\n        \"200\":\n          description: Success.\n          content:\n            application/json:\n              schema:\n                type: object\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"404\":\n          description: \"No such resource, or the caller cannot see it.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n  \"/api/v1/definitions/{guid}/publish\":\n    post:\n      summary: Promote a version to live.\n      operationId: postDefinitionsByGuidPublish\n      tags:\n        - Definitions\n      x-scope: upload\n      parameters:\n        - name: guid\n          in: path\n          required: true\n          schema:\n            type: string\n      responses:\n        \"200\":\n          description: Success.\n          content:\n            application/json:\n              schema:\n                type: object\n        \"400\":\n          description: Validation failed.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"404\":\n          description: \"No such resource, or the caller cannot see it.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n  \"/api/v1/definitions/{guid}/image\":\n    post:\n      summary: Upload a cover image.\n      operationId: postDefinitionsByGuidImage\n      tags:\n        - Definitions\n      x-scope: write\n      parameters:\n        - name: guid\n          in: path\n          required: true\n          schema:\n            type: string\n      requestBody:\n        required: true\n        content:\n          multipart/form-data:\n            schema:\n              type: object\n              properties:\n                image:\n                  type: string\n                  description: \"PNG, JPEG, WebP or GIF.\"\n              required:\n                - image\n      responses:\n        \"200\":\n          description: Success.\n          content:\n            application/json:\n              schema:\n                type: object\n        \"400\":\n          description: Validation failed.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"404\":\n          description: \"No such resource, or the caller cannot see it.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n  \"/api/v1/definitions/{guid}/share-links\":\n    get:\n      summary: List share links. 404 when sharing is disabled on the instance.\n      operationId: getDefinitionsByGuidShare-links\n      tags:\n        - Definitions\n      x-scope: read\n      parameters:\n        - name: guid\n          in: path\n          required: true\n          schema:\n            type: string\n        - $ref: \"#/components/parameters/limit\"\n        - $ref: \"#/components/parameters/cursor\"\n        - $ref: \"#/components/parameters/orderBy\"\n        - $ref: \"#/components/parameters/orderDir\"\n      responses:\n        \"200\":\n          description: A page of results.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Page\"\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"404\":\n          description: \"No such resource, or the caller cannot see it.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n    post:\n      summary: Create a share link. The raw token is returned once and never again.\n      operationId: postDefinitionsByGuidShare-links\n      tags:\n        - Definitions\n      x-scope: write\n      parameters:\n        - name: guid\n          in: path\n          required: true\n          schema:\n            type: string\n        - $ref: \"#/components/parameters/idempotencyKey\"\n      responses:\n        \"201\":\n          description: Success.\n          content:\n            application/json:\n              schema:\n                type: object\n        \"400\":\n          description: Validation failed.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"404\":\n          description: \"No such resource, or the caller cannot see it.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"422\":\n          description: Well-formed but not processable.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n  \"/api/v1/definitions/{guid}/share-links/{linkId}\":\n    delete:\n      summary: Revoke a share link.\n      operationId: deleteDefinitionsByGuidShare-linksByLinkId\n      tags:\n        - Definitions\n      x-scope: write\n      parameters:\n        - name: guid\n          in: path\n          required: true\n          schema:\n            type: string\n        - name: linkId\n          in: path\n          required: true\n          schema:\n            type: string\n      responses:\n        \"204\":\n          description: Success. No content.\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"404\":\n          description: \"No such resource, or the caller cannot see it.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n  /api/v1/projects:\n    get:\n      summary: List projects the caller can view.\n      operationId: getProjects\n      tags:\n        - Projects\n      x-scope: read\n      parameters:\n        - $ref: \"#/components/parameters/limit\"\n        - $ref: \"#/components/parameters/cursor\"\n        - $ref: \"#/components/parameters/orderBy\"\n        - $ref: \"#/components/parameters/orderDir\"\n      responses:\n        \"200\":\n          description: \"Each item has `canCreateDefinitions`: whether `POST /definitions` would accept this project from the caller, scopes included for an API token.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Page\"\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n    post:\n      summary: Create a project.\n      operationId: postProjects\n      tags:\n        - Projects\n      x-scope: write\n      parameters:\n        - $ref: \"#/components/parameters/idempotencyKey\"\n      requestBody:\n        required: true\n        content:\n          application/json:\n            schema:\n              type: object\n              properties:\n                name:\n                  type: string\n                  minLength: 1\n                  maxLength: 128\n                description:\n                  type: string\n                  maxLength: 2000\n                visibility:\n                  default: private\n                  type: string\n                  enum:\n                    - public\n                    - org\n                    - private\n                    - platform\n                autoJoinOnUpload:\n                  type: boolean\n              required:\n                - name\n      responses:\n        \"201\":\n          description: Success.\n          content:\n            application/json:\n              schema:\n                type: object\n        \"400\":\n          description: Validation failed.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"409\":\n          description: The request conflicts with the current state.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"422\":\n          description: Well-formed but not processable.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n  \"/api/v1/projects/{id}\":\n    get:\n      summary: \"Project record plus the caller's effective role and capabilities.\"\n      operationId: getProjectsById\n      tags:\n        - Projects\n      x-scope: read\n      parameters:\n        - name: id\n          in: path\n          required: true\n          schema:\n            type: string\n      responses:\n        \"200\":\n          description: Success.\n          content:\n            application/json:\n              schema:\n                type: object\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"404\":\n          description: \"No such resource, or the caller cannot see it.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n    patch:\n      summary: Update project settings. Owner-only.\n      operationId: patchProjectsById\n      tags:\n        - Projects\n      x-scope: write\n      parameters:\n        - name: id\n          in: path\n          required: true\n          schema:\n            type: string\n      requestBody:\n        required: true\n        content:\n          application/json:\n            schema:\n              type: object\n              properties:\n                name:\n                  type: string\n                  minLength: 1\n                  maxLength: 128\n                description:\n                  anyOf:\n                    - type: string\n                      maxLength: 2000\n                    - type: \"null\"\n                visibility:\n                  type: string\n                  enum:\n                    - public\n                    - org\n                    - private\n                    - platform\n                autoJoinOnUpload:\n                  type: boolean\n      responses:\n        \"204\":\n          description: Success. No content.\n        \"400\":\n          description: Validation failed.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"404\":\n          description: \"No such resource, or the caller cannot see it.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"409\":\n          description: The request conflicts with the current state.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n    delete:\n      summary: Delete a project.\n      operationId: deleteProjectsById\n      tags:\n        - Projects\n      x-scope: write\n      parameters:\n        - name: id\n          in: path\n          required: true\n          schema:\n            type: string\n      responses:\n        \"204\":\n          description: Success. No content.\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"404\":\n          description: \"No such resource, or the caller cannot see it.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n  \"/api/v1/projects/{id}/members\":\n    get:\n      summary: List project members.\n      operationId: getProjectsByIdMembers\n      tags:\n        - Projects\n      x-scope: read\n      parameters:\n        - name: id\n          in: path\n          required: true\n          schema:\n            type: string\n        - $ref: \"#/components/parameters/limit\"\n        - $ref: \"#/components/parameters/cursor\"\n        - $ref: \"#/components/parameters/orderBy\"\n        - $ref: \"#/components/parameters/orderDir\"\n      responses:\n        \"200\":\n          description: A page of results.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Page\"\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"404\":\n          description: \"No such resource, or the caller cannot see it.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n    post:\n      summary: Add a member. The target must already belong to the org.\n      operationId: postProjectsByIdMembers\n      tags:\n        - Projects\n      x-scope: write\n      parameters:\n        - name: id\n          in: path\n          required: true\n          schema:\n            type: string\n      requestBody:\n        required: true\n        content:\n          application/json:\n            schema:\n              type: object\n              properties:\n                userId:\n                  type: string\n                  minLength: 1\n                role:\n                  type: string\n                  enum:\n                    - owner\n                    - editor\n                    - viewer\n              required:\n                - userId\n                - role\n      responses:\n        \"201\":\n          description: Success.\n          content:\n            application/json:\n              schema:\n                type: object\n        \"400\":\n          description: Validation failed.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"404\":\n          description: \"No such resource, or the caller cannot see it.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n  \"/api/v1/projects/{id}/members/{userId}\":\n    patch:\n      summary: Change a member role.\n      operationId: patchProjectsByIdMembersByUserId\n      tags:\n        - Projects\n      x-scope: write\n      parameters:\n        - name: id\n          in: path\n          required: true\n          schema:\n            type: string\n        - name: userId\n          in: path\n          required: true\n          schema:\n            type: string\n      requestBody:\n        required: true\n        content:\n          application/json:\n            schema:\n              type: object\n              properties:\n                role:\n                  type: string\n                  enum:\n                    - owner\n                    - editor\n                    - viewer\n              required:\n                - role\n      responses:\n        \"204\":\n          description: Success. No content.\n        \"400\":\n          description: Validation failed.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"404\":\n          description: \"No such resource, or the caller cannot see it.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"409\":\n          description: The request conflicts with the current state.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n    delete:\n      summary: Remove a member. Idempotent.\n      operationId: deleteProjectsByIdMembersByUserId\n      tags:\n        - Projects\n      x-scope: write\n      parameters:\n        - name: id\n          in: path\n          required: true\n          schema:\n            type: string\n        - name: userId\n          in: path\n          required: true\n          schema:\n            type: string\n        - name: confirm\n          in: query\n          required: false\n          description: \"Set to `true` to remove a co-owner; without it the call returns 409.\"\n          schema:\n            type: string\n      responses:\n        \"204\":\n          description: Success. No content.\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"404\":\n          description: \"No such resource, or the caller cannot see it.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"409\":\n          description: The request conflicts with the current state.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n  \"/api/v1/projects/{id}/reclaim\":\n    post:\n      summary: Claim ownership of an unowned project.\n      operationId: postProjectsByIdReclaim\n      tags:\n        - Projects\n      x-scope: write\n      parameters:\n        - name: id\n          in: path\n          required: true\n          schema:\n            type: string\n      responses:\n        \"201\":\n          description: Success.\n          content:\n            application/json:\n              schema:\n                type: object\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"404\":\n          description: \"No such resource, or the caller cannot see it.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"409\":\n          description: The request conflicts with the current state.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n  \"/api/v1/orgs/{orgId}\":\n    get:\n      summary: \"Org record. The org must be the caller's acting org.\"\n      operationId: getOrgsByOrgId\n      tags:\n        - Orgs\n      x-scope: read\n      parameters:\n        - name: orgId\n          in: path\n          required: true\n          schema:\n            type: string\n      responses:\n        \"200\":\n          description: Success.\n          content:\n            application/json:\n              schema:\n                type: object\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"404\":\n          description: \"No such resource, or the caller cannot see it.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n  \"/api/v1/orgs/{orgId}/members\":\n    get:\n      summary: List org members.\n      operationId: getOrgsByOrgIdMembers\n      tags:\n        - Orgs\n      x-scope: read\n      parameters:\n        - name: orgId\n          in: path\n          required: true\n          schema:\n            type: string\n        - $ref: \"#/components/parameters/limit\"\n        - $ref: \"#/components/parameters/cursor\"\n        - $ref: \"#/components/parameters/orderBy\"\n        - $ref: \"#/components/parameters/orderDir\"\n      responses:\n        \"200\":\n          description: A page of results.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Page\"\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n  \"/api/v1/orgs/{orgId}/members/{userId}\":\n    patch:\n      summary: Change an org role or permission set. The sole owner cannot be demoted.\n      operationId: patchOrgsByOrgIdMembersByUserId\n      tags:\n        - Orgs\n      x-scope: write\n      parameters:\n        - name: orgId\n          in: path\n          required: true\n          schema:\n            type: string\n        - name: userId\n          in: path\n          required: true\n          schema:\n            type: string\n      requestBody:\n        required: true\n        content:\n          application/json:\n            schema:\n              type: object\n              properties:\n                role:\n                  type: string\n                  enum:\n                    - owner\n                    - admin\n                    - member\n                permissions:\n                  type: array\n                  items:\n                    type: string\n                    enum:\n                      - manage_org_members\n                      - manage_org_compute\n                      - manage_definitions\n                      - manage_projects\n      responses:\n        \"204\":\n          description: Success. No content.\n        \"400\":\n          description: Validation failed.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"404\":\n          description: \"No such resource, or the caller cannot see it.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"409\":\n          description: The request conflicts with the current state.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n    delete:\n      summary: Remove an org member. The sole owner cannot be removed.\n      operationId: deleteOrgsByOrgIdMembersByUserId\n      tags:\n        - Orgs\n      x-scope: write\n      parameters:\n        - name: orgId\n          in: path\n          required: true\n          schema:\n            type: string\n        - name: userId\n          in: path\n          required: true\n          schema:\n            type: string\n      responses:\n        \"204\":\n          description: Success. No content.\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"404\":\n          description: \"No such resource, or the caller cannot see it.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"409\":\n          description: The request conflicts with the current state.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n  \"/api/v1/orgs/{orgId}/invites\":\n    get:\n      summary: List pending invites.\n      operationId: getOrgsByOrgIdInvites\n      tags:\n        - Orgs\n      x-scope: read\n      parameters:\n        - name: orgId\n          in: path\n          required: true\n          schema:\n            type: string\n        - $ref: \"#/components/parameters/limit\"\n        - $ref: \"#/components/parameters/cursor\"\n        - $ref: \"#/components/parameters/orderBy\"\n        - $ref: \"#/components/parameters/orderDir\"\n      responses:\n        \"200\":\n          description: A page of results.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Page\"\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n    post:\n      summary: Invite someone to the org. The accept URL is returned once.\n      operationId: postOrgsByOrgIdInvites\n      tags:\n        - Orgs\n      x-scope: write\n      parameters:\n        - name: orgId\n          in: path\n          required: true\n          schema:\n            type: string\n      requestBody:\n        required: true\n        content:\n          application/json:\n            schema:\n              type: object\n              properties:\n                email:\n                  type: string\n                  format: email\n                  pattern: \"^(?:[A-Za-z0-9_'+\\\\-]+\\\\.)*[A-Za-z0-9_'+\\\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\\\-]*\\\\.)+[A-Za-z]{2,}$\"\n                orgRole:\n                  default: member\n                  type: string\n                  enum:\n                    - owner\n                    - admin\n                    - member\n                permissions:\n                  default: []\n                  type: array\n                  items:\n                    anyOf:\n                      - type: string\n                        enum:\n                          - instance_admin\n                          - manage_compute\n                          - manage_instance_users\n                          - manage_updates\n                          - manage_api_tokens\n                      - type: string\n                        enum:\n                          - manage_org_members\n                          - manage_org_compute\n                          - manage_definitions\n                          - manage_projects\n              required:\n                - email\n      responses:\n        \"201\":\n          description: Success.\n          content:\n            application/json:\n              schema:\n                type: object\n        \"400\":\n          description: Validation failed.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"409\":\n          description: The request conflicts with the current state.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n  \"/api/v1/orgs/{orgId}/invites/{id}\":\n    delete:\n      summary: Revoke an invite.\n      operationId: deleteOrgsByOrgIdInvitesById\n      tags:\n        - Orgs\n      x-scope: write\n      parameters:\n        - name: orgId\n          in: path\n          required: true\n          schema:\n            type: string\n        - name: id\n          in: path\n          required: true\n          schema:\n            type: string\n      responses:\n        \"204\":\n          description: Success. No content.\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"404\":\n          description: \"No such resource, or the caller cannot see it.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n  \"/api/v1/orgs/{orgId}/invites/{id}/resend\":\n    post:\n      summary: \"Re-send an invite. Issues a replacement and revokes the original, so the previous link stops working.\"\n      operationId: postOrgsByOrgIdInvitesByIdResend\n      tags:\n        - Orgs\n      x-scope: write\n      parameters:\n        - name: orgId\n          in: path\n          required: true\n          schema:\n            type: string\n        - name: id\n          in: path\n          required: true\n          schema:\n            type: string\n      responses:\n        \"201\":\n          description: Success.\n          content:\n            application/json:\n              schema:\n                type: object\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"404\":\n          description: \"No such resource, or the caller cannot see it.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"409\":\n          description: The request conflicts with the current state.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n  \"/api/v1/orgs/{orgId}/tokens\":\n    get:\n      summary: \"Your API tokens in this org, revoked and expired included.\"\n      operationId: getOrgsByOrgIdTokens\n      tags:\n        - Orgs\n      x-scope: read\n      x-internal: true\n      parameters:\n        - name: orgId\n          in: path\n          required: true\n          schema:\n            type: string\n        - $ref: \"#/components/parameters/limit\"\n        - $ref: \"#/components/parameters/cursor\"\n        - $ref: \"#/components/parameters/orderBy\"\n        - $ref: \"#/components/parameters/orderDir\"\n        - name: all\n          in: query\n          required: false\n          description: \"`true` for every member's tokens. Needs `manage_org_members`.\"\n          schema:\n            type: string\n      responses:\n        \"200\":\n          description: A page of results.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Page\"\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n    post:\n      summary: \"Create an API token acting as you. The raw key is returned once, as `secret`.\"\n      operationId: postOrgsByOrgIdTokens\n      tags:\n        - Orgs\n      x-scope: write\n      x-internal: true\n      parameters:\n        - name: orgId\n          in: path\n          required: true\n          schema:\n            type: string\n      requestBody:\n        required: true\n        content:\n          application/json:\n            schema:\n              type: object\n              properties:\n                name:\n                  type: string\n                  minLength: 1\n                  maxLength: 100\n                scopes:\n                  minItems: 1\n                  maxItems: 20\n                  type: array\n                  items:\n                    type: string\n                expiresInDays:\n                  anyOf:\n                    - type: number\n                      const: 30\n                    - type: number\n                      const: 90\n                    - type: number\n                      const: 180\n              required:\n                - name\n                - scopes\n                - expiresInDays\n      responses:\n        \"201\":\n          description: Success.\n          content:\n            application/json:\n              schema:\n                type: object\n        \"400\":\n          description: Validation failed.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n  \"/api/v1/orgs/{orgId}/tokens/{tokenId}\":\n    delete:\n      summary: \"Revoke an API token: your own, or any in the org with `manage_org_members`.\"\n      operationId: deleteOrgsByOrgIdTokensByTokenId\n      tags:\n        - Orgs\n      x-scope: write\n      x-internal: true\n      parameters:\n        - name: orgId\n          in: path\n          required: true\n          schema:\n            type: string\n        - name: tokenId\n          in: path\n          required: true\n          schema:\n            type: string\n      responses:\n        \"204\":\n          description: Success. No content.\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"404\":\n          description: \"No such resource, or the caller cannot see it.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n  \"/api/v1/orgs/{orgId}/compute\":\n    get:\n      summary: Org compute-server overrides and the shared catalog.\n      operationId: getOrgsByOrgIdCompute\n      tags:\n        - Orgs\n      x-scope: read\n      x-internal: true\n      parameters:\n        - name: orgId\n          in: path\n          required: true\n          schema:\n            type: string\n      responses:\n        \"200\":\n          description: Success.\n          content:\n            application/json:\n              schema:\n                type: object\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n    patch:\n      summary: Replace the org compute-server overrides.\n      operationId: patchOrgsByOrgIdCompute\n      tags:\n        - Orgs\n      x-scope: write\n      x-internal: true\n      parameters:\n        - name: orgId\n          in: path\n          required: true\n          schema:\n            type: string\n      requestBody:\n        required: true\n        content:\n          application/json:\n            schema:\n              type: object\n              properties:\n                servers:\n                  type: array\n                  items:\n                    type: object\n                    properties:\n                      id:\n                        type: string\n                        minLength: 1\n                      label:\n                        type: string\n                        minLength: 1\n                      serverUrl:\n                        type: string\n                        minLength: 1\n                      apiKey:\n                        type:\n                          - string\n                          - \"null\"\n                      timeoutMs:\n                        type: number\n                      retryCount:\n                        type: number\n                    required:\n                      - id\n                      - label\n                      - serverUrl\n                defaultServerId:\n                  type:\n                    - string\n                    - \"null\"\n              required:\n                - servers\n      responses:\n        \"204\":\n          description: Success. No content.\n        \"400\":\n          description: Validation failed.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n  \"/api/v1/orgs/{orgId}/assets/{kind}\":\n    post:\n      summary: Upload an org branding asset.\n      operationId: postOrgsByOrgIdAssetsByKind\n      tags:\n        - Orgs\n      x-scope: write\n      x-internal: true\n      parameters:\n        - name: orgId\n          in: path\n          required: true\n          schema:\n            type: string\n        - name: kind\n          in: path\n          required: true\n          schema:\n            type: string\n      requestBody:\n        required: true\n        content:\n          multipart/form-data:\n            schema:\n              type: object\n              properties:\n                image:\n                  type: string\n                  description: \"PNG, JPEG, WebP, GIF or SVG.\"\n              required:\n                - image\n      responses:\n        \"200\":\n          description: Success.\n          content:\n            application/json:\n              schema:\n                type: object\n        \"400\":\n          description: Validation failed.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"404\":\n          description: \"No such resource, or the caller cannot see it.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n    delete:\n      summary: Remove an org branding asset.\n      operationId: deleteOrgsByOrgIdAssetsByKind\n      tags:\n        - Orgs\n      x-scope: write\n      x-internal: true\n      parameters:\n        - name: orgId\n          in: path\n          required: true\n          schema:\n            type: string\n        - name: kind\n          in: path\n          required: true\n          schema:\n            type: string\n      responses:\n        \"204\":\n          description: Success. No content.\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"404\":\n          description: \"No such resource, or the caller cannot see it.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n  /api/v1/compute:\n    post:\n      summary: \"Generic solve, including remote definition URLs and share-token access.\"\n      operationId: postCompute\n      tags:\n        - Compute\n      x-scope: solve\n      x-internal: true\n      responses:\n        \"200\":\n          description: Success.\n          content:\n            application/json:\n              schema:\n                type: object\n        \"400\":\n          description: Validation failed.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"404\":\n          description: \"No such resource, or the caller cannot see it.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n  /api/v1/compute/schema:\n    post:\n      summary: Extract UI schemas from an uploaded file before it becomes a definition.\n      operationId: postComputeSchema\n      tags:\n        - Compute\n      x-scope: upload\n      x-internal: true\n      parameters:\n        - name: projectId\n          in: query\n          required: false\n          description: Project the file will belong to.\n          schema:\n            type: string\n        - name: computeServerId\n          in: query\n          required: false\n          description: Pin to a compute server.\n          schema:\n            type: string\n      requestBody:\n        required: true\n        content:\n          multipart/form-data:\n            schema:\n              type: object\n              properties:\n                file:\n                  type: string\n                  description: \"The `.gh` or `.ghx` file.\"\n              required:\n                - file\n      responses:\n        \"200\":\n          description: Success.\n          content:\n            application/json:\n              schema:\n                type: object\n        \"400\":\n          description: Validation failed.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"422\":\n          description: Well-formed but not processable.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n  /api/v1/solve-events:\n    get:\n      summary: \"The tab's live event stream (SSE). Solves that name its `streamId` report here.\"\n      operationId: getSolve-events\n      tags:\n        - Solve-events\n      x-scope: read\n      x-internal: true\n      parameters:\n        - name: streamId\n          in: query\n          required: false\n          description: \"Minted by the tab, 16-64 URL-safe characters.\"\n          schema:\n            type: string\n      responses:\n        \"200\":\n          description: Success.\n          content:\n            application/json:\n              schema:\n                type: object\n        \"400\":\n          description: Validation failed.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"409\":\n          description: The request conflicts with the current state.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n  \"/api/v1/solve-events/{solveId}\":\n    post:\n      summary: \"The plugin's callback from inside a Compute solve. The reply carries `abort`.\"\n      operationId: postSolve-eventsBySolveId\n      tags:\n        - Solve-events\n      x-scope: write\n      x-internal: true\n      parameters:\n        - name: solveId\n          in: path\n          required: true\n          schema:\n            type: string\n      responses:\n        \"200\":\n          description: Success.\n          content:\n            application/json:\n              schema:\n                type: object\n        \"400\":\n          description: Validation failed.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"410\":\n          description: Error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n  \"/api/v1/solve/{solveId}/cancel\":\n    post:\n      summary: \"Ask a running solve to abort. Cooperative: it stops at the next component.\"\n      operationId: postSolveBySolveIdCancel\n      tags:\n        - Solve\n      x-scope: solve\n      x-internal: true\n      parameters:\n        - name: solveId\n          in: path\n          required: true\n          schema:\n            type: string\n      responses:\n        \"204\":\n          description: Success. No content.\n        \"401\":\n          description: Missing or invalid credentials.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"403\":\n          description: \"Authenticated, but not permitted to perform this action. For an API token, `details.requiredScope` names the scope that would have passed.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"404\":\n          description: \"No such resource, or the caller cannot see it.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"429\":\n          description: \"Rate limited. Retry after the interval in `Retry-After`. API-token callers have a per-token request budget, reported on every response in `RateLimit-Limit` and `RateLimit-Remaining`; solves also draw on the owner’s compute budget.\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"500\":\n          description: Unexpected server error.\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n        \"503\":\n          description: \"The compute server is unconfigured or unreachable, or API tokens are unavailable on this server (`API_TOKENS_UNAVAILABLE`).\"\n          content:\n            application/json:\n              schema:\n                $ref: \"#/components/schemas/Error\"\n";
+//#endregion
+//#region src/routes/docs/api/openapi.yaml/+server.ts
+var GET = async () => new Response(v1_default, { headers: {
+	"Content-Type": "application/yaml; charset=utf-8",
+	"Cache-Control": "public, max-age=300"
+} });
+
+export { GET };
+//# sourceMappingURL=_server.ts.js-DzqQf3SR.js.map