@raster-app/sdk 0.1.0-rc.0 → 0.1.0

package/dist/__generated__/openapi.d.ts

@@ -6,32 +6,11 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** Resolve the credential's organization and library scope. */
-        get: {
-            parameters: {
-                query?: never;
-                header: {
-                    "Api-Version": components["parameters"]["ApiVersion"];
-                };
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description OK */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            data: components["schemas"]["Me"];
-                        };
-                    };
-                };
-                401: components["responses"]["Unauthorized"];
-            };
-        };
+        /**
+         * Resolve the credential's organization and library scope.
+         * @description Returns the organization the presented credential belongs to and the libraries it can reach, each with a read or write access level. Call this first to discover ids — every other operation needs an organizationId and libraryId.
+         */
+        get: operations["getMe"];
         put?: never;
         post?: never;
         delete?: never;
@@ -51,50 +30,9 @@ export interface paths {
         put?: never;
         /**
          * Create an organization, library, and API key with no account.
-         * @description Anonymous — mints the key, so send no Authorization header. https://raster.app/docs/guides/start-without-an-account
+         * @description Anonymous — mints the key, so send no Authorization header. Give it an email address and it returns a ready-to-use organization, library, API key, and a claim URL to hand the user so they can attach the library to a real account later. Use this when an agent needs somewhere to put images before the user has signed up. https://raster.app/docs/guides/start-without-an-account
          */
-        post: {
-            parameters: {
-                query?: never;
-                header: {
-                    "Api-Version": components["parameters"]["ApiVersion"];
-                };
-                path?: never;
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "application/json": {
-                        /** Format: email */
-                        email: string;
-                        name?: string;
-                    };
-                };
-            };
-            responses: {
-                /** @description OK */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            data: {
-                                organizationId: string;
-                                libraryId: string;
-                                apiKey: string;
-                                /** Format: uri */
-                                claimUrl: string;
-                                /** Format: date-time */
-                                expiresAt: string;
-                                emailSent: boolean;
-                            };
-                        };
-                    };
-                };
-                400: components["responses"]["BadRequest"];
-            };
-        };
+        post: operations["createEphemeralLibrary"];
         delete?: never;
         options?: never;
         head?: never;
@@ -108,75 +46,17 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** List libraries the key can reach. */
-        get: {
-            parameters: {
-                query?: {
-                    /** @description Zero-based page index. */
-                    page?: number;
-                    pageSize?: number;
-                };
-                header: {
-                    "Api-Version": components["parameters"]["ApiVersion"];
-                };
-                path: {
-                    organizationId: components["parameters"]["OrganizationId"];
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description OK */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            data: components["schemas"]["Library"][];
-                        };
-                    };
-                };
-                401: components["responses"]["Unauthorized"];
-            };
-        };
+        /**
+         * List libraries the credential can reach.
+         * @description Paginated list of the libraries inside one organization that the presented credential is allowed to see. Use it to resolve a human-supplied library name to the libraryId every asset operation needs.
+         */
+        get: operations["listLibraries"];
         put?: never;
-        /** Create a library in this organization. */
-        post: {
-            parameters: {
-                query?: never;
-                header: {
-                    "Api-Version": components["parameters"]["ApiVersion"];
-                };
-                path: {
-                    organizationId: components["parameters"]["OrganizationId"];
-                };
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "application/json": {
-                        name: string;
-                        slug?: string;
-                    };
-                };
-            };
-            responses: {
-                /** @description Created */
-                201: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            data: components["schemas"]["Library"];
-                        };
-                    };
-                };
-                400: components["responses"]["BadRequest"];
-                401: components["responses"]["Unauthorized"];
-            };
-        };
+        /**
+         * Create a library in this organization.
+         * @description Creates an empty library. Requires a write-scoped credential; a read-only key returns API_KEY_READ_ONLY, and the free plan returns LIBRARY_LIMIT_EXCEEDED once its library allowance is used up.
+         */
+        post: operations["createLibrary"];
         delete?: never;
         options?: never;
         head?: never;
@@ -196,41 +76,11 @@ export interface paths {
         delete?: never;
         options?: never;
         head?: never;
-        /** Rename a library. */
-        patch: {
-            parameters: {
-                query?: never;
-                header: {
-                    "Api-Version": components["parameters"]["ApiVersion"];
-                };
-                path: {
-                    organizationId: components["parameters"]["OrganizationId"];
-                    libraryId: components["parameters"]["LibraryId"];
-                };
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "application/json": {
-                        name: string;
-                    };
-                };
-            };
-            responses: {
-                /** @description OK */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            data: components["schemas"]["Library"];
-                        };
-                    };
-                };
-                404: components["responses"]["NotFound"];
-            };
-        };
+        /**
+         * Rename a library.
+         * @description Changes a library's display name. The libraryId is unchanged, so existing integrations and asset URLs keep working.
+         */
+        patch: operations["renameLibrary"];
         trace?: never;
     };
     "/organizations/{organizationId}/libraries/{libraryId}/assets": {
@@ -240,122 +90,22 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** List assets (paginated, optional tag filter). */
-        get: {
-            parameters: {
-                query?: {
-                    page?: number;
-                    pageSize?: number;
-                    /** @description Comma-separated tag filter, up to 50. */
-                    tags?: string;
-                };
-                header: {
-                    "Api-Version": components["parameters"]["ApiVersion"];
-                };
-                path: {
-                    organizationId: components["parameters"]["OrganizationId"];
-                    libraryId: components["parameters"]["LibraryId"];
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description OK */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            data: components["schemas"]["Asset"][];
-                        };
-                    };
-                };
-                401: components["responses"]["Unauthorized"];
-            };
-        };
+        /**
+         * List assets (paginated, optional tag filter).
+         * @description Pages through one library's assets, newest first, optionally narrowed to assets carrying every tag in the `tags` filter. Each asset carries a permanent public CDN `url` you can embed directly. To find an asset by what it depicts rather than by tag, use searchAssets instead.
+         */
+        get: operations["listAssets"];
         put?: never;
-        /** Upload up to 20 files. */
-        post: {
-            parameters: {
-                query?: never;
-                header: {
-                    "Api-Version": components["parameters"]["ApiVersion"];
-                };
-                path: {
-                    organizationId: components["parameters"]["OrganizationId"];
-                    libraryId: components["parameters"]["LibraryId"];
-                };
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "multipart/form-data": {
-                        files: string[];
-                        /** @description Attach the uploaded file as a variant of this asset. Send exactly one file with it. The asset must be an original in this library, of the same media kind as the file. */
-                        parentId?: string;
-                    };
-                };
-            };
-            responses: {
-                /** @description OK */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            data: {
-                                responseText: string;
-                                assets: components["schemas"]["Asset"][];
-                            };
-                        };
-                    };
-                };
-                400: components["responses"]["BadRequest"];
-            };
-        };
+        /**
+         * Upload up to 20 files.
+         * @description Uploads image or video files as multipart/form-data under the `files` field, up to 20 per call. Each returned asset carries a permanent public CDN `url` — embed that rather than re-hosting the bytes. Processing (thumbnails, AI tags, descriptions) continues after the response, so re-fetch an asset to see it fully populated.
+         */
+        post: operations["uploadAssets"];
         /**
          * Move up to 100 assets to trash (soft delete).
-         * @description Soft delete — assets stay recoverable from trash until the 30-day reaper. Trashing an asset also trashes its variants; a variant id on its own is rejected with 400.
+         * @description Soft delete — assets stay recoverable from trash for 30 days, then are permanently removed. Trashing an asset also trashes its variants; a variant id on its own is rejected with 400.
          */
-        delete: {
-            parameters: {
-                query?: never;
-                header: {
-                    "Api-Version": components["parameters"]["ApiVersion"];
-                };
-                path: {
-                    organizationId: components["parameters"]["OrganizationId"];
-                    libraryId: components["parameters"]["LibraryId"];
-                };
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "application/json": {
-                        ids: string[];
-                    };
-                };
-            };
-            responses: {
-                /** @description OK */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            data: {
-                                success: boolean;
-                                message: string;
-                                ids: string[];
-                            };
-                        };
-                    };
-                };
-            };
-        };
+        delete: operations["deleteAssets"];
         options?: never;
         head?: never;
         patch?: never;
@@ -372,35 +122,7 @@ export interface paths {
          * Get one asset by id.
          * @description Returns the full asset, including its non-destructive variants in the `variants` field; each variant carries its own tags/description — fetch a variant by its id for those.
          */
-        get: {
-            parameters: {
-                query?: never;
-                header: {
-                    "Api-Version": components["parameters"]["ApiVersion"];
-                };
-                path: {
-                    organizationId: components["parameters"]["OrganizationId"];
-                    libraryId: components["parameters"]["LibraryId"];
-                    assetId: components["parameters"]["AssetId"];
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description OK */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            data: components["schemas"]["Asset"];
-                        };
-                    };
-                };
-                404: components["responses"]["NotFound"];
-            };
-        };
+        get: operations["getAsset"];
         put?: never;
         post?: never;
         delete?: never;
@@ -422,44 +144,11 @@ export interface paths {
         delete?: never;
         options?: never;
         head?: never;
-        /** Replace one asset's description. */
-        patch: {
-            parameters: {
-                query?: never;
-                header: {
-                    "Api-Version": components["parameters"]["ApiVersion"];
-                };
-                path: {
-                    organizationId: components["parameters"]["OrganizationId"];
-                    libraryId: components["parameters"]["LibraryId"];
-                    assetId: components["parameters"]["AssetId"];
-                };
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "application/json": {
-                        description: string;
-                    };
-                };
-            };
-            responses: {
-                /** @description OK */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            data: {
-                                assetId: string;
-                                description: string;
-                            };
-                        };
-                    };
-                };
-            };
-        };
+        /**
+         * Replace one asset's description.
+         * @description Overwrites the asset's description with the supplied text — this is a replace, not an append. Descriptions are indexed, so a good one makes the asset findable through searchAssets.
+         */
+        patch: operations["updateAssetDescription"];
         trace?: never;
     };
     "/organizations/{organizationId}/libraries/{libraryId}/assets/{assetId}/promote": {
@@ -473,53 +162,16 @@ export interface paths {
         put?: never;
         /**
          * Make a variant the asset's default.
-         * @description The variant's pixels replace what the asset serves, at the SAME URL, so anything already embedding that URL shows the new file. The previous default is preserved as a new variant and keeps the name it had; the asset keeps its id and URL and takes the promoted variant's name. Its description and the tags generated from its image follow the picture — the promoted variant hands over any it carries, and the preserved variant keeps the ones that described it, while tags you added yourself stay on the asset. Rejected while the asset is itself still being processed (a video whose poster has not landed yet). The promote is accepted and the swap completes a moment later; re-fetch the asset to see it reflected.
+         * @description The variant's pixels replace what the asset serves, at the SAME URL, so anything already embedding that URL shows the new file. The previous default is preserved as a new variant and keeps the name it had; the asset keeps its id and URL and takes the promoted variant's name. Its description and the tags generated from its image follow the picture — the promoted variant hands over any it carries, and the preserved variant keeps the ones that described it, while tags you added yourself stay on the asset. Rejected while the asset is a video that is still being processed. The promote is accepted and the swap completes a moment later; re-fetch the asset to see it reflected.
          */
-        post: {
-            parameters: {
-                query?: never;
-                header: {
-                    "Api-Version": components["parameters"]["ApiVersion"];
-                };
-                path: {
-                    organizationId: components["parameters"]["OrganizationId"];
-                    libraryId: components["parameters"]["LibraryId"];
-                    assetId: components["parameters"]["AssetId"];
-                };
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "application/json": {
-                        variantId: string;
-                    };
-                };
-            };
-            responses: {
-                /** @description OK */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            data: {
-                                assetId: string;
-                                promotedVariantId: string;
-                                demotedVariantId: string;
-                            };
-                        };
-                    };
-                };
-            };
-        };
+        post: operations["promoteVariant"];
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/organizations/{organizationId}/libraries/{libraryId}/assets/tag": {
+    "/organizations/{organizationId}/libraries/{libraryId}/assets/{assetId}/approval": {
         parameters: {
             query?: never;
             header?: never;
@@ -528,43 +180,31 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** Apply up to 20 tags to up to 100 assets. */
-        post: {
-            parameters: {
-                query?: never;
-                header: {
-                    "Api-Version": components["parameters"]["ApiVersion"];
-                };
-                path: {
-                    organizationId: components["parameters"]["OrganizationId"];
-                    libraryId: components["parameters"]["LibraryId"];
-                };
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "application/json": {
-                        assetIds: string[];
-                        tags: string[];
-                    };
-                };
-            };
-            responses: {
-                /** @description OK */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            data: {
-                                taggedCount: number;
-                            };
-                        };
-                    };
-                };
-            };
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        /**
+         * Set one asset's approval state.
+         * @description Sets the asset's approval to one of the organization's approval states, with an optional note; each call replaces the previous approval. Works on an original or a variant. Needs an OAuth access token — an API key can read approval but not set it (403 APPROVAL_REQUIRES_USER). Setting approval needs a paid plan (403 PAID_PLAN_REQUIRED).
+         */
+        patch: operations["setAssetApproval"];
+        trace?: never;
+    };
+    "/organizations/{organizationId}/libraries/{libraryId}/assets/tag": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
         };
+        get?: never;
+        put?: never;
+        /**
+         * Apply up to 20 tags to up to 100 assets.
+         * @description Adds tags to assets in bulk. Tags already present are left alone, so the call is safe to repeat. Tags are how listAssets filters, and they feed searchAssets ranking.
+         */
+        post: operations["tagAssets"];
         delete?: never;
         options?: never;
         head?: never;
@@ -580,43 +220,11 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** Remove up to 20 tags from up to 100 assets. */
-        post: {
-            parameters: {
-                query?: never;
-                header: {
-                    "Api-Version": components["parameters"]["ApiVersion"];
-                };
-                path: {
-                    organizationId: components["parameters"]["OrganizationId"];
-                    libraryId: components["parameters"]["LibraryId"];
-                };
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "application/json": {
-                        assetIds: string[];
-                        tags: string[];
-                    };
-                };
-            };
-            responses: {
-                /** @description OK */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            data: {
-                                untaggedCount: number;
-                            };
-                        };
-                    };
-                };
-            };
-        };
+        /**
+         * Remove up to 20 tags from up to 100 assets.
+         * @description Removes tags from assets in bulk. Tags that were not present are ignored, so the call is safe to repeat. Only the named tags are removed; every other tag on the asset stays.
+         */
+        post: operations["untagAssets"];
         delete?: never;
         options?: never;
         head?: never;
@@ -634,46 +242,9 @@ export interface paths {
         put?: never;
         /**
          * Move up to 100 assets to another library.
-         * @description An asset's variants move with it; a variant cannot be transferred on its own — transfer its original and the variants follow.
+         * @description Moves assets from the library in the path to another library in the same organization. An asset's variants move with it; a variant cannot be transferred on its own — transfer its original and the variants follow. The credential needs write access to both libraries.
          */
-        post: {
-            parameters: {
-                query?: never;
-                header: {
-                    "Api-Version": components["parameters"]["ApiVersion"];
-                };
-                path: {
-                    organizationId: components["parameters"]["OrganizationId"];
-                    libraryId: components["parameters"]["LibraryId"];
-                };
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "application/json": {
-                        targetLibraryId: string;
-                        assetIds: string[];
-                    };
-                };
-            };
-            responses: {
-                /** @description OK */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            data: {
-                                transferredCount: number;
-                                sourceLibraryId: string;
-                                targetLibraryId: string;
-                            };
-                        };
-                    };
-                };
-            };
-        };
+        post: operations["transferAssets"];
         delete?: never;
         options?: never;
         head?: never;
@@ -687,36 +258,11 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** List a library's tags by usage count. */
-        get: {
-            parameters: {
-                query?: {
-                    limit?: number;
-                };
-                header: {
-                    "Api-Version": components["parameters"]["ApiVersion"];
-                };
-                path: {
-                    organizationId: components["parameters"]["OrganizationId"];
-                    libraryId: components["parameters"]["LibraryId"];
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description OK */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            data: components["schemas"]["Tag"][];
-                        };
-                    };
-                };
-            };
-        };
+        /**
+         * List a library's tags by usage count.
+         * @description The library's tag vocabulary, most-used first. Read it before tagging so you reuse the team's existing tags instead of inventing near-duplicates, and to discover what a `tags` filter on listAssets can select.
+         */
+        get: operations["listTags"];
         put?: never;
         post?: never;
         delete?: never;
@@ -732,39 +278,11 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** Search assets across libraries (ranked, highlighted). */
-        get: {
-            parameters: {
-                query: {
-                    q: string;
-                    /** @description Comma-separated library ids. */
-                    libraries?: string;
-                    page?: number;
-                    pageSize?: number;
-                };
-                header: {
-                    "Api-Version": components["parameters"]["ApiVersion"];
-                };
-                path: {
-                    organizationId: components["parameters"]["OrganizationId"];
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description OK */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            data: components["schemas"]["SearchResult"];
-                        };
-                    };
-                };
-            };
-        };
+        /**
+         * Search assets across libraries (ranked, highlighted).
+         * @description Full-text, relevance-ranked search over filenames, descriptions, and tags across every library the credential can reach, or the subset named in `libraries`. This is the right call for a natural-language request such as "the photo of the blue packaging" — use listAssets when you already know the exact tag to filter on.
+         */
+        get: operations["searchAssets"];
         put?: never;
         post?: never;
         delete?: never;
@@ -853,10 +371,9 @@ export interface components {
              */
             variants: (components["schemas"]["AssetVariant"] | null)[] | null;
             /**
-             * @description The parentId-model discriminator: `null` on a top-level original, the parent
-             *     asset's id on a variant. A variant is a first-class Asset — tag-filtered and search
-             *     queries return it as its own entry — and `parentId` relates it back to its
-             *     original. May be `null` for originals uploaded before the delta-001 backfill.
+             * @description `null` on a top-level original, the parent asset's id on a variant. A variant
+             *     is a first-class Asset — tag-filtered and search queries return it as its own
+             *     entry — and `parentId` relates it back to its original.
              */
             parentId: string | null;
             description: string | null;
@@ -869,7 +386,7 @@ export interface components {
             /** @description File size in bytes. May be `null` for older assets with no recorded size. */
             size: number | null;
             /**
-             * @description Length of the asset in seconds, for video and audio. `null` on images and on
+             * @description Length of the asset in seconds, for video. `null` on images and on
              *     videos still being processed.
              */
             duration: number | null;
@@ -889,11 +406,10 @@ export interface components {
             /**
              * @description Counter bumped each time the asset's BYTES are replaced at an unchanged
              *     url — a promoted variant, an edit re-save. Append it to any `url` or
-             *     `sizes` entry as `?v=` to render the current pixels: the same url keeps
-             *     serving the previous bytes to every cache that already holds it.
+             *     `sizes` entry as `?v=` to render the current pixels.
              *
              *     Null on an asset whose bytes have never been replaced — render the bare
-             *     url there, so those assets keep the cache entry they already have.
+             *     url there.
              */
             contentVersion: number | null;
             /** @description Attribution metadata for the user who uploaded the asset. */
@@ -962,7 +478,7 @@ export interface components {
         /** @description An asset's approval (delivery) state — who set it, when, and why. */
         Approval: {
             state: string;
-            /** @description Email address of the person who set the approval. `null` on a search hit, or when their account has no email address. */
+            /** @description Email address of the person who set the approval. `null` when their account has no email address. */
             setBy: string | null;
             setAt: number | null;
             note?: string;
@@ -1054,7 +570,7 @@ export interface components {
         };
     };
     responses: {
-        /** @description Missing or invalid API key. */
+        /** @description Missing or invalid API key or access token. */
         Unauthorized: {
             headers: {
                 [name: string]: unknown;
@@ -1063,7 +579,16 @@ export interface components {
                 "application/json": components["schemas"]["Error"];
             };
         };
-        /** @description Resource not found, or the key is not authorized for it. */
+        /** @description The credential may not perform this operation, or the organization's plan does not allow it. A key without access to a library gets 404, not 403. */
+        Forbidden: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["Error"];
+            };
+        };
+        /** @description Resource not found, or the credential is not authorized for it. */
         NotFound: {
             headers: {
                 [name: string]: unknown;
@@ -1081,6 +606,30 @@ export interface components {
                 "application/json": components["schemas"]["Error"];
             };
         };
+        /** @description Rate limit exceeded. Wait for the number of seconds in `Retry-After` before retrying. */
+        TooManyRequests: {
+            headers: {
+                /** @description Seconds to wait before retrying. */
+                "Retry-After"?: number;
+                /** @description Remaining quota for the active policy, e.g. `"key";r=0;t=17`. The legacy `RateLimit-Limit` / `-Remaining` / `-Reset` triplet is sent alongside it. */
+                RateLimit?: string;
+                /** @description The quota policy in force, e.g. `"key";q=600;w=60`. */
+                "RateLimit-Policy"?: string;
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["Error"];
+            };
+        };
+        /** @description Unexpected server fault (INTERNAL_SERVER_ERROR). Safe to retry an idempotent operation. */
+        ServerError: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["Error"];
+            };
+        };
     };
     parameters: {
         ApiVersion: string;
@@ -1093,4 +642,690 @@ export interface components {
     pathItems: never;
 }
 export type $defs = Record<string, never>;
-export type operations = Record<string, never>;
+export interface operations {
+    getMe: {
+        parameters: {
+            query?: never;
+            header: {
+                "Api-Version": components["parameters"]["ApiVersion"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["Me"];
+                    };
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            429: components["responses"]["TooManyRequests"];
+            500: components["responses"]["ServerError"];
+        };
+    };
+    createEphemeralLibrary: {
+        parameters: {
+            query?: never;
+            header: {
+                "Api-Version": components["parameters"]["ApiVersion"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** Format: email */
+                    email: string;
+                    name?: string;
+                };
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: {
+                            organizationId: string;
+                            libraryId: string;
+                            apiKey: string;
+                            /** Format: uri */
+                            claimUrl: string;
+                            /** Format: date-time */
+                            expiresAt: string;
+                            emailSent: boolean;
+                        };
+                    };
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            500: components["responses"]["ServerError"];
+        };
+    };
+    listLibraries: {
+        parameters: {
+            query?: {
+                /** @description Zero-based page index. */
+                page?: number;
+                pageSize?: number;
+            };
+            header: {
+                "Api-Version": components["parameters"]["ApiVersion"];
+            };
+            path: {
+                organizationId: components["parameters"]["OrganizationId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["Library"][];
+                    };
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            429: components["responses"]["TooManyRequests"];
+            500: components["responses"]["ServerError"];
+        };
+    };
+    createLibrary: {
+        parameters: {
+            query?: never;
+            header: {
+                "Api-Version": components["parameters"]["ApiVersion"];
+            };
+            path: {
+                organizationId: components["parameters"]["OrganizationId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    name: string;
+                    slug?: string;
+                };
+            };
+        };
+        responses: {
+            /** @description Created */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["Library"];
+                    };
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            429: components["responses"]["TooManyRequests"];
+            500: components["responses"]["ServerError"];
+        };
+    };
+    renameLibrary: {
+        parameters: {
+            query?: never;
+            header: {
+                "Api-Version": components["parameters"]["ApiVersion"];
+            };
+            path: {
+                organizationId: components["parameters"]["OrganizationId"];
+                libraryId: components["parameters"]["LibraryId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    name: string;
+                };
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["Library"];
+                    };
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            429: components["responses"]["TooManyRequests"];
+            500: components["responses"]["ServerError"];
+        };
+    };
+    listAssets: {
+        parameters: {
+            query?: {
+                page?: number;
+                pageSize?: number;
+                /** @description Comma-separated tag filter, up to 50. */
+                tags?: string;
+            };
+            header: {
+                "Api-Version": components["parameters"]["ApiVersion"];
+            };
+            path: {
+                organizationId: components["parameters"]["OrganizationId"];
+                libraryId: components["parameters"]["LibraryId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["Asset"][];
+                    };
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            429: components["responses"]["TooManyRequests"];
+            500: components["responses"]["ServerError"];
+        };
+    };
+    uploadAssets: {
+        parameters: {
+            query?: never;
+            header: {
+                "Api-Version": components["parameters"]["ApiVersion"];
+            };
+            path: {
+                organizationId: components["parameters"]["OrganizationId"];
+                libraryId: components["parameters"]["LibraryId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "multipart/form-data": {
+                    files: string[];
+                    /** @description Attach the uploaded file as a variant of this asset. Send exactly one file with it. The asset must be an original in this library, of the same media kind as the file. */
+                    parentId?: string;
+                };
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: {
+                            responseText: string;
+                            assets: components["schemas"]["Asset"][];
+                        };
+                    };
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            429: components["responses"]["TooManyRequests"];
+            500: components["responses"]["ServerError"];
+        };
+    };
+    deleteAssets: {
+        parameters: {
+            query?: never;
+            header: {
+                "Api-Version": components["parameters"]["ApiVersion"];
+            };
+            path: {
+                organizationId: components["parameters"]["OrganizationId"];
+                libraryId: components["parameters"]["LibraryId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    ids: string[];
+                };
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: {
+                            success: boolean;
+                            message: string;
+                            ids: string[];
+                        };
+                    };
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            429: components["responses"]["TooManyRequests"];
+            500: components["responses"]["ServerError"];
+        };
+    };
+    getAsset: {
+        parameters: {
+            query?: never;
+            header: {
+                "Api-Version": components["parameters"]["ApiVersion"];
+            };
+            path: {
+                organizationId: components["parameters"]["OrganizationId"];
+                libraryId: components["parameters"]["LibraryId"];
+                assetId: components["parameters"]["AssetId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["Asset"];
+                    };
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            429: components["responses"]["TooManyRequests"];
+            500: components["responses"]["ServerError"];
+        };
+    };
+    updateAssetDescription: {
+        parameters: {
+            query?: never;
+            header: {
+                "Api-Version": components["parameters"]["ApiVersion"];
+            };
+            path: {
+                organizationId: components["parameters"]["OrganizationId"];
+                libraryId: components["parameters"]["LibraryId"];
+                assetId: components["parameters"]["AssetId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    description: string;
+                };
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: {
+                            assetId: string;
+                            description: string;
+                        };
+                    };
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            429: components["responses"]["TooManyRequests"];
+            500: components["responses"]["ServerError"];
+        };
+    };
+    promoteVariant: {
+        parameters: {
+            query?: never;
+            header: {
+                "Api-Version": components["parameters"]["ApiVersion"];
+            };
+            path: {
+                organizationId: components["parameters"]["OrganizationId"];
+                libraryId: components["parameters"]["LibraryId"];
+                assetId: components["parameters"]["AssetId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    variantId: string;
+                };
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: {
+                            assetId: string;
+                            promotedVariantId: string;
+                            demotedVariantId: string;
+                        };
+                    };
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            429: components["responses"]["TooManyRequests"];
+            500: components["responses"]["ServerError"];
+        };
+    };
+    setAssetApproval: {
+        parameters: {
+            query?: never;
+            header: {
+                "Api-Version": components["parameters"]["ApiVersion"];
+            };
+            path: {
+                organizationId: components["parameters"]["OrganizationId"];
+                libraryId: components["parameters"]["LibraryId"];
+                assetId: components["parameters"]["AssetId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    state: string;
+                    note?: string | null;
+                };
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: {
+                            assetId: string;
+                            approval: {
+                                state: string;
+                                /** @description Email address of the person who set the approval. `null` when their account has no email address. */
+                                setBy: string | null;
+                                setAt: number;
+                                note?: string;
+                            };
+                        };
+                    };
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            429: components["responses"]["TooManyRequests"];
+            500: components["responses"]["ServerError"];
+        };
+    };
+    tagAssets: {
+        parameters: {
+            query?: never;
+            header: {
+                "Api-Version": components["parameters"]["ApiVersion"];
+            };
+            path: {
+                organizationId: components["parameters"]["OrganizationId"];
+                libraryId: components["parameters"]["LibraryId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    assetIds: string[];
+                    tags: string[];
+                };
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: {
+                            taggedCount: number;
+                        };
+                    };
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            429: components["responses"]["TooManyRequests"];
+            500: components["responses"]["ServerError"];
+        };
+    };
+    untagAssets: {
+        parameters: {
+            query?: never;
+            header: {
+                "Api-Version": components["parameters"]["ApiVersion"];
+            };
+            path: {
+                organizationId: components["parameters"]["OrganizationId"];
+                libraryId: components["parameters"]["LibraryId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    assetIds: string[];
+                    tags: string[];
+                };
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: {
+                            untaggedCount: number;
+                        };
+                    };
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            429: components["responses"]["TooManyRequests"];
+            500: components["responses"]["ServerError"];
+        };
+    };
+    transferAssets: {
+        parameters: {
+            query?: never;
+            header: {
+                "Api-Version": components["parameters"]["ApiVersion"];
+            };
+            path: {
+                organizationId: components["parameters"]["OrganizationId"];
+                libraryId: components["parameters"]["LibraryId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    targetLibraryId: string;
+                    assetIds: string[];
+                };
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: {
+                            transferredCount: number;
+                            sourceLibraryId: string;
+                            targetLibraryId: string;
+                        };
+                    };
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            429: components["responses"]["TooManyRequests"];
+            500: components["responses"]["ServerError"];
+        };
+    };
+    listTags: {
+        parameters: {
+            query?: {
+                limit?: number;
+            };
+            header: {
+                "Api-Version": components["parameters"]["ApiVersion"];
+            };
+            path: {
+                organizationId: components["parameters"]["OrganizationId"];
+                libraryId: components["parameters"]["LibraryId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["Tag"][];
+                    };
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            429: components["responses"]["TooManyRequests"];
+            500: components["responses"]["ServerError"];
+        };
+    };
+    searchAssets: {
+        parameters: {
+            query: {
+                q: string;
+                /** @description Comma-separated library ids. */
+                libraries?: string;
+                page?: number;
+                pageSize?: number;
+                /** @description Only assets in this approval state; `none` matches assets with no approval. */
+                approval?: "in_review" | "approved" | "needs_changes" | "none";
+            };
+            header: {
+                "Api-Version": components["parameters"]["ApiVersion"];
+            };
+            path: {
+                organizationId: components["parameters"]["OrganizationId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["SearchResult"];
+                    };
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            429: components["responses"]["TooManyRequests"];
+            500: components["responses"]["ServerError"];
+        };
+    };
+}