@37signals/basecamp 0.13.0 → 0.15.0

package/src/generated/openapi-stripped.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Basecamp",
-    "version": "2026-08-05",
+    "version": "2026-08-11",
     "description": "Basecamp API",
     "contact": {
       "name": "Basecamp",
@@ -417,6 +417,16 @@
                 }
               }
             }
+          },
+          "507": {
+            "description": "StorageLimitError 507 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/StorageLimitErrorResponseContent"
+                }
+              }
+            }
           }
         },
         "tags": [
@@ -6571,6 +6581,16 @@
                 }
               }
             }
+          },
+          "507": {
+            "description": "StorageLimitError 507 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/StorageLimitErrorResponseContent"
+                }
+              }
+            }
           }
         },
         "tags": [
@@ -22663,6 +22683,125 @@
             503
           ]
         }
+      },
+      "post": {
+        "description": "Replace an upload's file with a new version\n\nThe recording keeps its id, its URL and its comments; the previous file becomes a\npast version. Use this instead of CreateUpload when publishing a new release of the\nsame file, so its published link keeps working.",
+        "operationId": "CreateUploadVersion",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CreateUploadVersionRequestContent"
+              }
+            }
+          },
+          "required": true
+        },
+        "parameters": [
+          {
+            "name": "uploadId",
+            "in": "path",
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            },
+            "required": true
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "CreateUploadVersion 201 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CreateUploadVersionResponseContent"
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "UnauthorizedError 401 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/UnauthorizedErrorResponseContent"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "ForbiddenError 403 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "NotFoundError 404 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/NotFoundErrorResponseContent"
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "ValidationError 422 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ValidationErrorResponseContent"
+                }
+              }
+            }
+          },
+          "429": {
+            "description": "RateLimitError 429 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/RateLimitErrorResponseContent"
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "InternalServerError 500 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/InternalServerErrorResponseContent"
+                }
+              }
+            }
+          },
+          "507": {
+            "description": "StorageLimitError 507 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/StorageLimitErrorResponseContent"
+                }
+              }
+            }
+          }
+        },
+        "tags": [
+          "Files"
+        ],
+        "x-basecamp-retry": {
+          "maxAttempts": 2,
+          "baseDelayMs": 1000,
+          "backoff": "exponential",
+          "retryOn": [
+            429,
+            503
+          ]
+        }
       }
     },
     "/vaults/{vaultId}": {
@@ -23221,6 +23360,16 @@
                 }
               }
             }
+          },
+          "507": {
+            "description": "StorageLimitError 507 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/StorageLimitErrorResponseContent"
+                }
+              }
+            }
           }
         },
         "tags": [
@@ -24755,7 +24904,8 @@
             "type": "string"
           },
           "command_url": {
-            "type": "string"
+            "type": "string",
+            "description": "Only present when the requester is an account administrator; possession of this URL is enough to command the bot."
           },
           "url": {
             "type": "string"
@@ -24764,7 +24914,8 @@
             "type": "string"
           },
           "lines_url": {
-            "type": "string"
+            "type": "string",
+            "description": "Only present when the requester is an account administrator; possession of this URL is enough to post lines as the bot."
           }
         },
         "required": [
@@ -26145,6 +26296,40 @@
       "CreateUploadResponseContent": {
         "$ref": "#/components/schemas/Upload"
       },
+      "CreateUploadVersionRequestContent": {
+        "type": "object",
+        "properties": {
+          "attachable_sgid": {
+            "type": "string"
+          },
+          "base_name": {
+            "type": "string",
+            "description": "Omit to keep the uploaded file's own name. Sending \"\" also keeps it."
+          },
+          "description": {
+            "type": "string",
+            "description": "Presence-aware: omit to carry the previous version's description forward,\nsend \"\" to clear it, send a value to set it."
+          },
+          "notify": {
+            "type": "string",
+            "description": "Who to notify: \"default\", \"everyone\", or \"custom\" (the people in subscriptions).\n\nOmit both this and subscriptions to notify nobody. A subscriptions array sent\nwithout notify is read as \"custom\"."
+          },
+          "subscriptions": {
+            "type": "array",
+            "items": {
+              "type": "integer",
+              "format": "int64"
+            },
+            "description": "People to notify about the replacement and subscribe to the upload."
+          }
+        },
+        "required": [
+          "attachable_sgid"
+        ]
+      },
+      "CreateUploadVersionResponseContent": {
+        "$ref": "#/components/schemas/Upload"
+      },
       "CreateVaultRequestContent": {
         "type": "object",
         "properties": {
@@ -27703,10 +27888,13 @@
             "type": "array",
             "items": {
               "$ref": "#/components/schemas/TimelineEvent"
-            },
-            "x-go-type-skip-optional-pointer": true
+            }
           }
-        }
+        },
+        "required": [
+          "events",
+          "person"
+        ]
       },
       "GetPersonResponseContent": {
         "$ref": "#/components/schemas/Person"
@@ -28359,7 +28547,7 @@
       "ListUploadVersionsResponseContent": {
         "type": "array",
         "items": {
-          "$ref": "#/components/schemas/Upload"
+          "$ref": "#/components/schemas/UploadVersion"
         }
       },
       "ListUploadsResponseContent": {
@@ -28728,6 +28916,7 @@
       },
       "MyAssignmentAssignee": {
         "type": "object",
+        "description": "A person as bc3's `people/_person_minimal.json.jbuilder` renders them —\nthe same three-key partial behind UpcomingSchedulePerson and\nOutOfOfficePerson. All three keys are emitted unconditionally, so all\nthree are required.",
         "properties": {
           "id": {
             "type": "integer",
@@ -28743,7 +28932,9 @@
           }
         },
         "required": [
-          "id"
+          "avatar_url",
+          "id",
+          "name"
         ]
       },
       "MyAssignmentBucket": {
@@ -29036,6 +29227,7 @@
       },
       "OutOfOfficePerson": {
         "type": "object",
+        "description": "A person as bc3's `people/_person_minimal.json.jbuilder` renders them —\nthe same three-key partial behind UpcomingSchedulePerson and\nMyAssignmentAssignee. All three keys are emitted unconditionally, so all\nthree are required.",
         "properties": {
           "id": {
             "type": "integer",
@@ -29051,7 +29243,9 @@
           }
         },
         "required": [
-          "id"
+          "avatar_url",
+          "id",
+          "name"
         ]
       },
       "PauseQuestionResponseContent": {
@@ -30612,9 +30806,11 @@
       },
       "SearchResult": {
         "type": "object",
+        "description": "One hit from account-wide search — a polymorphic projection over every\nsearchable recording type.\n\nMost result types render the common recording envelope\n(`recordings/_recording.json.jbuilder`) plus their own recordable partial,\nbut `api_search_result_template_path` special-cases four branches — chat\nlines, kanban (card table) lists, file attachments and gauge needles — and\nthe file-attachment branch writes its own projection from scratch instead\nof the envelope. Members are therefore optional unless every branch emits\nthem; the doc comments name the branches that carry each optional member.",
         "properties": {
           "id": {
             "type": "integer",
+            "description": "The recording id. Optional only because the file-attachment branch\n(`searches/_attachment.json.jbuilder`) skips the recording envelope and\nemits none of the top-level id/title/type/url/app_url keys; every other\nbranch emits all five.",
             "format": "int64"
           },
           "status": {
@@ -30638,23 +30834,31 @@
             }
           },
           "title": {
-            "type": "string"
+            "type": "string",
+            "description": "See `id` — omitted by the file-attachment branch, emitted by every other\nbranch."
           },
           "inherits_status": {
             "type": "boolean"
           },
           "type": {
-            "type": "string"
+            "type": "string",
+            "description": "See `id` — omitted by the file-attachment branch, emitted by every other\nbranch. A file-attachment hit is therefore recognizable by the absence\nof this key (its file keys, `filename` through `app_download_url`, are\nthe positive signal)."
           },
           "url": {
-            "type": "string"
+            "type": "string",
+            "description": "See `id` — omitted by the file-attachment branch, emitted by every other\nbranch."
           },
           "app_url": {
-            "type": "string"
+            "type": "string",
+            "description": "See `id` — omitted by the file-attachment branch, emitted by every other\nbranch."
           },
           "bookmark_url": {
             "type": "string"
           },
+          "subscription_url": {
+            "type": "string",
+            "description": "Subscription URL, emitted by the common recording envelope for any\nsubscribable result — kanban lists and gauge needles among the special\nbranches, plus subscribable generic-branch types (messages, todos, …)."
+          },
           "bubble_up_url": {
             "type": "string",
             "description": "URL of the Bubble Up record for this recording (BC5 addition). Optional\nhere because this is a polymorphic projection:\n`recordings/_recording.json.jbuilder` emits the key only when the caller\npasses `local_assigns[:bubbleupable]`, and `todolists/_todolist` is the\nonly partial that does. So a Todolist-shaped instance carries it and the\nother recording types do not."
@@ -30697,7 +30901,7 @@
             "items": {
               "$ref": "#/components/schemas/RichTextAttachment"
             },
-            "description": "Rich-text companion arrays carried through the polymorphic search\nprojection. A given result is one recording type, so it carries only\nthe array matching its rich-text attribute (`content_attachments` for a\nComment/Message, `description_attachments` for a Todo); a webhook-sourced\nresult carries neither. Optional (no `@required`), non-nullable.\n\nSearch results additionally repeat this same array under a generic\n`attachments` key. It is a redundant projection, not a distinct\naggregate: `searches/show.json.jbuilder` emits\n`recording.downloadable_attachments`, which delegates to the recordable's\nsole `rich_text_content`, through the same `attachments/_attachment`\npartial that `recordings/_rich_text.json.jbuilder` uses to build the\ncompanion array. `RichText.rich_text_attribute` permits exactly one\nrich-text attribute per model, so the two keys always carry identical\nelements. Modeling `attachments` would duplicate the field, so it is\ndeliberately not modeled.",
+            "description": "Rich-text companion arrays carried through the polymorphic search\nprojection. A given result is one recording type, so it carries only\nthe array matching its rich-text attribute (`content_attachments` for a\nComment/Message, `description_attachments` for a Todo); a webhook-sourced\nresult carries neither. Optional (no `@required`), non-nullable.",
             "x-go-type-skip-optional-pointer": true
           },
           "description_attachments": {
@@ -30708,18 +30912,219 @@
             "description": "See `content_attachments` — the description-attribute companion array.",
             "x-go-type-skip-optional-pointer": true
           },
+          "attachments": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/SearchResultAttachment"
+            },
+            "description": "File attachments on the result, in either of two wire shapes — see\n`SearchResultAttachment`.\n\nFor a result whose recordable carries downloadable rich-text\nattachments, `searches/show.json.jbuilder` emits this key through the\nsame `attachments/_attachment` partial that builds the rich-text\ncompanion array above, so it repeats that array's elements. For a chat\n*upload* line, `chats/lines/_upload.json.jbuilder` instead builds a\nbespoke six-key aggregate inline — and because upload lines have no\nrich-text attribute, the show template never overwrites it, so that\ndistinct shape survives to the wire.",
+            "x-go-type-skip-optional-pointer": true
+          },
           "subject": {
             "type": "string"
+          },
+          "boosts_count": {
+            "type": "integer",
+            "description": "Boost count, emitted by the recording envelope when the branch passes\n`boostable` — chat lines and gauge needles.",
+            "format": "int32"
+          },
+          "boosts_url": {
+            "type": "string",
+            "description": "See `boosts_count` — the companion URL."
+          },
+          "language": {
+            "type": "string",
+            "description": "Language of a code chat line (`chats/lines/_code.json.jbuilder`);\nvalidated present on the model, so never null when the key is emitted."
+          },
+          "image_url": {
+            "type": "string",
+            "description": "Image URL of a soundtracked (play-kind) chat line whose sound carries an\nimage; such a line emits `image_url` in place of `content`."
+          },
+          "sound_url": {
+            "type": "string",
+            "description": "Sound URL of a play-kind chat line; always emitted for that kind."
+          },
+          "subscribers": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Person"
+            },
+            "description": "Everyone subscribed to the kanban list, as full Person projections.",
+            "x-go-type-skip-optional-pointer": true
+          },
+          "color": {
+            "type": "string",
+            "description": "Color of a kanban list or gauge needle. Emitted unconditionally by both\nbranches with a null value when unset, so it is nullable (the enhance\npass layers `nullable: true` onto the OpenAPI).",
+            "nullable": true
+          },
+          "cards_count": {
+            "type": "integer",
+            "description": "Number of cards in the kanban list.",
+            "format": "int32"
+          },
+          "comment_count": {
+            "type": "integer",
+            "description": "Comment count of a kanban list or gauge needle (branch-partial key,\nsingular `comment_count` — distinct from the envelope's\n`comments_count`, which a needle also carries).",
+            "format": "int32"
+          },
+          "cards_url": {
+            "type": "string",
+            "description": "API URL of the kanban list's cards."
+          },
+          "on_hold": {
+            "$ref": "#/components/schemas/CardColumnOnHold"
+          },
+          "comments_count": {
+            "type": "integer",
+            "description": "Comment count, emitted by the recording envelope when the branch passes\n`commentable` — gauge needles among the special branches, plus\ncommentable generic-branch types.",
+            "format": "int32"
+          },
+          "comments_url": {
+            "type": "string",
+            "description": "See `comments_count` — the companion URL."
+          },
+          "position": {
+            "type": "integer",
+            "description": "Position of the result. Two emitters share the key: the recording\nenvelope emits list position for positioned recordings (kanban lists\namong the special branches), and the gauge-needle branch overwrites it\nwith the needle's own 0–100 gauge position.",
+            "format": "int32"
+          },
+          "filename": {
+            "type": "string",
+            "description": "Filename of a file-attachment hit. This and the following file keys are\nemitted only by the file-attachment branch — the one branch that omits\nthe id/title/type/url/app_url envelope keys."
+          },
+          "content_type": {
+            "type": "string",
+            "description": "MIME type of a file-attachment hit."
+          },
+          "byte_size": {
+            "type": "integer",
+            "description": "Size in bytes of a file-attachment hit.",
+            "format": "int64"
+          },
+          "previewable": {
+            "type": "boolean",
+            "description": "Whether the file can be previewed."
+          },
+          "width": {
+            "type": "integer",
+            "description": "Pixel width, emitted only when the file is previewable. May be\nfloat-spelled (`1024.0`) and nullable, like every other blob dimension —\nsee `RichTextAttachment.width` for the cross-SDK typing note.",
+            "format": "int32",
+            "nullable": true,
+            "x-go-type": "types.FlexInt",
+            "x-go-type-import": {
+              "path": "github.com/basecamp/basecamp-sdk/go/pkg/types"
+            }
+          },
+          "height": {
+            "type": "integer",
+            "description": "See `width` — same conditional emission and nullable/float-spelled\nbehavior.",
+            "format": "int32",
+            "nullable": true,
+            "x-go-type": "types.FlexInt",
+            "x-go-type-import": {
+              "path": "github.com/basecamp/basecamp-sdk/go/pkg/types"
+            }
+          },
+          "preview_url": {
+            "type": "string",
+            "description": "Full-size preview URL of a file-attachment hit."
+          },
+          "thumbnail_url": {
+            "type": "string",
+            "description": "Thumbnail URL of a file-attachment hit."
+          },
+          "download_url": {
+            "type": "string",
+            "description": "Authenticated download URL of a file-attachment hit.",
+            "x-basecamp-auth-routable-url": {}
+          },
+          "app_download_url": {
+            "type": "string",
+            "description": "Web (app-host) download URL of a file-attachment hit."
           }
         },
         "required": [
-          "app_url",
           "content",
-          "description",
-          "id",
-          "title",
-          "type",
-          "url"
+          "description"
+        ]
+      },
+      "SearchResultAttachment": {
+        "type": "object",
+        "description": "A file attached to a search result, in either of two wire shapes.\n\nThis is an optional-field superset over the two variants the search\nprojection emits (the TimelineAttachment approach): the rich-text\nattachment/blob shape rendered through `attachments/_attachment` +\n`blobs/_blob` — the same emitters `RichTextAttachment` models — and the\nbespoke six-key aggregate a chat upload line builds inline in\n`chats/lines/_upload.json.jbuilder`. Only the four keys both variants\nalways emit are `@required`; the rest identify their variant.",
+        "properties": {
+          "filename": {
+            "type": "string",
+            "description": "Original filename (both variants)."
+          },
+          "content_type": {
+            "type": "string",
+            "description": "MIME type of the file (both variants)."
+          },
+          "byte_size": {
+            "type": "integer",
+            "description": "Size of the file in bytes (both variants).",
+            "format": "int64"
+          },
+          "download_url": {
+            "type": "string",
+            "description": "Authenticated download URL for the file (both variants).",
+            "x-basecamp-auth-routable-url": {}
+          },
+          "id": {
+            "type": "integer",
+            "description": "Attachment id (rich-text variant).",
+            "format": "int64"
+          },
+          "sgid": {
+            "type": "string",
+            "description": "Signed global id of the attachment (rich-text variant)."
+          },
+          "previewable": {
+            "type": "boolean",
+            "description": "Whether the blob can be previewed (rich-text variant)."
+          },
+          "preview_url": {
+            "type": "string",
+            "description": "Full-size preview URL (rich-text variant)."
+          },
+          "thumbnail_url": {
+            "type": "string",
+            "description": "Thumbnail URL (rich-text variant)."
+          },
+          "width": {
+            "type": "integer",
+            "description": "Pixel width (rich-text variant) — null for non-image blobs and may be\nfloat-spelled (`1024.0`); see `RichTextAttachment.width`.",
+            "format": "int32",
+            "nullable": true,
+            "x-go-type": "types.FlexInt",
+            "x-go-type-import": {
+              "path": "github.com/basecamp/basecamp-sdk/go/pkg/types"
+            }
+          },
+          "height": {
+            "type": "integer",
+            "description": "See `width` (rich-text variant).",
+            "format": "int32",
+            "nullable": true,
+            "x-go-type": "types.FlexInt",
+            "x-go-type-import": {
+              "path": "github.com/basecamp/basecamp-sdk/go/pkg/types"
+            }
+          },
+          "title": {
+            "type": "string",
+            "description": "Title of the attachment recording (chat upload-line variant)."
+          },
+          "url": {
+            "type": "string",
+            "description": "Browser preview URL of the blob (chat upload-line variant)."
+          }
+        },
+        "required": [
+          "byte_size",
+          "content_type",
+          "download_url",
+          "filename"
         ]
       },
       "SearchType": {
@@ -30787,6 +31192,21 @@
       "SetClientVisibilityResponseContent": {
         "$ref": "#/components/schemas/Recording"
       },
+      "StorageLimitErrorResponseContent": {
+        "type": "object",
+        "description": "The account has reached its file storage limit.\n\nRaised by ResourceLimits#ensure_account_can_upload_files ahead of any operation\nthat stores new bytes. No retry can satisfy it: the account needs more storage,\nso this maps to `limit_exceeded` rather than a retryable server error.",
+        "properties": {
+          "error": {
+            "type": "string"
+          },
+          "message": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "error"
+        ]
+      },
       "SubscribeResponseContent": {
         "$ref": "#/components/schemas/Subscription"
       },
@@ -31714,6 +32134,9 @@
           "status": {
             "type": "string"
           },
+          "visible_to_clients": {
+            "type": "boolean"
+          },
           "created_at": {
             "type": "string",
             "x-go-type": "time.Time",
@@ -31731,15 +32154,12 @@
           "title": {
             "type": "string"
           },
-          "name": {
-            "type": "string"
-          },
-          "enabled": {
+          "inherits_status": {
             "type": "boolean"
           },
-          "position": {
-            "type": "integer",
-            "format": "int32"
+          "type": {
+            "type": "string",
+            "description": "The tool's recordable type, e.g. `Chat::Transcript`, `Todoset`, `Vault`."
           },
           "url": {
             "type": "string"
@@ -31747,17 +32167,45 @@
           "app_url": {
             "type": "string"
           },
+          "bookmark_url": {
+            "type": "string"
+          },
+          "subscription_url": {
+            "type": "string",
+            "description": "Absent for tool types that are not subscribable."
+          },
+          "position": {
+            "type": "integer",
+            "description": "Emitted only for a positioned recording. For a docked tool that makes an\nabsent position the disabled signal — disabling removes the tool from the\ndock without deleting it. Positioning is independent of dockedness, so\nthis does not generalize: a nested vault is not docked and is positioned.",
+            "format": "int32"
+          },
+          "parent": {
+            "$ref": "#/components/schemas/RecordingParent"
+          },
           "bucket": {
             "$ref": "#/components/schemas/RecordingBucket"
+          },
+          "creator": {
+            "$ref": "#/components/schemas/Person"
+          },
+          "name": {
+            "type": "string",
+            "description": "Not emitted by this projection. The dock array on a project\n(`DockItem$name`) carries the tool's slug; this key is absent from every\nGetTool/CreateTool/UpdateTool response."
+          },
+          "enabled": {
+            "type": "boolean",
+            "description": "Not emitted by this projection. The dock array on a project\n(`DockItem$enabled`) is the authoritative enabled flag; on a docked tool's\nown response, an absent `position` is the equivalent signal."
           }
         },
         "required": [
           "created_at",
-          "enabled",
+          "creator",
           "id",
-          "name",
+          "inherits_status",
           "title",
-          "updated_at"
+          "type",
+          "updated_at",
+          "visible_to_clients"
         ]
       },
       "UnauthorizedErrorResponseContent": {
@@ -32793,6 +33241,87 @@
           "visible_to_clients"
         ]
       },
+      "UploadVersion": {
+        "type": "object",
+        "description": "A version event for an upload, from GET /uploads/{id}/versions.json.\n\n`action` is one of `created`, `active` (the upload's publication) or `blob_changed`\n(a file replacement). To list the file's PAST versions, select entries that carry\nan `upload` whose `current` is false — the original file arrives as `created` or\n`active`, never `blob_changed`, so filtering on that action drops the original\nand keeps the current file instead. This is an Event plus the file it recorded, rendered by its own\npartial rather than the shared event one, so upload fields don't leak onto todo,\nmessage and card events.",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "recording_id": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "action": {
+            "type": "string"
+          },
+          "details": {
+            "$ref": "#/components/schemas/EventDetails"
+          },
+          "created_at": {
+            "type": "string",
+            "x-go-type": "time.Time",
+            "x-go-type-import": {
+              "path": "time"
+            }
+          },
+          "creator": {
+            "$ref": "#/components/schemas/Person"
+          },
+          "boosts_count": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "boosts_url": {
+            "type": "string"
+          },
+          "upload": {
+            "$ref": "#/components/schemas/UploadVersionFile"
+          }
+        },
+        "required": [
+          "action",
+          "created_at",
+          "creator",
+          "id",
+          "recording_id"
+        ]
+      },
+      "UploadVersionFile": {
+        "type": "object",
+        "description": "The file a version event recorded — a reduced projection, not an Upload.",
+        "properties": {
+          "content_type": {
+            "type": "string"
+          },
+          "byte_size": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "filename": {
+            "type": "string"
+          },
+          "download_url": {
+            "type": "string",
+            "description": "Fetches THIS version's bytes. The upload's own download_url always serves the\nlatest, which is the whole point of the feature.",
+            "x-basecamp-auth-routable-url": {}
+          },
+          "app_download_url": {
+            "type": "string"
+          },
+          "current": {
+            "type": "boolean",
+            "description": "True for the newest version *event*, and for exactly one element of any\nnon-empty response. The renderer computes it positionally — `event ==\n@events.first` over a reverse-chronological list — so it is a property of\nordering, not of what the upload currently points at, and it cannot be\nzero or plural.\n\nThat distinction is the whole caveat: `current` does NOT mean \"this is the\nfile the upload's own download_url serves\". A metadata-only PUT swaps in a\nrecordable carrying the same blob and emits no event, so afterwards no\nevent references the upload's current recordable — and this flag still\nmarks exactly one element, the newest event. bc3 pins that case by name in\n\"exactly one version is current after a metadata-only update\"."
+          }
+        },
+        "required": [
+          "app_download_url",
+          "current",
+          "download_url",
+          "filename"
+        ]
+      },
       "ValidationErrorResponseContent": {
         "type": "object",
         "properties": {