@37signals/basecamp 0.25.0 → 0.26.0

package/src/generated/openapi-stripped.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Basecamp",
-    "version": "2026-09-15",
+    "version": "2026-10-19",
     "description": "Basecamp API",
     "contact": {
       "name": "Basecamp",
@@ -597,6 +597,101 @@
             503
           ]
         }
+      },
+      "put": {
+        "description": "Replace the content of a boost. Only the boost's creator may update it: an\nadmin updating someone else's boost gets 403 Forbidden, as does any caller\nwhen comments are closed on the boosted recording. A boost on a deleted\nrecording, or in another account, answers 404. A missing or invalid\n`content` answers a bodiless 422. There is no bucket-scoped route.",
+        "operationId": "UpdateBoost",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/UpdateBoostRequestContent"
+              }
+            }
+          },
+          "required": true
+        },
+        "parameters": [
+          {
+            "name": "boostId",
+            "in": "path",
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            },
+            "required": true
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "UpdateBoost 200 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/UpdateBoostResponseContent"
+                }
+              }
+            }
+          },
+          "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": "BareValidationError 422 response"
+          },
+          "500": {
+            "description": "InternalServerError 500 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/InternalServerErrorResponseContent"
+                }
+              }
+            }
+          }
+        },
+        "tags": [
+          "Boosts"
+        ],
+        "x-basecamp-idempotent": {
+          "natural": true
+        },
+        "x-basecamp-retry": {
+          "maxAttempts": 3,
+          "baseDelayMs": 1000,
+          "backoff": "exponential",
+          "retryOn": [
+            429,
+            503
+          ]
+        }
       }
     },
     "/buckets/{bucketId}/card_tables/columns/{columnId}/color.json": {
@@ -928,7 +1023,7 @@
     },
     "/buckets/{bucketId}/card_tables/wormholes/{wormholeId}": {
       "delete": {
-        "description": "Delete a wormhole",
+        "description": "Permanently delete a card table's wormhole, the shortcut that sends cards to another card table.\n\nIt does not go to the trash and cannot be restored.",
         "operationId": "DeleteWormhole",
         "parameters": [
           {
@@ -1022,7 +1117,7 @@
         }
       },
       "put": {
-        "description": "Update a wormhole's destination column",
+        "description": "Point a card table's wormhole, its shortcut for sending cards to another card table, at a different destination column",
         "operationId": "UpdateWormhole",
         "requestBody": {
           "content": {
@@ -1125,7 +1220,7 @@
     },
     "/buckets/{bucketId}/card_tables/{cardTableId}/wormholes.json": {
       "post": {
-        "description": "Create a wormhole linking this card table to a column on another card table.\n\nA wormhole is the only mechanism for moving a card to a different project: its\nid is a valid `column_id` for MoveCard, teleporting the card across projects.\n`destinationRecordingId` is the id of a column on another accessible card table.",
+        "description": "Add a wormhole to a card table: a standing shortcut that sends cards to a column on another card table, usually in another project.\n\nA wormhole is the only mechanism for moving a card to a different project: its\nid is a valid `column_id` for MoveCard, teleporting the card there. It is not\nneeded for a one-off move within a project; MoveCard goes to any column there\ndirectly. A card table holds at most four wormholes.\n`destinationRecordingId` is the id of a column on another accessible card table.",
         "operationId": "CreateWormhole",
         "requestBody": {
           "content": {
@@ -3902,7 +3997,7 @@
     },
     "/card_tables/cards/{cardId}/moves.json": {
       "post": {
-        "description": "Move a card to a different column",
+        "description": "Move a card to any column in its project, including on another card table there, or through a linked wormhole to another project (queued: the card gets a new id, and position, if sent, must still be positive but doesn't set placement).\n\n`column_id` may be any column in the card's project, including a column on\nanother card table in the same project; the card moves there directly, with\nno wormhole needed. To send the card to another project, pass the id of a\nlinked wormhole (`linked: true`) the card table already has, listed in\nGetCardTable's `wormholes`; an unlinked or unreachable one returns not found.\nA move through a wormhole is queued: the card arrives under a new id and its\nold id then returns not found. `position` does not control where it lands,\nbut if supplied it must still be a positive integer.",
         "operationId": "MoveCard",
         "requestBody": {
           "content": {
@@ -6930,6 +7025,159 @@
         }
       }
     },
+    "/circles.json": {
+      "get": {
+        "description": "Get Pings: the caller's active Pings that have a line in them, most\nrecently updated first, in one unpaginated response. Archived Pings, and\nPings no one has posted in yet, are not listed; GetPing reads either by id.\n\nAnswers `403 Forbidden` (`{\"error\": \"Pings have been disabled\"}`) when the\ncaller cannot ping.",
+        "operationId": "ListPings",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "ListPings 200 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ListPingsResponseContent"
+                }
+              }
+            }
+          },
+          "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"
+                }
+              }
+            }
+          },
+          "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"
+                }
+              }
+            }
+          }
+        },
+        "tags": [
+          "Pings"
+        ],
+        "x-basecamp-retry": {
+          "maxAttempts": 3,
+          "baseDelayMs": 1000,
+          "backoff": "exponential",
+          "retryOn": [
+            429,
+            503
+          ]
+        }
+      },
+      "post": {
+        "description": "Create a Ping with people, or return the one that already holds exactly\nthem.\n\nThe caller is always included. Without `new_group`, an existing active\nPing with exactly these people (the oldest, if several) is returned rather\nthan a second one created; with `new_group: true` and more than one other\nperson, a new group is created every time. Either way the answer is\n`201 Created` with the Ping.\n\nAnswers `403 Forbidden` (`{\"error\": \"Pings have been disabled\"}`) when the\ncaller cannot ping, and a bodiless `422` when nobody in the Ping would be a\nperson who can ping.",
+        "operationId": "CreatePing",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CreatePingRequestContent"
+              }
+            }
+          },
+          "required": true
+        },
+        "parameters": [],
+        "responses": {
+          "201": {
+            "description": "CreatePing 201 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CreatePingResponseContent"
+                }
+              }
+            }
+          },
+          "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"
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "BareValidationError 422 response"
+          },
+          "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"
+                }
+              }
+            }
+          }
+        },
+        "tags": [
+          "Pings"
+        ],
+        "x-basecamp-retry": {
+          "maxAttempts": 2,
+          "baseDelayMs": 1000,
+          "backoff": "exponential",
+          "retryOn": [
+            429,
+            503
+          ]
+        }
+      }
+    },
     "/circles/people.json": {
       "get": {
         "description": "List all account users who can be pinged\n\n**Pagination**: Uses Link header (RFC5988). Follow the `next` rel URL\nto fetch additional pages. X-Total-Count header provides total count.",
@@ -7006,6 +7254,99 @@
         }
       }
     },
+    "/circles/{pingId}": {
+      "get": {
+        "description": "Get a Ping by its id, which is its bucket's id.\n\nAnswers `403 Forbidden` (`{\"error\": \"Pings have been disabled\"}`) when the\ncaller cannot ping, and `404 Not Found` for a bucket that is not a Ping the\ncaller is in.",
+        "operationId": "GetPing",
+        "parameters": [
+          {
+            "name": "pingId",
+            "in": "path",
+            "description": "A Ping's id is the id of the bucket that holds it (the bucket type is\n\"Circle\", which is also the wire path), so the `bucket.id` a Ping's\nrecordings carry is the id GetPing takes.",
+            "schema": {
+              "type": "integer",
+              "description": "A Ping's id is the id of the bucket that holds it (the bucket type is\n\"Circle\", which is also the wire path), so the `bucket.id` a Ping's\nrecordings carry is the id GetPing takes.",
+              "format": "int64"
+            },
+            "required": true
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "GetPing 200 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetPingResponseContent"
+                }
+              }
+            }
+          },
+          "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"
+                }
+              }
+            }
+          },
+          "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"
+                }
+              }
+            }
+          }
+        },
+        "tags": [
+          "Pings"
+        ],
+        "x-basecamp-retry": {
+          "maxAttempts": 3,
+          "baseDelayMs": 1000,
+          "backoff": "exponential",
+          "retryOn": [
+            429,
+            503
+          ]
+        }
+      }
+    },
     "/client/approvals/{approvalId}": {
       "get": {
         "description": "Get a single client approval by id",
@@ -27727,6 +28068,7 @@
             "items": {
               "$ref": "#/components/schemas/Wormhole"
             },
+            "description": "The card table's wormholes: shortcuts for sending cards to other card\ntables, usually in other projects. Only wormholes whose destination the\nrequester can reach are listed; the rest are omitted, not shown unlinked.\nNot needed to move a card within its project; MoveCard reaches any column\nthere directly.",
             "x-go-type-skip-optional-pointer": true
           }
         },
@@ -28886,6 +29228,29 @@
           "name"
         ]
       },
+      "CreatePingRequestContent": {
+        "type": "object",
+        "properties": {
+          "user_ids": {
+            "type": "array",
+            "items": {
+              "type": "integer",
+              "format": "int64"
+            },
+            "description": "Person ids of the people to ping. People the caller cannot reach are\ndropped."
+          },
+          "new_group": {
+            "type": "boolean",
+            "description": "Create a new group even when a Ping with exactly these people exists."
+          }
+        },
+        "required": [
+          "user_ids"
+        ]
+      },
+      "CreatePingResponseContent": {
+        "$ref": "#/components/schemas/Ping"
+      },
       "CreateProjectFromTemplateRequestContent": {
         "type": "object",
         "properties": {
@@ -31144,6 +31509,9 @@
       "GetPersonResponseContent": {
         "$ref": "#/components/schemas/Person"
       },
+      "GetPingResponseContent": {
+        "$ref": "#/components/schemas/Ping"
+      },
       "GetProgressReportResponseContent": {
         "type": "array",
         "items": {
@@ -31785,6 +32153,12 @@
           "$ref": "#/components/schemas/Person"
         }
       },
+      "ListPingsResponseContent": {
+        "type": "array",
+        "items": {
+          "$ref": "#/components/schemas/Ping"
+        }
+      },
       "ListProjectPeopleResponseContent": {
         "type": "array",
         "items": {
@@ -32155,6 +32529,7 @@
         "properties": {
           "column_id": {
             "type": "integer",
+            "description": "Any column in the card's project, on this or another card table, or a\nwormhole id to send the card to another project.",
             "format": "int64"
           },
           "position": {
@@ -32780,6 +33155,110 @@
           "name"
         ]
       },
+      "Ping": {
+        "type": "object",
+        "description": "A Ping: a private conversation between people, held in its own bucket with\none Campfire. The Campfire's lines are read and written through the\nCampfires service; `room_url` and `links.lines` name it.",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "description": "The Ping's id, which is also its bucket's id.",
+            "format": "int64"
+          },
+          "created_at": {
+            "type": "string",
+            "x-go-type": "time.Time",
+            "x-go-type-import": {
+              "path": "time"
+            }
+          },
+          "updated_at": {
+            "type": "string",
+            "x-go-type": "time.Time",
+            "x-go-type-import": {
+              "path": "time"
+            }
+          },
+          "title": {
+            "type": "string",
+            "description": "The Ping's name for the caller: its given name when `named`, else the\nnames of the other people in it."
+          },
+          "named": {
+            "type": "boolean",
+            "description": "Whether someone gave the Ping a name."
+          },
+          "image_url": {
+            "type": "string",
+            "description": "The Ping's own image, present only when one was uploaded."
+          },
+          "avatar_url": {
+            "type": "string",
+            "format": "password",
+            "x-basecamp-sensitive": {
+              "category": "pii",
+              "redact": true
+            }
+          },
+          "url": {
+            "type": "string"
+          },
+          "app_url": {
+            "type": "string"
+          },
+          "bookmark_url": {
+            "type": "string"
+          },
+          "room_url": {
+            "type": "string",
+            "description": "The Ping's Campfire (`/buckets/{bucketId}/chats/{campfireId}.json`)."
+          },
+          "edit_title_url": {
+            "type": "string",
+            "description": "Present only when the Ping can be renamed: one with more than one other\nperson in it."
+          },
+          "links": {
+            "$ref": "#/components/schemas/PingLinks"
+          },
+          "people": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Person"
+            },
+            "description": "The people in the Ping other than the caller; the caller alone when\nnobody else is in it."
+          }
+        },
+        "required": [
+          "app_url",
+          "avatar_url",
+          "bookmark_url",
+          "created_at",
+          "id",
+          "links",
+          "named",
+          "people",
+          "room_url",
+          "title",
+          "updated_at",
+          "url"
+        ]
+      },
+      "PingLinks": {
+        "type": "object",
+        "description": "The Ping's Campfire endpoints, so a client need not derive them from\n`room_url`. The wire object also repeats `url`, `app_url`, `bookmark_url`\nand `edit_title_url` as `self`, `app`, `bookmark` and `edit_title`; those\nare read from the Ping's own fields.",
+        "properties": {
+          "lines": {
+            "type": "string",
+            "description": "The Campfire's lines (`/buckets/{bucketId}/chats/{campfireId}/lines.json`)."
+          },
+          "files": {
+            "type": "string",
+            "description": "The Campfire's uploads."
+          }
+        },
+        "required": [
+          "files",
+          "lines"
+        ]
+      },
       "PollEventsResponseContent": {
         "type": "object",
         "description": "The poll envelope. Every 200 carries `events` and `position`; `next` only\nwhile the walk continues.",
@@ -36285,6 +36764,21 @@
       "UpdateAccountNameResponseContent": {
         "$ref": "#/components/schemas/Account"
       },
+      "UpdateBoostRequestContent": {
+        "type": "object",
+        "properties": {
+          "content": {
+            "type": "string",
+            "maxLength": 16
+          }
+        },
+        "required": [
+          "content"
+        ]
+      },
+      "UpdateBoostResponseContent": {
+        "$ref": "#/components/schemas/Boost"
+      },
       "UpdateCalendarRequestContent": {
         "type": "object",
         "properties": {
@@ -37466,7 +37960,7 @@
       },
       "Wormhole": {
         "type": "object",
-        "description": "A wormhole links this card table to a column on another card table, enabling\ncards to move across projects. It carries the full recording representation\nplus the destination-linkage fields. The wormhole's own `url`/`app_url`/`parent`\npoint at the *source* board; `destination_url` is the only field identifying\nthe destination column.",
+        "description": "A wormhole is a standing shortcut from this card table to a column on another\ncard table, usually in another project, and the only way to move a card across\nprojects. It carries the full recording representation\nplus the destination-linkage fields. The wormhole's own `url`/`app_url`/`parent`\npoint at the *source* board; `destination_url` is the only field identifying\nthe destination column.",
         "properties": {
           "id": {
             "type": "integer",

package/src/generated/path-mapping.ts

@@ -13,6 +13,7 @@ export const PATH_TO_OPERATION: Record<string, string> = {
   "PUT:/{accountId}/account/name.json": "UpdateAccountName",
   "DELETE:/{accountId}/boosts/{boostId}": "DeleteBoost",
   "GET:/{accountId}/boosts/{boostId}": "GetBoost",
+  "PUT:/{accountId}/boosts/{boostId}": "UpdateBoost",
   "POST:/{accountId}/buckets/{bucketId}/card_tables/{cardTableId}/wormholes.json": "CreateWormhole",
   "PUT:/{accountId}/buckets/{bucketId}/card_tables/columns/{columnId}/color.json": "SetCardColumnColor",
   "DELETE:/{accountId}/buckets/{bucketId}/card_tables/columns/{columnId}/on_hold.json": "DisableCardColumnOnHold",
@@ -76,6 +77,9 @@ export const PATH_TO_OPERATION: Record<string, string> = {
   "GET:/{accountId}/chats/{campfireId}/uploads.json": "ListCampfireUploads",
   "POST:/{accountId}/chats/{campfireId}/uploads.json": "CreateCampfireUpload",
   "GET:/{accountId}/checkins.json": "GetEverythingCheckins",
+  "GET:/{accountId}/circles.json": "ListPings",
+  "POST:/{accountId}/circles.json": "CreatePing",
+  "GET:/{accountId}/circles/{pingId}": "GetPing",
   "GET:/{accountId}/client/approvals/{approvalId}": "GetClientApproval",
   "GET:/{accountId}/client/correspondences/{correspondenceId}": "GetClientCorrespondence",
   "GET:/{accountId}/cloud_files/{cloudFileId}": "GetCloudFile",

package/src/generated/person-id-sites.ts

@@ -56,6 +56,9 @@ export const PERSON_ID_SITES: Readonly<Record<string, readonly string[]>> = {
   "CreateMessage": [
     "creator"
   ],
+  "CreatePing": [
+    "people.[]"
+  ],
   "CreateQuestion": [
     "creator"
   ],
@@ -403,6 +406,9 @@ export const PERSON_ID_SITES: Readonly<Record<string, readonly string[]>> = {
     "events.[].creator",
     "person"
   ],
+  "GetPing": [
+    "people.[]"
+  ],
   "GetProgressReport": [
     "[].attachments.[].creator",
     "[].creator"
@@ -577,6 +583,9 @@ export const PERSON_ID_SITES: Readonly<Record<string, readonly string[]>> = {
   "ListPingablePeople": [
     "[]"
   ],
+  "ListPings": [
+    "[].people.[]"
+  ],
   "ListProjectPeople": [
     "[]"
   ],
@@ -666,6 +675,9 @@ export const PERSON_ID_SITES: Readonly<Record<string, readonly string[]>> = {
   "Subscribe": [
     "subscribers.[]"
   ],
+  "UpdateBoost": [
+    "booster"
+  ],
   "UpdateCard": [
     "assignees.[]",
     "completer",