@selvajs/selva 4.8.0-beta.2 → 4.8.0-beta.4

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

@@ -0,0 +1,49 @@
+import { a as getAuthProvider } from '../../../../../chunks/providers.server.js-DJ9IeW2d.js';
+import { a as apiError, A as ApiErrorCode } from '../../../../../chunks/api-errors.js-DosmliOb.js';
+import { s as setSessionCookie, a as setRefreshCookie } from '../../../../../chunks/admin-auth.server.js-B37mb9m_.js';
+import { s as safeRedirectTarget } from '../../../../../chunks/redirect.js-B4i9gSkt.js';
+import { b as bootstrapUserSession } from '../../../../../chunks/auth-bootstrap.server.js-i0vG4aoe.js';
+import { redirect } from '@sveltejs/kit';
+import '../../../../../chunks/shared-server.js-HBAhbQ8m.js';
+import '../../../../../chunks/src.js-BYv4z3-l.js';
+import 'zod';
+import '../../../../../chunks/limits.js-pZ5FHnPu.js';
+import '../../../../../chunks/chunk-D2GEMGK5.js-keSflEOG.js';
+import '../../../../../chunks/schema.js-BhmknPcU.js';
+import 'node:crypto';
+import 'node:url';
+import 'node:path';
+import 'node:fs';
+import 'node:fs/promises';
+import '@supabase/supabase-js';
+import '../../../../../chunks/utils2.js-StB0R7IF.js';
+import 'node:dns/promises';
+import 'node:net';
+
+//#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 }) => {
+	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-bs2wSVWp.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_server.ts.js-bs2wSVWp.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 { n as apiError, t as ApiErrorCode } from \"../../../../../chunks/api-errors.js\";\nimport { c as setRefreshCookie, l as setSessionCookie } from \"../../../../../chunks/admin-auth.server.js\";\nimport \"../../../../../chunks/auth.server.js\";\nimport { t as safeRedirectTarget } from \"../../../../../chunks/redirect.js\";\nimport { t as bootstrapUserSession } from \"../../../../../chunks/auth-bootstrap.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\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":";;;;;;;;;;;;;;;;;;;;;;AAOA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACG,IAAC,GAAG,GAAG,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK;AACtC,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-BaD27IBT.js

@@ -0,0 +1,52 @@
+import { a as getAuthProvider } from '../../../../../chunks/providers.server.js-DJ9IeW2d.js';
+import { a as apiError, A as ApiErrorCode } from '../../../../../chunks/api-errors.js-DosmliOb.js';
+import { redirect } from '@sveltejs/kit';
+import '../../../../../chunks/shared-server.js-HBAhbQ8m.js';
+import '../../../../../chunks/src.js-BYv4z3-l.js';
+import 'zod';
+import '../../../../../chunks/limits.js-pZ5FHnPu.js';
+import '../../../../../chunks/chunk-D2GEMGK5.js-keSflEOG.js';
+import '../../../../../chunks/schema.js-BhmknPcU.js';
+import 'node:crypto';
+import 'node:url';
+import 'node:path';
+import 'node:fs';
+import 'node:fs/promises';
+import '@supabase/supabase-js';
+import '../../../../../chunks/utils2.js-StB0R7IF.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.
+*/
+var GET = async ({ url }) => {
+	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);
+	const authorizationUrl = await oauth.getOAuthAuthorizationUrl(provider, callbackUrl.toString());
+	redirect(303, authorizationUrl);
+};
+
+export { GET };
+//# sourceMappingURL=_server.ts.js-BaD27IBT.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_server.ts.js-BaD27IBT.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 { n as apiError, t as ApiErrorCode } from \"../../../../../chunks/api-errors.js\";\nimport \"../../../../../chunks/auth.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*/\nvar GET = async ({ url }) => {\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\tconst authorizationUrl = await oauth.getOAuthAuthorizationUrl(provider, callbackUrl.toString());\n\tredirect(303, authorizationUrl);\n};\n//#endregion\nexport { GET };\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAIA;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;AACG,IAAC,GAAG,GAAG,OAAO,EAAE,GAAG,EAAE,KAAK;AAC7B,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,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-ByPtgbbV.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: \"4.8.0-beta.3\"\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\\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 Selva 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: \"A personal access token. `/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  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        fields:\n          type: object\n          description: \"Per-field messages, keyed by dotted path. Present on validation failures.\"\n          additionalProperties:\n            type: string\n      required:\n        - message\n        - code\npaths:\n  /api/v1/me:\n    get:\n      summary: \"The calling identity, its acting org, and its effective permissions.\"\n      operationId: getMe\n      tags:\n        - Me\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        \"500\":\n          description: Unexpected server error.\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      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        \"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        \"500\":\n          description: Unexpected server error.\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      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        \"500\":\n          description: Unexpected server error.\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      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      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        \"500\":\n          description: Unexpected server error.\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      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.\"\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        \"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.\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      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        \"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        \"500\":\n          description: Unexpected server error.\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      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        \"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        \"500\":\n          description: Unexpected server error.\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      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        \"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        \"500\":\n          description: Unexpected server error.\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      parameters:\n        - name: guid\n          in: path\n          required: true\n          schema:\n            type: string\n        - name: Idempotency-Key\n          in: header\n          required: false\n          description: \"A client-chosen key. Repeating a request with the same key within the retention window replays the first response instead of solving again; the replay carries `Idempotency-Replayed: true`. The store is per-process and in-memory — it absorbs retries, it is not a durable result cache, and it does not survive a restart or a second app instance.\"\n          schema:\n            type: string\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        \"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`.\"\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.\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      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        \"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        \"500\":\n          description: Unexpected server error.\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      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        \"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        \"500\":\n          description: Unexpected server error.\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      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                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        \"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        \"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.\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      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        \"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        \"500\":\n          description: Unexpected server error.\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      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        \"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        \"500\":\n          description: Unexpected server error.\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      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        \"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        \"500\":\n          description: Unexpected server error.\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      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        \"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        \"500\":\n          description: Unexpected server error.\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      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        \"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        \"500\":\n          description: Unexpected server error.\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      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        \"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        \"500\":\n          description: Unexpected server error.\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      parameters:\n        - name: guid\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        \"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        \"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        \"500\":\n          description: Unexpected server error.\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      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        \"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        \"500\":\n          description: Unexpected server error.\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      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: 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        \"500\":\n          description: Unexpected server error.\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      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.\"\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        \"500\":\n          description: Unexpected server error.\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      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        \"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        \"500\":\n          description: Unexpected server error.\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      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.\"\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        \"500\":\n          description: Unexpected server error.\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      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.\"\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        \"500\":\n          description: Unexpected server error.\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      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.\"\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        \"500\":\n          description: Unexpected server error.\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      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.\"\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        \"500\":\n          description: Unexpected server error.\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      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.\"\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        \"500\":\n          description: Unexpected server error.\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      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.\"\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        \"500\":\n          description: Unexpected server error.\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      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.\"\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        \"500\":\n          description: Unexpected server error.\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      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.\"\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        \"500\":\n          description: Unexpected server error.\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      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.\"\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  \"/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      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.\"\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        \"500\":\n          description: Unexpected server error.\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      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.\"\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        \"500\":\n          description: Unexpected server error.\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      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.\"\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    post:\n      summary: Invite someone to the org. The accept URL is returned once.\n      operationId: postOrgsByOrgIdInvites\n      tags:\n        - Orgs\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-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                      - 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.\"\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        \"500\":\n          description: Unexpected server error.\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      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.\"\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        \"500\":\n          description: Unexpected server error.\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-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.\"\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    patch:\n      summary: Replace the org compute-server overrides.\n      operationId: patchOrgsByOrgIdCompute\n      tags:\n        - Orgs\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                        anyOf:\n                          - type: string\n                          - type: \"null\"\n                      timeoutMs:\n                        type: number\n                      retryCount:\n                        type: number\n                    required:\n                      - id\n                      - label\n                      - serverUrl\n                defaultServerId:\n                  anyOf:\n                    - type: string\n                    - type: \"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.\"\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  \"/api/v1/orgs/{orgId}/assets/{kind}\":\n    post:\n      summary: Upload an org branding asset.\n      operationId: postOrgsByOrgIdAssetsByKind\n      tags:\n        - Orgs\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.\"\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        \"500\":\n          description: Unexpected server error.\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-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.\"\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        \"500\":\n          description: Unexpected server error.\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-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        \"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`.\"\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.\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-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.\"\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        \"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.\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-ByPtgbbV.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_server.ts.js-ByPtgbbV.js","sources":["../../../../../../../../.svelte-kit/output/server/entries/endpoints/docs/api/openapi.yaml/_server.ts.js"],"sourcesContent":["//#region openapi/v1.yaml?raw\nvar 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: \\\"4.8.0-beta.3\\\"\\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\\\\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 Selva 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: \\\"A personal access token. `/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  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        fields:\\n          type: object\\n          description: \\\"Per-field messages, keyed by dotted path. Present on validation failures.\\\"\\n          additionalProperties:\\n            type: string\\n      required:\\n        - message\\n        - code\\npaths:\\n  /api/v1/me:\\n    get:\\n      summary: \\\"The calling identity, its acting org, and its effective permissions.\\\"\\n      operationId: getMe\\n      tags:\\n        - Me\\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        \\\"500\\\":\\n          description: Unexpected server error.\\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      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        \\\"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        \\\"500\\\":\\n          description: Unexpected server error.\\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      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        \\\"500\\\":\\n          description: Unexpected server error.\\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      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      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        \\\"500\\\":\\n          description: Unexpected server error.\\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      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.\\\"\\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        \\\"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.\\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      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        \\\"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        \\\"500\\\":\\n          description: Unexpected server error.\\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      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        \\\"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        \\\"500\\\":\\n          description: Unexpected server error.\\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      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        \\\"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        \\\"500\\\":\\n          description: Unexpected server error.\\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      parameters:\\n        - name: guid\\n          in: path\\n          required: true\\n          schema:\\n            type: string\\n        - name: Idempotency-Key\\n          in: header\\n          required: false\\n          description: \\\"A client-chosen key. Repeating a request with the same key within the retention window replays the first response instead of solving again; the replay carries `Idempotency-Replayed: true`. The store is per-process and in-memory — it absorbs retries, it is not a durable result cache, and it does not survive a restart or a second app instance.\\\"\\n          schema:\\n            type: string\\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        \\\"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`.\\\"\\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.\\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      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        \\\"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        \\\"500\\\":\\n          description: Unexpected server error.\\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      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        \\\"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        \\\"500\\\":\\n          description: Unexpected server error.\\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      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                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        \\\"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        \\\"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.\\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      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        \\\"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        \\\"500\\\":\\n          description: Unexpected server error.\\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      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        \\\"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        \\\"500\\\":\\n          description: Unexpected server error.\\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      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        \\\"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        \\\"500\\\":\\n          description: Unexpected server error.\\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      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        \\\"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        \\\"500\\\":\\n          description: Unexpected server error.\\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      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        \\\"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        \\\"500\\\":\\n          description: Unexpected server error.\\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      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        \\\"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        \\\"500\\\":\\n          description: Unexpected server error.\\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      parameters:\\n        - name: guid\\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        \\\"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        \\\"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        \\\"500\\\":\\n          description: Unexpected server error.\\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      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        \\\"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        \\\"500\\\":\\n          description: Unexpected server error.\\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      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: 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        \\\"500\\\":\\n          description: Unexpected server error.\\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      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.\\\"\\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        \\\"500\\\":\\n          description: Unexpected server error.\\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      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        \\\"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        \\\"500\\\":\\n          description: Unexpected server error.\\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      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.\\\"\\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        \\\"500\\\":\\n          description: Unexpected server error.\\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      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.\\\"\\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        \\\"500\\\":\\n          description: Unexpected server error.\\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      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.\\\"\\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        \\\"500\\\":\\n          description: Unexpected server error.\\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      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.\\\"\\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        \\\"500\\\":\\n          description: Unexpected server error.\\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      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.\\\"\\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        \\\"500\\\":\\n          description: Unexpected server error.\\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      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.\\\"\\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        \\\"500\\\":\\n          description: Unexpected server error.\\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      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.\\\"\\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        \\\"500\\\":\\n          description: Unexpected server error.\\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      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.\\\"\\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        \\\"500\\\":\\n          description: Unexpected server error.\\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      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.\\\"\\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  \\\"/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      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.\\\"\\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        \\\"500\\\":\\n          description: Unexpected server error.\\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      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.\\\"\\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        \\\"500\\\":\\n          description: Unexpected server error.\\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      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.\\\"\\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    post:\\n      summary: Invite someone to the org. The accept URL is returned once.\\n      operationId: postOrgsByOrgIdInvites\\n      tags:\\n        - Orgs\\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-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                      - 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.\\\"\\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        \\\"500\\\":\\n          description: Unexpected server error.\\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      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.\\\"\\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        \\\"500\\\":\\n          description: Unexpected server error.\\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-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.\\\"\\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    patch:\\n      summary: Replace the org compute-server overrides.\\n      operationId: patchOrgsByOrgIdCompute\\n      tags:\\n        - Orgs\\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                        anyOf:\\n                          - type: string\\n                          - type: \\\"null\\\"\\n                      timeoutMs:\\n                        type: number\\n                      retryCount:\\n                        type: number\\n                    required:\\n                      - id\\n                      - label\\n                      - serverUrl\\n                defaultServerId:\\n                  anyOf:\\n                    - type: string\\n                    - type: \\\"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.\\\"\\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  \\\"/api/v1/orgs/{orgId}/assets/{kind}\\\":\\n    post:\\n      summary: Upload an org branding asset.\\n      operationId: postOrgsByOrgIdAssetsByKind\\n      tags:\\n        - Orgs\\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.\\\"\\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        \\\"500\\\":\\n          description: Unexpected server error.\\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-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.\\\"\\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        \\\"500\\\":\\n          description: Unexpected server error.\\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-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        \\\"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`.\\\"\\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.\\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-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.\\\"\\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        \\\"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.\\n          content:\\n            application/json:\\n              schema:\\n                $ref: \\\"#/components/schemas/Error\\\"\\n\";\n//#endregion\n//#region src/routes/docs/api/openapi.yaml/+server.ts\nvar GET = async () => new Response(v1_default, { headers: {\n\t\"Content-Type\": \"application/yaml; charset=utf-8\",\n\t\"Cache-Control\": \"public, max-age=300\"\n} });\n//#endregion\nexport { GET };\n"],"names":[],"mappings":"AAAA;AACA,IAAI,UAAU,GAAG,imsEAAimsE;AAClnsE;AACA;AACG,IAAC,GAAG,GAAG,YAAY,IAAI,QAAQ,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE;AAC1D,CAAC,cAAc,EAAE,iCAAiC;AAClD,CAAC,eAAe,EAAE;AAClB,CAAC,EAAE;;;;"}