@37signals/basecamp 0.14.0 → 0.16.0

package/dist/generated/schema.d.ts

@@ -1731,6 +1731,31 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/my/recent_projects.json": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * @description List the projects the current user has most recently visited, most recent visit first.
+         *     Reads the per-user visit log — capped at the 50 most recent visits, keeping
+         *     only active projects the user can still access — not the home grid's
+         *     pinned-exclusion and padding. This endpoint is not paginated. Each entry is
+         *     the standard project projection plus the current user's bookmarked flag. A
+         *     visit is recorded when the user opens a project in Basecamp, when they
+         *     create one, and by RecordProjectVisit.
+         */
+        get: operations["ListRecentProjects"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/my/unreads.json": {
         parameters: {
             query?: never;
@@ -1950,6 +1975,28 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/projects/{projectId}/recent_visit.json": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * @description Record that the current user visited a project, moving it to the front of ListRecentProjects (returns 204 No Content).
+         *     Idempotent: re-recording a visit refreshes the same entry. Visits to
+         *     archived or trashed projects are accepted but not recorded, and an
+         *     inaccessible project answers 404.
+         */
+        post: operations["RecordProjectVisit"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/projects/{projectId}/status/active.json": {
         parameters: {
             query?: never;
@@ -2265,6 +2312,42 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/recordings/{recordingId}/bubble_up.json": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * @description Bubble up a recording for the current user, resurfacing it in the current
+         *     user's readings (the BC5 successor to "save"). Returns 204 No Content with
+         *     no body.
+         *
+         *     The `at` field controls timing. Send `"now"` to bubble up immediately, or a
+         *     scheduling keyword (`"today"`, `"tomorrow"`, `"weekend"`, `"next_week"`) or
+         *     an ISO8601 date (e.g. `"2026-09-10"`) to schedule it to resurface later.
+         *     NOTE: bc3 currently requires `at` — omitting it raises on the server
+         *     (`Date.iso8601(nil)`), so send `"now"` for the immediate case. The field is
+         *     modeled optional (not `@required`) so a future bc3 default (`params[:at] ||=
+         *     "now"`) makes omission mean "now" without an SDK change.
+         *
+         *     Idempotent: bubbling up an already-bubbled recording is set-membership and
+         *     still returns 204.
+         */
+        post: operations["CreateBubbleUp"];
+        /**
+         * @description Remove the current user's bubble-up from a recording (returns 204 No Content).
+         *     Idempotent: popping an absent bubble-up also returns 204.
+         */
+        delete: operations["DeleteBubbleUp"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/recordings/{recordingId}/client_visibility.json": {
         parameters: {
             query?: never;
@@ -2345,6 +2428,30 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/recordings/{recordingId}/spotlight.json": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * @description Put a recording's card in the spotlight area on its project or template home page.
+         *     Idempotent: spotlighting an already-spotlighted recording still returns 201.
+         */
+        post: operations["SpotlightRecording"];
+        /**
+         * @description Remove a recording from the spotlight area.
+         *     Idempotent: removing an absent spotlight also returns 204.
+         */
+        delete: operations["UnspotlightRecording"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/recordings/{recordingId}/status/active.json": {
         parameters: {
             query?: never;
@@ -2830,6 +2937,57 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/template_library.json": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Get the account's to-do list template library */
+        get: operations["GetTemplateLibrary"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/template_library/copies.json": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** @description Start copying a to-do list template into a project */
+        post: operations["CreateTemplateLibraryCopy"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/template_library/copies/{copyId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Get the current status of a to-do list template copy */
+        get: operations["GetTemplateLibraryCopy"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/templates.json": {
         parameters: {
             query?: never;
@@ -3729,9 +3887,11 @@ export interface components {
             created_at: string;
             updated_at: string;
             service_name: string;
+            /** @description Only present when the requester is an account administrator; possession of this URL is enough to command the bot. */
             command_url?: string;
             url?: string;
             app_url?: string;
+            /** @description Only present when the requester is an account administrator; possession of this URL is enough to post lines as the bot. */
             lines_url?: string;
         };
         ClientApproval: {
@@ -3927,6 +4087,16 @@ export interface components {
             attachable_sgid?: string;
         };
         CreateBookmarkResponseContent: components["schemas"]["Bookmark"];
+        CreateBubbleUpRequestContent: {
+            /**
+             * @description Timing for the bubble-up. `"now"` bubbles up immediately; a scheduling
+             *     keyword (`"today"`, `"tomorrow"`, `"weekend"`, `"next_week"`) or an ISO8601
+             *     date (e.g. `"2026-09-10"`) schedules it to resurface later. bc3 requires a
+             *     value — omitting `at` errors server-side (`Date.iso8601(nil)`) — so send
+             *     `"now"` for the immediate case.
+             */
+            at?: string;
+        };
         CreateCampfireLineRequestContent: {
             content: string;
             content_type?: string;
@@ -4161,6 +4331,15 @@ export interface components {
             visible_to_clients?: boolean;
         };
         CreateScheduleEntryResponseContent: components["schemas"]["ScheduleEntry"];
+        CreateTemplateLibraryCopyRequestContent: {
+            /** Format: int64 */
+            template_recording_id: number;
+            /** Format: int64 */
+            destination_parent_id: number;
+            /** @description Confirm granting destination-project access to people referenced by the template. */
+            adding_people_confirmed?: boolean;
+        };
+        CreateTemplateLibraryCopyResponseContent: components["schemas"]["TemplateLibraryCopy"];
         CreateTemplateRequestContent: {
             name: string;
             description?: string;
@@ -4769,8 +4948,8 @@ export interface components {
             over_three_months_late?: components["schemas"]["Todo"][];
         };
         GetPersonProgressResponseContent: {
-            person?: components["schemas"]["Person"];
-            events?: components["schemas"]["TimelineEvent"][];
+            person: components["schemas"]["Person"];
+            events: components["schemas"]["TimelineEvent"][];
         };
         GetPersonResponseContent: components["schemas"]["Person"];
         GetProgressReportResponseContent: components["schemas"]["TimelineEvent"][];
@@ -4787,6 +4966,8 @@ export interface components {
         GetScheduleResponseContent: components["schemas"]["Schedule"];
         GetSearchMetadataResponseContent: components["schemas"]["SearchMetadata"];
         GetSubscriptionResponseContent: components["schemas"]["Subscription"];
+        GetTemplateLibraryCopyResponseContent: components["schemas"]["TemplateLibraryCopy"];
+        GetTemplateLibraryResponseContent: components["schemas"]["TemplateLibrary"];
         GetTemplateResponseContent: components["schemas"]["Template"];
         GetTimesheetEntryResponseContent: components["schemas"]["TimesheetEntry"];
         GetTimesheetReportResponseContent: components["schemas"]["TimesheetEntry"][];
@@ -4935,6 +5116,7 @@ export interface components {
         ListProjectsResponseContent: components["schemas"]["Project"][];
         ListQuestionAnswerersResponseContent: components["schemas"]["Person"][];
         ListQuestionsResponseContent: components["schemas"]["Question"][];
+        ListRecentProjectsResponseContent: components["schemas"]["Project"][];
         ListRecordingBoostsResponseContent: components["schemas"]["Boost"][];
         ListRecordingsResponseContent: components["schemas"]["Recording"][];
         ListScheduleEntriesResponseContent: components["schemas"]["ScheduleEntry"][];
@@ -5047,13 +5229,19 @@ export interface components {
             parent?: components["schemas"]["MyAssignmentParent"];
             children?: components["schemas"]["MyAssignment"][];
         };
+        /**
+         * @description A person as bc3's `people/_person_minimal.json.jbuilder` renders them —
+         *     the same three-key partial behind UpcomingSchedulePerson and
+         *     OutOfOfficePerson. All three keys are emitted unconditionally, so all
+         *     three are required.
+         */
         MyAssignmentAssignee: {
             /** Format: int64 */
             id: number;
             /** Format: password */
-            name?: string;
+            name: string;
             /** Format: password */
-            avatar_url?: string;
+            avatar_url: string;
         };
         MyAssignmentBucket: {
             /** Format: int64 */
@@ -5167,17 +5355,31 @@ export interface components {
             /** @description End date in ISO 8601 format (YYYY-MM-DD) */
             end_date: string;
         };
+        /**
+         * @description A person as bc3's `people/_person_minimal.json.jbuilder` renders them —
+         *     the same three-key partial behind UpcomingSchedulePerson and
+         *     MyAssignmentAssignee. All three keys are emitted unconditionally, so all
+         *     three are required.
+         */
         OutOfOfficePerson: {
             /** Format: int64 */
             id: number;
             /** Format: password */
-            name?: string;
+            name: string;
             /** Format: password */
-            avatar_url?: string;
+            avatar_url: string;
         };
         PauseQuestionResponseContent: {
             paused?: boolean;
         };
+        /**
+         * @description The copy requires confirmation before granting destination-project access
+         *     to people referenced by the template.
+         */
+        PeopleConfirmationRequiredErrorResponseContent: {
+            error: string;
+            people: components["schemas"]["TemplateLibraryConfirmationPerson"][];
+        };
         Person: {
             /** Format: int64 */
             id: number;
@@ -5279,10 +5481,18 @@ export interface components {
             end_date?: string;
             clients_enabled?: boolean;
             bookmark_url?: string;
+            /** @description Bucket stars collection for this project (`/buckets/{id}/stars.json`). */
+            star_url?: string;
             url: string;
             app_url: string;
             dock?: components["schemas"]["DockItem"][];
+            /**
+             * @description True when the project is pinned on the current user's home page at all,
+             *     whether starred or filed into a stack.
+             */
             bookmarked?: boolean;
+            /** @description True only when the project carries a star on the current user's home page. */
+            starred?: boolean;
             client_company?: components["schemas"]["ClientCompany"];
             /** @deprecated */
             clientside?: components["schemas"]["ClientSide"];
@@ -5815,19 +6025,61 @@ export interface components {
             default_type_label: string;
         };
         SearchResponseContent: components["schemas"]["SearchResult"][];
+        /**
+         * @description One hit from account-wide search — a polymorphic projection over every
+         *     searchable recording type.
+         *
+         *     Most result types render the common recording envelope
+         *     (`recordings/_recording.json.jbuilder`) plus their own recordable partial,
+         *     but `api_search_result_template_path` special-cases four branches — chat
+         *     lines, kanban (card table) lists, file attachments and gauge needles — and
+         *     the file-attachment branch writes its own projection from scratch instead
+         *     of the envelope. Members are therefore optional unless every branch emits
+         *     them; the doc comments name the branches that carry each optional member.
+         */
         SearchResult: {
-            /** Format: int64 */
-            id: number;
+            /**
+             * Format: int64
+             * @description The recording id. Optional only because the file-attachment branch
+             *     (`searches/_attachment.json.jbuilder`) skips the recording envelope and
+             *     emits none of the top-level id/title/type/url/app_url keys; every other
+             *     branch emits all five.
+             */
+            id?: number;
             status?: string;
             visible_to_clients?: boolean;
             created_at?: string;
             updated_at?: string;
-            title: string;
+            /**
+             * @description See `id` — omitted by the file-attachment branch, emitted by every other
+             *     branch.
+             */
+            title?: string;
             inherits_status?: boolean;
-            type: string;
-            url: string;
-            app_url: string;
+            /**
+             * @description See `id` — omitted by the file-attachment branch, emitted by every other
+             *     branch. A file-attachment hit is therefore recognizable by the absence
+             *     of this key (its file keys, `filename` through `app_download_url`, are
+             *     the positive signal).
+             */
+            type?: string;
+            /**
+             * @description See `id` — omitted by the file-attachment branch, emitted by every other
+             *     branch.
+             */
+            url?: string;
+            /**
+             * @description See `id` — omitted by the file-attachment branch, emitted by every other
+             *     branch.
+             */
+            app_url?: string;
             bookmark_url?: string;
+            /**
+             * @description Subscription URL, emitted by the common recording envelope for any
+             *     subscribable result — kanban lists and gauge needles among the special
+             *     branches, plus subscribable generic-branch types (messages, todos, …).
+             */
+            subscription_url?: string;
             /**
              * @description URL of the Bubble Up record for this recording (BC5 addition). Optional
              *     here because this is a polymorphic projection:
@@ -5877,22 +6129,173 @@ export interface components {
              *     the array matching its rich-text attribute (`content_attachments` for a
              *     Comment/Message, `description_attachments` for a Todo); a webhook-sourced
              *     result carries neither. Optional (no `@required`), non-nullable.
-             *
-             *     Search results additionally repeat this same array under a generic
-             *     `attachments` key. It is a redundant projection, not a distinct
-             *     aggregate: `searches/show.json.jbuilder` emits
-             *     `recording.downloadable_attachments`, which delegates to the recordable's
-             *     sole `rich_text_content`, through the same `attachments/_attachment`
-             *     partial that `recordings/_rich_text.json.jbuilder` uses to build the
-             *     companion array. `RichText.rich_text_attribute` permits exactly one
-             *     rich-text attribute per model, so the two keys always carry identical
-             *     elements. Modeling `attachments` would duplicate the field, so it is
-             *     deliberately not modeled.
              */
             content_attachments?: components["schemas"]["RichTextAttachment"][];
             /** @description See `content_attachments` — the description-attribute companion array. */
             description_attachments?: components["schemas"]["RichTextAttachment"][];
+            /**
+             * @description File attachments on the result, in either of two wire shapes — see
+             *     `SearchResultAttachment`.
+             *
+             *     For a result whose recordable carries downloadable rich-text
+             *     attachments, `searches/show.json.jbuilder` emits this key through the
+             *     same `attachments/_attachment` partial that builds the rich-text
+             *     companion array above, so it repeats that array's elements. For a chat
+             *     *upload* line, `chats/lines/_upload.json.jbuilder` instead builds a
+             *     bespoke six-key aggregate inline — and because upload lines have no
+             *     rich-text attribute, the show template never overwrites it, so that
+             *     distinct shape survives to the wire.
+             */
+            attachments?: components["schemas"]["SearchResultAttachment"][];
             subject?: string;
+            /**
+             * Format: int32
+             * @description Boost count, emitted by the recording envelope when the branch passes
+             *     `boostable` — chat lines and gauge needles.
+             */
+            boosts_count?: number;
+            /** @description See `boosts_count` — the companion URL. */
+            boosts_url?: string;
+            /**
+             * @description Language of a code chat line (`chats/lines/_code.json.jbuilder`);
+             *     validated present on the model, so never null when the key is emitted.
+             */
+            language?: string;
+            /**
+             * @description Image URL of a soundtracked (play-kind) chat line whose sound carries an
+             *     image; such a line emits `image_url` in place of `content`.
+             */
+            image_url?: string;
+            /** @description Sound URL of a play-kind chat line; always emitted for that kind. */
+            sound_url?: string;
+            /** @description Everyone subscribed to the kanban list, as full Person projections. */
+            subscribers?: components["schemas"]["Person"][];
+            /**
+             * @description Color of a kanban list or gauge needle. Emitted unconditionally by both
+             *     branches with a null value when unset, so it is nullable (the enhance
+             *     pass layers `nullable: true` onto the OpenAPI).
+             */
+            color?: string | null;
+            /**
+             * Format: int32
+             * @description Number of cards in the kanban list.
+             */
+            cards_count?: number;
+            /**
+             * Format: int32
+             * @description Comment count of a kanban list or gauge needle (branch-partial key,
+             *     singular `comment_count` — distinct from the envelope's
+             *     `comments_count`, which a needle also carries).
+             */
+            comment_count?: number;
+            /** @description API URL of the kanban list's cards. */
+            cards_url?: string;
+            on_hold?: components["schemas"]["CardColumnOnHold"];
+            /**
+             * Format: int32
+             * @description Comment count, emitted by the recording envelope when the branch passes
+             *     `commentable` — gauge needles among the special branches, plus
+             *     commentable generic-branch types.
+             */
+            comments_count?: number;
+            /** @description See `comments_count` — the companion URL. */
+            comments_url?: string;
+            /**
+             * Format: int32
+             * @description Position of the result. Two emitters share the key: the recording
+             *     envelope emits list position for positioned recordings (kanban lists
+             *     among the special branches), and the gauge-needle branch overwrites it
+             *     with the needle's own 0–100 gauge position.
+             */
+            position?: number;
+            /**
+             * @description Filename of a file-attachment hit. This and the following file keys are
+             *     emitted only by the file-attachment branch — the one branch that omits
+             *     the id/title/type/url/app_url envelope keys.
+             */
+            filename?: string;
+            /** @description MIME type of a file-attachment hit. */
+            content_type?: string;
+            /**
+             * Format: int64
+             * @description Size in bytes of a file-attachment hit.
+             */
+            byte_size?: number;
+            /** @description Whether the file can be previewed. */
+            previewable?: boolean;
+            /**
+             * Format: int32
+             * @description Pixel width, emitted only when the file is previewable. May be
+             *     float-spelled (`1024.0`) and nullable, like every other blob dimension —
+             *     see `RichTextAttachment.width` for the cross-SDK typing note.
+             */
+            width?: number | null;
+            /**
+             * Format: int32
+             * @description See `width` — same conditional emission and nullable/float-spelled
+             *     behavior.
+             */
+            height?: number | null;
+            /** @description Full-size preview URL of a file-attachment hit. */
+            preview_url?: string;
+            /** @description Thumbnail URL of a file-attachment hit. */
+            thumbnail_url?: string;
+            /** @description Authenticated download URL of a file-attachment hit. */
+            download_url?: string;
+            /** @description Web (app-host) download URL of a file-attachment hit. */
+            app_download_url?: string;
+        };
+        /**
+         * @description A file attached to a search result, in either of two wire shapes.
+         *
+         *     This is an optional-field superset over the two variants the search
+         *     projection emits (the TimelineAttachment approach): the rich-text
+         *     attachment/blob shape rendered through `attachments/_attachment` +
+         *     `blobs/_blob` — the same emitters `RichTextAttachment` models — and the
+         *     bespoke six-key aggregate a chat upload line builds inline in
+         *     `chats/lines/_upload.json.jbuilder`. Only the four keys both variants
+         *     always emit are `@required`; the rest identify their variant.
+         */
+        SearchResultAttachment: {
+            /** @description Original filename (both variants). */
+            filename: string;
+            /** @description MIME type of the file (both variants). */
+            content_type: string;
+            /**
+             * Format: int64
+             * @description Size of the file in bytes (both variants).
+             */
+            byte_size: number;
+            /** @description Authenticated download URL for the file (both variants). */
+            download_url: string;
+            /**
+             * Format: int64
+             * @description Attachment id (rich-text variant).
+             */
+            id?: number;
+            /** @description Signed global id of the attachment (rich-text variant). */
+            sgid?: string;
+            /** @description Whether the blob can be previewed (rich-text variant). */
+            previewable?: boolean;
+            /** @description Full-size preview URL (rich-text variant). */
+            preview_url?: string;
+            /** @description Thumbnail URL (rich-text variant). */
+            thumbnail_url?: string;
+            /**
+             * Format: int32
+             * @description Pixel width (rich-text variant) — null for non-image blobs and may be
+             *     float-spelled (`1024.0`); see `RichTextAttachment.width`.
+             */
+            width?: number | null;
+            /**
+             * Format: int32
+             * @description See `width` (rich-text variant).
+             */
+            height?: number | null;
+            /** @description Title of the attachment recording (chat upload-line variant). */
+            title?: string;
+            /** @description Browser preview URL of the blob (chat upload-line variant). */
+            url?: string;
         };
         /**
          * @description A selectable search filter option. `key` is the value passed back as a
@@ -5923,6 +6326,7 @@ export interface components {
             visible_to_clients: boolean;
         };
         SetClientVisibilityResponseContent: components["schemas"]["Recording"];
+        SpotlightRecordingResponseContent: components["schemas"]["Recording"];
         /**
          * @description The account has reached its file storage limit.
          *
@@ -5954,14 +6358,39 @@ export interface components {
             app_url?: string;
             dock?: components["schemas"]["DockItem"][];
         };
-        /**
-         * @description A single timeline-event attachment. This is an optional-field superset over
-         *     two wire variants — a full Upload recording (upload-kind recordings, rendered
-         *     by BC3's uploads/_upload partial: the complete recording projection + rich-
-         *     text description + the upload body) and a rich-text attachment/blob partial
-         *     (all other recordings) — so one element type decodes either. Every field is
-         *     optional; a given instance populates only the fields of the variant it
-         *     represents. The upload-recording variant enumerates the full documented
+        TemplateLibrary: {
+            bucket: components["schemas"]["RecordingBucket"];
+            todoset: components["schemas"]["RecordingParent"];
+            todolists: components["schemas"]["Todolist"][];
+        };
+        TemplateLibraryConfirmationPerson: {
+            /** Format: int64 */
+            id: number;
+            /** Format: password */
+            name: string;
+            /** Format: password */
+            avatar_url: string;
+        };
+        TemplateLibraryCopy: {
+            /** Format: int64 */
+            id: number;
+            /** @description pending|processing|completed|failed */
+            status: string;
+            /** Format: int64 */
+            source_recording_id: number;
+            /** Format: int64 */
+            destination_parent_id: number;
+            url: string;
+            destination_todolist?: components["schemas"]["Todolist"];
+        };
+        /**
+         * @description A single timeline-event attachment. This is an optional-field superset over
+         *     two wire variants — a full Upload recording (upload-kind recordings, rendered
+         *     by BC3's uploads/_upload partial: the complete recording projection + rich-
+         *     text description + the upload body) and a rich-text attachment/blob partial
+         *     (all other recordings) — so one element type decodes either. Every field is
+         *     optional; a given instance populates only the fields of the variant it
+         *     represents. The upload-recording variant enumerates the full documented
          *     projection so no documented field is silently dropped on decode.
          */
         TimelineAttachment: {
@@ -6372,16 +6801,41 @@ export interface components {
             /** Format: int64 */
             id: number;
             status?: string;
+            visible_to_clients: boolean;
             created_at: string;
             updated_at: string;
             title: string;
-            name: string;
-            enabled: boolean;
-            /** Format: int32 */
-            position?: number;
+            inherits_status: boolean;
+            /** @description The tool's recordable type, e.g. `Chat::Transcript`, `Todoset`, `Vault`. */
+            type: string;
             url?: string;
             app_url?: string;
+            bookmark_url?: string;
+            /** @description Absent for tool types that are not subscribable. */
+            subscription_url?: string;
+            /**
+             * Format: int32
+             * @description Emitted only for a positioned recording. For a docked tool that makes an
+             *     absent position the disabled signal — disabling removes the tool from the
+             *     dock without deleting it. Positioning is independent of dockedness, so
+             *     this does not generalize: a nested vault is not docked and is positioned.
+             */
+            position?: number;
+            parent?: components["schemas"]["RecordingParent"];
             bucket?: components["schemas"]["RecordingBucket"];
+            creator: components["schemas"]["Person"];
+            /**
+             * @description Not emitted by this projection. The dock array on a project
+             *     (`DockItem$name`) carries the tool's slug; this key is absent from every
+             *     GetTool/CreateTool/UpdateTool response.
+             */
+            name?: string;
+            /**
+             * @description Not emitted by this projection. The dock array on a project
+             *     (`DockItem$enabled`) is the authoritative enabled flag; on a docked tool's
+             *     own response, an absent `position` is the equivalent signal.
+             */
+            enabled?: boolean;
         };
         UnauthorizedErrorResponseContent: {
             error: string;
@@ -14743,6 +15197,62 @@ export interface operations {
             };
         };
     };
+    ListRecentProjects: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description ListRecentProjects 200 response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ListRecentProjectsResponseContent"];
+                };
+            };
+            /** @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 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"];
+                };
+            };
+        };
+    };
     MarkAsRead: {
         parameters: {
             query?: never;
@@ -15837,6 +16347,71 @@ export interface operations {
             };
         };
     };
+    RecordProjectVisit: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                projectId: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description RecordProjectVisit 204 response */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @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"];
+                };
+            };
+        };
+    };
     UnarchiveProject: {
         parameters: {
             query?: never;
@@ -17456,7 +18031,7 @@ export interface operations {
             };
         };
     };
-    SetClientVisibility: {
+    CreateBubbleUp: {
         parameters: {
             query?: never;
             header?: never;
@@ -17465,20 +18040,18 @@ export interface operations {
             };
             cookie?: never;
         };
-        requestBody: {
+        requestBody?: {
             content: {
-                "application/json": components["schemas"]["SetClientVisibilityRequestContent"];
+                "application/json": components["schemas"]["CreateBubbleUpRequestContent"];
             };
         };
         responses: {
-            /** @description SetClientVisibility 200 response */
-            200: {
+            /** @description CreateBubbleUp 204 response */
+            204: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content: {
-                    "application/json": components["schemas"]["SetClientVisibilityResponseContent"];
-                };
+                content?: never;
             };
             /** @description UnauthorizedError 401 response */
             401: {
@@ -17507,13 +18080,13 @@ export interface operations {
                     "application/json": components["schemas"]["NotFoundErrorResponseContent"];
                 };
             };
-            /** @description ValidationError 422 response */
-            422: {
+            /** @description RateLimitError 429 response */
+            429: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ValidationErrorResponseContent"];
+                    "application/json": components["schemas"]["RateLimitErrorResponseContent"];
                 };
             };
             /** @description InternalServerError 500 response */
@@ -17527,12 +18100,9 @@ export interface operations {
             };
         };
     };
-    ListComments: {
+    DeleteBubbleUp: {
         parameters: {
-            query?: {
-                /** @description Page number for paginating through results. Defaults to 1. A positive value selects exactly that page, not a starting offset; see SPEC section 8. */
-                page?: number;
-            };
+            query?: never;
             header?: never;
             path: {
                 recordingId: number;
@@ -17541,14 +18111,12 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description ListComments 200 response */
-            200: {
+            /** @description DeleteBubbleUp 204 response */
+            204: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content: {
-                    "application/json": components["schemas"]["ListCommentsResponseContent"];
-                };
+                content?: never;
             };
             /** @description UnauthorizedError 401 response */
             401: {
@@ -17568,6 +18136,15 @@ export interface operations {
                     "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: {
@@ -17588,7 +18165,7 @@ export interface operations {
             };
         };
     };
-    CreateComment: {
+    SetClientVisibility: {
         parameters: {
             query?: never;
             header?: never;
@@ -17599,17 +18176,17 @@ export interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["CreateCommentRequestContent"];
+                "application/json": components["schemas"]["SetClientVisibilityRequestContent"];
             };
         };
         responses: {
-            /** @description CreateComment 201 response */
-            201: {
+            /** @description SetClientVisibility 200 response */
+            200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["CreateCommentResponseContent"];
+                    "application/json": components["schemas"]["SetClientVisibilityResponseContent"];
                 };
             };
             /** @description UnauthorizedError 401 response */
@@ -17630,22 +18207,22 @@ export interface operations {
                     "application/json": components["schemas"]["ForbiddenErrorResponseContent"];
                 };
             };
-            /** @description ValidationError 422 response */
-            422: {
+            /** @description NotFoundError 404 response */
+            404: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ValidationErrorResponseContent"];
+                    "application/json": components["schemas"]["NotFoundErrorResponseContent"];
                 };
             };
-            /** @description RateLimitError 429 response */
-            429: {
+            /** @description ValidationError 422 response */
+            422: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["RateLimitErrorResponseContent"];
+                    "application/json": components["schemas"]["ValidationErrorResponseContent"];
                 };
             };
             /** @description InternalServerError 500 response */
@@ -17659,7 +18236,7 @@ export interface operations {
             };
         };
     };
-    ListEvents: {
+    ListComments: {
         parameters: {
             query?: {
                 /** @description Page number for paginating through results. Defaults to 1. A positive value selects exactly that page, not a starting offset; see SPEC section 8. */
@@ -17673,13 +18250,13 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description ListEvents 200 response */
+            /** @description ListComments 200 response */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ListEventsResponseContent"];
+                    "application/json": components["schemas"]["ListCommentsResponseContent"];
                 };
             };
             /** @description UnauthorizedError 401 response */
@@ -17720,28 +18297,28 @@ export interface operations {
             };
         };
     };
-    ListEventBoosts: {
+    CreateComment: {
         parameters: {
-            query?: {
-                /** @description Page number for paginating through results. Defaults to 1. A positive value selects exactly that page, not a starting offset; see SPEC section 8. */
-                page?: number;
-            };
+            query?: never;
             header?: never;
             path: {
                 recordingId: number;
-                eventId: number;
             };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateCommentRequestContent"];
+            };
+        };
         responses: {
-            /** @description ListEventBoosts 200 response */
-            200: {
+            /** @description CreateComment 201 response */
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ListEventBoostsResponseContent"];
+                    "application/json": components["schemas"]["CreateCommentResponseContent"];
                 };
             };
             /** @description UnauthorizedError 401 response */
@@ -17762,17 +18339,149 @@ export interface operations {
                     "application/json": components["schemas"]["ForbiddenErrorResponseContent"];
                 };
             };
-            /** @description NotFoundError 404 response */
-            404: {
+            /** @description ValidationError 422 response */
+            422: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["NotFoundErrorResponseContent"];
+                    "application/json": components["schemas"]["ValidationErrorResponseContent"];
                 };
             };
-            /** @description InternalServerError 500 response */
-            500: {
+            /** @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"];
+                };
+            };
+        };
+    };
+    ListEvents: {
+        parameters: {
+            query?: {
+                /** @description Page number for paginating through results. Defaults to 1. A positive value selects exactly that page, not a starting offset; see SPEC section 8. */
+                page?: number;
+            };
+            header?: never;
+            path: {
+                recordingId: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description ListEvents 200 response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ListEventsResponseContent"];
+                };
+            };
+            /** @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 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"];
+                };
+            };
+        };
+    };
+    ListEventBoosts: {
+        parameters: {
+            query?: {
+                /** @description Page number for paginating through results. Defaults to 1. A positive value selects exactly that page, not a starting offset; see SPEC section 8. */
+                page?: number;
+            };
+            header?: never;
+            path: {
+                recordingId: number;
+                eventId: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description ListEventBoosts 200 response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ListEventBoostsResponseContent"];
+                };
+            };
+            /** @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;
                 };
@@ -17854,6 +18563,147 @@ export interface operations {
             };
         };
     };
+    SpotlightRecording: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                recordingId: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description SpotlightRecording 201 response */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SpotlightRecordingResponseContent"];
+                };
+            };
+            /** @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 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"];
+                };
+            };
+        };
+    };
+    UnspotlightRecording: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                recordingId: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description UnspotlightRecording 204 response */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @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"];
+                };
+            };
+        };
+    };
     UnarchiveRecording: {
         parameters: {
             query?: never;
@@ -20061,6 +20911,207 @@ export interface operations {
             };
         };
     };
+    GetTemplateLibrary: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description GetTemplateLibrary 200 response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GetTemplateLibraryResponseContent"];
+                };
+            };
+            /** @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 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"];
+                };
+            };
+        };
+    };
+    CreateTemplateLibraryCopy: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateTemplateLibraryCopyRequestContent"];
+            };
+        };
+        responses: {
+            /** @description CreateTemplateLibraryCopy 201 response */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CreateTemplateLibraryCopyResponseContent"];
+                };
+            };
+            /** @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 PeopleConfirmationRequiredError 422 response */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PeopleConfirmationRequiredErrorResponseContent"];
+                };
+            };
+            /** @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"];
+                };
+            };
+        };
+    };
+    GetTemplateLibraryCopy: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                copyId: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description GetTemplateLibraryCopy 200 response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GetTemplateLibraryCopyResponseContent"];
+                };
+            };
+            /** @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"];
+                };
+            };
+        };
+    };
     ListTemplates: {
         parameters: {
             query?: {