@37signals/basecamp 0.25.0 → 0.27.0

package/dist/generated/schema.d.ts

@@ -86,7 +86,14 @@ export interface paths {
         };
         /** @description Get a single boost */
         get: operations["GetBoost"];
-        put?: never;
+        /**
+         * @description Replace the content of a boost. Only the boost's creator may update it: an
+         *     admin updating someone else's boost gets 403 Forbidden, as does any caller
+         *     when comments are closed on the boosted recording. A boost on a deleted
+         *     recording, or in another account, answers 404. A missing or invalid
+         *     `content` answers a bodiless 422. There is no bucket-scoped route.
+         */
+        put: operations["UpdateBoost"];
         post?: never;
         /** @description Delete a boost */
         delete: operations["DeleteBoost"];
@@ -138,10 +145,14 @@ export interface paths {
             cookie?: never;
         };
         get?: never;
-        /** @description Update a wormhole's destination column */
+        /** @description Point a card table's wormhole, its shortcut for sending cards to another card table, at a different destination column */
         put: operations["UpdateWormhole"];
         post?: never;
-        /** @description Delete a wormhole */
+        /**
+         * @description Permanently delete a card table's wormhole, the shortcut that sends cards to another card table.
+         *
+         *     It does not go to the trash and cannot be restored.
+         */
         delete: operations["DeleteWormhole"];
         options?: never;
         head?: never;
@@ -158,10 +169,12 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * @description Create a wormhole linking this card table to a column on another card table.
+         * @description Add a wormhole to a card table: a standing shortcut that sends cards to a column on another card table, usually in another project.
          *
          *     A wormhole is the only mechanism for moving a card to a different project: its
-         *     id is a valid `column_id` for MoveCard, teleporting the card across projects.
+         *     id is a valid `column_id` for MoveCard, teleporting the card there. It is not
+         *     needed for a one-off move within a project; MoveCard goes to any column there
+         *     directly. A card table holds at most four wormholes.
          *     `destinationRecordingId` is the id of a column on another accessible card table.
          */
         post: operations["CreateWormhole"];
@@ -533,7 +546,18 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** @description Move a card to a different column */
+        /**
+         * @description Move a card to any column in its project, including on another card table there, or through a linked wormhole to another project (queued: the card gets a new id, and position, if sent, must still be positive but doesn't set placement).
+         *
+         *     `column_id` may be any column in the card's project, including a column on
+         *     another card table in the same project; the card moves there directly, with
+         *     no wormhole needed. To send the card to another project, pass the id of a
+         *     linked wormhole (`linked: true`) the card table already has, listed in
+         *     GetCardTable's `wormholes`; an unlinked or unreachable one returns not found.
+         *     A move through a wormhole is queued: the card arrives under a new id and its
+         *     old id then returns not found. `position` does not control where it lands,
+         *     but if supplied it must still be a positive integer.
+         */
         post: operations["MoveCard"];
         delete?: never;
         options?: never;
@@ -960,6 +984,44 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/circles.json": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * @description Get Pings: the caller's active Pings that have a line in them, most
+         *     recently updated first, in one unpaginated response. Archived Pings, and
+         *     Pings no one has posted in yet, are not listed; GetPing reads either by id.
+         *
+         *     Answers `403 Forbidden` (`{"error": "Pings have been disabled"}`) when the
+         *     caller cannot ping.
+         */
+        get: operations["ListPings"];
+        put?: never;
+        /**
+         * @description Create a Ping with people, or return the one that already holds exactly
+         *     them.
+         *
+         *     The caller is always included. Without `new_group`, an existing active
+         *     Ping with exactly these people (the oldest, if several) is returned rather
+         *     than a second one created; with `new_group: true` and more than one other
+         *     person, a new group is created every time. Either way the answer is
+         *     `201 Created` with the Ping.
+         *
+         *     Answers `403 Forbidden` (`{"error": "Pings have been disabled"}`) when the
+         *     caller cannot ping, and a bodiless `422` when nobody in the Ping would be a
+         *     person who can ping.
+         */
+        post: operations["CreatePing"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/circles/people.json": {
         parameters: {
             query?: never;
@@ -982,6 +1044,29 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/circles/{pingId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * @description Get a Ping by its id, which is its bucket's id.
+         *
+         *     Answers `403 Forbidden` (`{"error": "Pings have been disabled"}`) when the
+         *     caller cannot ping, and `404 Not Found` for a bucket that is not a Ping the
+         *     caller is in.
+         */
+        get: operations["GetPing"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/client/approvals/{approvalId}": {
         parameters: {
             query?: never;
@@ -1146,6 +1231,58 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/embeds.json": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * @description Create an embed for a URL, or return the one Basecamp already has for it.
+         *
+         *     Answers `200 OK` with the embed either way. A new embed's status is
+         *     `pending`; get it about once a second until its status is `active` or
+         *     `not_found`.
+         *
+         *     Answers `422` (`{"error": "Basecamp can't embed this URL. Link to it
+         *     instead."}`) for a URL no provider embeds. Past 100 new embeds in an hour,
+         *     creating another answers `429` (`{"error": "Too many new embeds. Try again
+         *     later."}`) with no Retry-After; asking for an embed Basecamp already has
+         *     still works. That 429 is a verdict for the rest of the hour, not
+         *     throttling, so this operation declares `retryOn: [503]` and the 429
+         *     surfaces on the first attempt.
+         */
+        post: operations["CreateEmbed"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/embeds/{sgid}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * @description Get an embed by its sgid.
+         *
+         *     Answers `404 Not Found` for an sgid that does not name an embed.
+         */
+        get: operations["GetEmbed"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/events.json": {
         parameters: {
             query?: never;
@@ -2180,7 +2317,7 @@ export interface paths {
          *     and re-asking cannot change the answer, so this operation declares
          *     `retryOn: [503]` and a 429 surfaces on the first attempt (status-mapped to
          *     `rate_limit`, since the wire status is the only signal). Every other
-         *     operation retries on 429.
+         *     operation but CreateEmbed retries on 429.
          */
         put: operations["UpdateProjectClientAccess"];
         post?: never;
@@ -4260,6 +4397,13 @@ export interface components {
             creator: components["schemas"]["Person"];
             subscribers?: components["schemas"]["Person"][];
             lists?: components["schemas"]["CardColumn"][];
+            /**
+             * @description The card table's wormholes: shortcuts for sending cards to other card
+             *     tables, usually in other projects. Only wormholes whose destination the
+             *     requester can reach are listed; the rest are omitted, not shown unlinked.
+             *     Not needed to move a card within its project; MoveCard reaches any column
+             *     there directly.
+             */
             wormholes?: components["schemas"]["Wormhole"][];
         };
         Chatbot: {
@@ -4576,6 +4720,11 @@ export interface components {
             visible_to_clients?: boolean;
         };
         CreateDocumentResponseContent: components["schemas"]["Document"];
+        CreateEmbedRequestContent: {
+            /** @description The URL of the content to embed. */
+            url: string;
+        };
+        CreateEmbedResponseContent: components["schemas"]["Embed"];
         CreateEventBoostRequestContent: {
             content: string;
         };
@@ -4660,6 +4809,16 @@ export interface components {
             /** Format: password */
             company_name?: string;
         };
+        CreatePingRequestContent: {
+            /**
+             * @description Person ids of the people to ping. People the caller cannot reach are
+             *     dropped.
+             */
+            user_ids: number[];
+            /** @description Create a new group even when a Ping with exactly these people exists. */
+            new_group?: boolean;
+        };
+        CreatePingResponseContent: components["schemas"]["Ping"];
         CreateProjectFromTemplateRequestContent: {
             project: components["schemas"]["ProjectConstructionAttributes"];
         };
@@ -5023,6 +5182,39 @@ export interface components {
             title: string;
             app_url: string;
         };
+        /**
+         * @description Content from another site, such as a YouTube video, that rich text shows
+         *     inline. Put it in rich text as `<bc-attachment sgid="SGID"></bc-attachment>`
+         *     once its status is `active`; an embed that is not active shows as a link to
+         *     its URL.
+         */
+        Embed: {
+            url: string;
+            /**
+             * @description `pending` while Basecamp asks the provider about the URL, then `active`,
+             *     or `not_found` when the provider has nothing to embed.
+             */
+            status: string;
+            /** @description An embed's signed global id, an opaque string. */
+            sgid: string;
+            /**
+             * @description The provider's oEmbed type, such as `video`, `rich` or `photo`. Present
+             *     only when the embed is active.
+             */
+            type?: string;
+            /** @description Such as `embed/youtube-video`. Present only when the embed is active. */
+            content_type?: string;
+            /**
+             * @description Present only when the embed is active, and null when the provider gave no
+             *     image.
+             */
+            image_url?: string | null;
+            /**
+             * @description The provider's HTML, sanitized. Present only when the embed is active and
+             *     the provider gave HTML; may be empty.
+             */
+            content?: string;
+        };
         EnableCardColumnOnHoldResponseContent: components["schemas"]["CardColumn"];
         EnableOutOfOfficeRequestContent: {
             out_of_office: components["schemas"]["OutOfOfficePayload"];
@@ -5503,6 +5695,7 @@ export interface components {
         GetCloudFileResponseContent: components["schemas"]["CloudFile"];
         GetCommentResponseContent: components["schemas"]["Comment"];
         GetDocumentResponseContent: components["schemas"]["Document"];
+        GetEmbedResponseContent: components["schemas"]["Embed"];
         GetEverythingCheckinsResponseContent: components["schemas"]["Recording"][];
         GetEverythingCommentsResponseContent: components["schemas"]["Recording"][];
         GetEverythingCompletedCardsResponseContent: components["schemas"]["BucketCardsGroup"][];
@@ -5585,6 +5778,7 @@ export interface components {
             events: components["schemas"]["TimelineEvent"][];
         };
         GetPersonResponseContent: components["schemas"]["Person"];
+        GetPingResponseContent: components["schemas"]["Ping"];
         GetProgressReportResponseContent: components["schemas"]["TimelineEvent"][];
         GetProjectConstructionResponseContent: components["schemas"]["ProjectConstruction"];
         GetProjectResponseContent: components["schemas"]["Project"];
@@ -5779,6 +5973,7 @@ export interface components {
         ListMyDraftsResponseContent: components["schemas"]["Draft"][];
         ListPeopleResponseContent: components["schemas"]["Person"][];
         ListPingablePeopleResponseContent: components["schemas"]["Person"][];
+        ListPingsResponseContent: components["schemas"]["Ping"][];
         ListProjectPeopleResponseContent: components["schemas"]["Person"][];
         ListProjectsResponseContent: components["schemas"]["Project"][];
         ListQuestionAnswerersResponseContent: components["schemas"]["Person"][];
@@ -5882,7 +6077,11 @@ export interface components {
             position?: number;
         };
         MoveCardRequestContent: {
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Any column in the card's project, on this or another card table, or a
+             *     wormhole id to send the card to another project.
+             */
             column_id: number;
             /**
              * Format: int32
@@ -6122,6 +6321,59 @@ export interface components {
             /** Format: password */
             name: string;
         };
+        /**
+         * @description A Ping: a private conversation between people, held in its own bucket with
+         *     one Campfire. The Campfire's lines are read and written through the
+         *     Campfires service; `room_url` and `links.lines` name it.
+         */
+        Ping: {
+            /**
+             * Format: int64
+             * @description The Ping's id, which is also its bucket's id.
+             */
+            id: number;
+            created_at: string;
+            updated_at: string;
+            /**
+             * @description The Ping's name for the caller: its given name when `named`, else the
+             *     names of the other people in it.
+             */
+            title: string;
+            /** @description Whether someone gave the Ping a name. */
+            named: boolean;
+            /** @description The Ping's own image, present only when one was uploaded. */
+            image_url?: string;
+            /** Format: password */
+            avatar_url: string;
+            url: string;
+            app_url: string;
+            bookmark_url: string;
+            /** @description The Ping's Campfire (`/buckets/{bucketId}/chats/{campfireId}.json`). */
+            room_url: string;
+            /**
+             * @description Present only when the Ping can be renamed: one with more than one other
+             *     person in it.
+             */
+            edit_title_url?: string;
+            links: components["schemas"]["PingLinks"];
+            /**
+             * @description The people in the Ping other than the caller; the caller alone when
+             *     nobody else is in it.
+             */
+            people: components["schemas"]["Person"][];
+        };
+        /**
+         * @description The Ping's Campfire endpoints, so a client need not derive them from
+         *     `room_url`. The wire object also repeats `url`, `app_url`, `bookmark_url`
+         *     and `edit_title_url` as `self`, `app`, `bookmark` and `edit_title`; those
+         *     are read from the Ping's own fields.
+         */
+        PingLinks: {
+            /** @description The Campfire's lines (`/buckets/{bucketId}/chats/{campfireId}/lines.json`). */
+            lines: string;
+            /** @description The Campfire's uploads. */
+            files: string;
+        };
         /**
          * @description The poll envelope. Every 200 carries `events` and `position`; `next` only
          *     while the walk continues.
@@ -7886,6 +8138,10 @@ export interface components {
             name: string;
         };
         UpdateAccountNameResponseContent: components["schemas"]["Account"];
+        UpdateBoostRequestContent: {
+            content: string;
+        };
+        UpdateBoostResponseContent: components["schemas"]["Boost"];
         UpdateCalendarRequestContent: {
             calendar: components["schemas"]["CalendarAttributes"];
         };
@@ -8304,8 +8560,9 @@ export interface components {
             message?: string;
         };
         /**
-         * @description A wormhole links this card table to a column on another card table, enabling
-         *     cards to move across projects. It carries the full recording representation
+         * @description A wormhole is a standing shortcut from this card table to a column on another
+         *     card table, usually in another project, and the only way to move a card across
+         *     projects. It carries the full recording representation
          *     plus the destination-linkage fields. The wormhole's own `url`/`app_url`/`parent`
          *     point at the *source* board; `destination_url` is the only field identifying
          *     the destination column.
@@ -8741,6 +8998,75 @@ export interface operations {
             };
         };
     };
+    UpdateBoost: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                boostId: number;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateBoostRequestContent"];
+            };
+        };
+        responses: {
+            /** @description UpdateBoost 200 response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["UpdateBoostResponseContent"];
+                };
+            };
+            /** @description UnauthorizedError 401 response */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["UnauthorizedErrorResponseContent"];
+                };
+            };
+            /** @description ForbiddenError 403 response */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ForbiddenErrorResponseContent"];
+                };
+            };
+            /** @description NotFoundError 404 response */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["NotFoundErrorResponseContent"];
+                };
+            };
+            /** @description BareValidationError 422 response */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description InternalServerError 500 response */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["InternalServerErrorResponseContent"];
+                };
+            };
+        };
+    };
     DeleteBoost: {
         parameters: {
             query?: never;
@@ -13005,7 +13331,7 @@ export interface operations {
             };
         };
     };
-    ListPingablePeople: {
+    ListPings: {
         parameters: {
             query?: never;
             header?: never;
@@ -13014,13 +13340,13 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description ListPingablePeople 200 response */
+            /** @description ListPings 200 response */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ListPingablePeopleResponseContent"];
+                    "application/json": components["schemas"]["ListPingsResponseContent"];
                 };
             };
             /** @description UnauthorizedError 401 response */
@@ -13061,24 +13387,26 @@ export interface operations {
             };
         };
     };
-    GetClientApproval: {
+    CreatePing: {
         parameters: {
             query?: never;
             header?: never;
-            path: {
-                approvalId: number;
-            };
+            path?: never;
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreatePingRequestContent"];
+            };
+        };
         responses: {
-            /** @description GetClientApproval 200 response */
-            200: {
+            /** @description CreatePing 201 response */
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["GetClientApprovalResponseContent"];
+                    "application/json": components["schemas"]["CreatePingResponseContent"];
                 };
             };
             /** @description UnauthorizedError 401 response */
@@ -13099,13 +13427,20 @@ export interface operations {
                     "application/json": components["schemas"]["ForbiddenErrorResponseContent"];
                 };
             };
-            /** @description NotFoundError 404 response */
-            404: {
+            /** @description BareValidationError 422 response */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description RateLimitError 429 response */
+            429: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["NotFoundErrorResponseContent"];
+                    "application/json": components["schemas"]["RateLimitErrorResponseContent"];
                 };
             };
             /** @description InternalServerError 500 response */
@@ -13119,24 +13454,22 @@ export interface operations {
             };
         };
     };
-    GetClientCorrespondence: {
+    ListPingablePeople: {
         parameters: {
             query?: never;
             header?: never;
-            path: {
-                correspondenceId: number;
-            };
+            path?: never;
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description GetClientCorrespondence 200 response */
+            /** @description ListPingablePeople 200 response */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["GetClientCorrespondenceResponseContent"];
+                    "application/json": components["schemas"]["ListPingablePeopleResponseContent"];
                 };
             };
             /** @description UnauthorizedError 401 response */
@@ -13157,13 +13490,13 @@ export interface operations {
                     "application/json": components["schemas"]["ForbiddenErrorResponseContent"];
                 };
             };
-            /** @description NotFoundError 404 response */
-            404: {
+            /** @description RateLimitError 429 response */
+            429: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["NotFoundErrorResponseContent"];
+                    "application/json": components["schemas"]["RateLimitErrorResponseContent"];
                 };
             };
             /** @description InternalServerError 500 response */
@@ -13177,24 +13510,29 @@ export interface operations {
             };
         };
     };
-    GetCloudFile: {
+    GetPing: {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                cloudFileId: number;
+                /**
+                 * @description A Ping's id is the id of the bucket that holds it (the bucket type is
+                 *     "Circle", which is also the wire path), so the `bucket.id` a Ping's
+                 *     recordings carry is the id GetPing takes.
+                 */
+                pingId: number;
             };
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description GetCloudFile 200 response */
+            /** @description GetPing 200 response */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["GetCloudFileResponseContent"];
+                    "application/json": components["schemas"]["GetPingResponseContent"];
                 };
             };
             /** @description UnauthorizedError 401 response */
@@ -13224,13 +13562,196 @@ export interface operations {
                     "application/json": components["schemas"]["NotFoundErrorResponseContent"];
                 };
             };
-            /** @description InternalServerError 500 response */
-            500: {
+            /** @description RateLimitError 429 response */
+            429: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["InternalServerErrorResponseContent"];
+                    "application/json": components["schemas"]["RateLimitErrorResponseContent"];
+                };
+            };
+            /** @description InternalServerError 500 response */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["InternalServerErrorResponseContent"];
+                };
+            };
+        };
+    };
+    GetClientApproval: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                approvalId: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description GetClientApproval 200 response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GetClientApprovalResponseContent"];
+                };
+            };
+            /** @description UnauthorizedError 401 response */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["UnauthorizedErrorResponseContent"];
+                };
+            };
+            /** @description ForbiddenError 403 response */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ForbiddenErrorResponseContent"];
+                };
+            };
+            /** @description NotFoundError 404 response */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["NotFoundErrorResponseContent"];
+                };
+            };
+            /** @description InternalServerError 500 response */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["InternalServerErrorResponseContent"];
+                };
+            };
+        };
+    };
+    GetClientCorrespondence: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                correspondenceId: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description GetClientCorrespondence 200 response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GetClientCorrespondenceResponseContent"];
+                };
+            };
+            /** @description UnauthorizedError 401 response */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["UnauthorizedErrorResponseContent"];
+                };
+            };
+            /** @description ForbiddenError 403 response */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ForbiddenErrorResponseContent"];
+                };
+            };
+            /** @description NotFoundError 404 response */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["NotFoundErrorResponseContent"];
+                };
+            };
+            /** @description InternalServerError 500 response */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["InternalServerErrorResponseContent"];
+                };
+            };
+        };
+    };
+    GetCloudFile: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                cloudFileId: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description GetCloudFile 200 response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GetCloudFileResponseContent"];
+                };
+            };
+            /** @description UnauthorizedError 401 response */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["UnauthorizedErrorResponseContent"];
+                };
+            };
+            /** @description ForbiddenError 403 response */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ForbiddenErrorResponseContent"];
+                };
+            };
+            /** @description NotFoundError 404 response */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["NotFoundErrorResponseContent"];
+                };
+            };
+            /** @description InternalServerError 500 response */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["InternalServerErrorResponseContent"];
                 };
             };
         };
@@ -13808,6 +14329,152 @@ export interface operations {
             };
         };
     };
+    CreateEmbed: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateEmbedRequestContent"];
+            };
+        };
+        responses: {
+            /** @description CreateEmbed 200 response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CreateEmbedResponseContent"];
+                };
+            };
+            /** @description BadRequestError 400 response */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["BadRequestErrorResponseContent"];
+                };
+            };
+            /** @description UnauthorizedError 401 response */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["UnauthorizedErrorResponseContent"];
+                };
+            };
+            /** @description ForbiddenError 403 response */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ForbiddenErrorResponseContent"];
+                };
+            };
+            /** @description ValidationError 422 response */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ValidationErrorResponseContent"];
+                };
+            };
+            /** @description RateLimitError 429 response */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RateLimitErrorResponseContent"];
+                };
+            };
+            /** @description InternalServerError 500 response */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["InternalServerErrorResponseContent"];
+                };
+            };
+        };
+    };
+    GetEmbed: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description An embed's signed global id, an opaque string. */
+                sgid: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description GetEmbed 200 response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GetEmbedResponseContent"];
+                };
+            };
+            /** @description UnauthorizedError 401 response */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["UnauthorizedErrorResponseContent"];
+                };
+            };
+            /** @description ForbiddenError 403 response */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ForbiddenErrorResponseContent"];
+                };
+            };
+            /** @description NotFoundError 404 response */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["NotFoundErrorResponseContent"];
+                };
+            };
+            /** @description RateLimitError 429 response */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RateLimitErrorResponseContent"];
+                };
+            };
+            /** @description InternalServerError 500 response */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["InternalServerErrorResponseContent"];
+                };
+            };
+        };
+    };
     PollEvents: {
         parameters: {
             query?: {