@lunch-money/v2-api-spec 2.10.0-preview.3 → 2.10.0-preview.5

package/lunch-money-api-v2.yaml

@@ -74,7 +74,7 @@ tags:
       description: Learn more about crypto assets
       url: https://support.lunchmoney.app/setup/crypto
   - name: crypto-synced
-    description: Work with synced crypto assets and balances
+    description: Read and refresh synced crypto assets and balances. Creating and managing connections with synced crypto providers is done exclusively in the Lunch Money web app.
     externalDocs:
       description: Learn more about crypto assets
       url: https://support.lunchmoney.app/setup/crypto
@@ -597,10 +597,12 @@ components:
           x-updatable: false
         archived_at:
           type: string
+          format: date-time
           nullable: true
           description: System set date and time of when the category was last
-            archived (in the ISO 8601 extended format). Ignored if set.
-          x-updatable: false
+            archived (in the ISO 8601 extended format). Provide an ISO 8601
+            extended datetime or `null` to clear it.
+          x-updatable: true
         updated_at:
           type: string
           format: date-time
@@ -694,7 +696,7 @@ components:
         symbol:
           type: string
           minLength: 1
-          maxLength: 10
+          maxLength: 25
           description: Cryptocurrency symbol
         coingecko_id:
           type: string
@@ -711,12 +713,6 @@ components:
           nullable: true
           description: Date/time the balance was last updated in ISO 8601
             extended format
-        last_import:
-          type: string
-          format: date-time
-          nullable: true
-          description: Timestamp in ISO 8601 extended format of the last
-            successful import. This will be `null` for manual crypto balances.
         created_by_name:
           type: string
           nullable: true
@@ -741,7 +737,6 @@ components:
         - coingecko_id
         - to_base
         - balance_as_of
-        - last_import
         - created_by_name
         - created_at
         - updated_at
@@ -765,7 +760,7 @@ components:
         symbol:
           type: string
           minLength: 1
-          maxLength: 10
+          maxLength: 25
           description: Symbol of the currency held in the synced account
         coingecko_id:
           type: string
@@ -833,6 +828,17 @@ components:
           format: date-time
           description: Date/time the synced crypto connection was created in ISO
             8601 extended format
+        updated_at:
+          type: string
+          format: date-time
+          description: Date/time the synced crypto connection was last updated
+            in ISO 8601 extended format
+        last_import:
+          type: string
+          format: date-time
+          nullable: true
+          description: System defined timestamp in ISO 8601 extended format of
+            the last successful import.
         display_name:
           type: string
           nullable: true
@@ -848,6 +854,7 @@ components:
         - status
         - created_by_name
         - created_at
+        - updated_at
         - display_name
         - balances
 
@@ -890,13 +897,13 @@ components:
         coingecko_id:
           type: string
           minLength: 1
-          maxLength: 50
+          maxLength: 100
           description: System-defined CoinGecko identifier used to fetch
             the USD-based prices for this cryptocurrency.
         symbol:
           type: string
           minLength: 1
-          maxLength: 50
+          maxLength: 25
           description: Lowercase currency symbol that must be used as
             `symbol` when creating a manual crypto balance.
         full_name:
@@ -976,7 +983,7 @@ components:
         symbol:
           type: string
           minLength: 1
-          maxLength: 10
+          maxLength: 25
           description: Cryptocurrency symbol to track. Must match the `symbol`
             of one of the supported cryptocurrencies returned by `GET
             /cryptocurrencies`.
@@ -1032,7 +1039,7 @@ components:
         symbol:
           type: string
           minLength: 1
-          maxLength: 10
+          maxLength: 25
           description: Existing cryptocurrency symbol. Ignored if set.
           x-updatable: false
         coingecko_id:
@@ -1055,13 +1062,6 @@ components:
           description: System defined date/time the balance was last updated in
             ISO 8601 extended format. Ignored if set
           x-updatable: false
-        last_import:
-          type: string
-          format: date-time
-          nullable: true
-          description: System defined timestamp in ISO 8601 extended format of
-            the last successful import. Ignored if set
-          x-updatable: false
         created_by_name:
           type: string
           nullable: true
@@ -1964,8 +1964,9 @@ components:
           type: string
           format: date-time
           nullable: true
-          description: System-set time the tag was archived. Ignored if set.
-          x-updatable: false
+          description: If set, updates the archived timestamp for the tag.
+            Provide an ISO 8601 extended datetime or `null` to clear it.
+          x-updatable: true
 
     # The object returned when a DELETE /tag/:id request 
     # has an id for a tag that has dependencies  
@@ -2036,8 +2037,6 @@ components:
             Name of payee set by the user, the financial institution, or by 
             a matched recurring item. This will match the value 
             displayed in payee field on the transactions page in the Lunch Money app.
-          minLength: 0
-          maxLength: 140
         original_name:
           type: string
           nullable: true
@@ -2045,8 +2044,6 @@ components:
             institution, CSV, etc.). For Plaid transactions, this is the raw
             name before normalization. For manual/API transactions, this
             typically matches `payee`. May be null for older transactions.
-          minLength: 0
-          maxLength: 140
         category_id:
           type: integer
           format: int32
@@ -2319,8 +2316,6 @@ components:
             Name of payee set by the user, the financial institution, or by 
             a matched recurring item. This will match the value 
             displayed in payee field on the transactions page in the Lunch Money app.
-          minLength: 0
-          maxLength: 140
         original_name:
           type: string
           nullable: true
@@ -2328,8 +2323,6 @@ components:
             institution, CSV, etc.). For Plaid transactions, this is the raw
             name before normalization. For manual/API transactions, this
             typically matches `payee`. May be null for older transactions.
-          minLength: 0
-          maxLength: 140
         category_id:
           type: integer
           format: int32
@@ -2572,15 +2565,11 @@ components:
         payee:
           type: string
           description: Name of payee for the transaction
-          minLength: 0
-          maxLength: 140
         original_name:
           type: string
           nullable: true
           description: Original payee name. If not provided, defaults to `payee`
             value.
-          minLength: 0
-          maxLength: 140
         category_id:
           type: integer
           format: int32
@@ -2715,15 +2704,11 @@ components:
           type: string
           description: |
             The new payee for the transaction.
-          minLength: 0
-          maxLength: 140
           x-updatable: true
         original_name:
           type: string
           nullable: true
           description: Original payee name. Cannot be changed. Ignored if set.
-          minLength: 0
-          maxLength: 140
           x-updatable: false
         category_id:
           type: integer
@@ -5133,7 +5118,7 @@ paths:
         
         You may submit the response from a `GET /categories/{id}` as the request body; however, only certain
         properties can be updated using this API. The following properties are
-        accepted in the request body but their values will be ignored: `id`, `is_group`,`archived_at`, `updated_at`, `created_at`, and `order`.<br><br>
+        accepted in the request body but their values will be ignored: `id`, `is_group`, `updated_at`, `created_at`, and `order`.<br><br>
 
         It is also possible to provide only the properties to be updated in the
         request body, as long as the request includes at least one of the
@@ -5526,7 +5511,6 @@ paths:
                     coingecko_id: bitcoin
                     to_base: 53124.72
                     balance_as_of: "2026-02-25T14:22:10.000Z"
-                    last_import: null
                     created_by_name: User 1
                     created_at: "2025-11-12T20:14:32.000Z"
                     updated_at: "2026-02-25T14:22:10.000Z"
@@ -5584,7 +5568,6 @@ paths:
                 coingecko_id: ethereum
                 to_base: 28998.44
                 balance_as_of: "2026-03-01T09:20:41.000Z"
-                last_import: null
                 created_by_name: User 1
                 created_at: "2026-03-01T09:20:41.000Z"
                 updated_at: "2026-03-01T09:20:41.000Z"
@@ -5652,7 +5635,6 @@ paths:
                 coingecko_id: bitcoin
                 to_base: 53124.72
                 balance_as_of: "2026-02-25T14:22:10.000Z"
-                last_import: null
                 created_by_name: User 1
                 created_at: "2025-11-12T20:14:32.000Z"
                 updated_at: "2026-02-25T14:22:10.000Z"
@@ -5730,7 +5712,6 @@ paths:
                   coingecko_id: bitcoin
                   to_base: 56011.12
                   balance_as_of: "2026-03-01T09:41:18.000Z"
-                  last_import: null
                   created_by_name: User 1
                   created_at: "2025-11-12T20:14:32.000Z"
                   updated_at: "2026-02-25T14:22:10.000Z"
@@ -5751,7 +5732,6 @@ paths:
                 coingecko_id: bitcoin
                 to_base: 56011.12
                 balance_as_of: "2026-03-01T09:41:18.000Z"
-                last_import: null
                 created_by_name: User 1
                 created_at: "2025-11-12T20:14:32.000Z"
                 updated_at: "2026-03-01T09:41:18.000Z"
@@ -5872,6 +5852,7 @@ paths:
                     status: active
                     created_by_name: User 1
                     created_at: "2025-10-02T11:02:09.000Z"
+                    updated_at: "2026-02-25T14:25:01.000Z"
                     display_name: Coinbase Main
                     balances:
                       - name: ETH
@@ -5893,6 +5874,7 @@ paths:
                     status: relink
                     created_by_name: User 1
                     created_at: "2025-08-10T10:00:00.000Z"
+                    updated_at: "2026-02-26T07:22:30.000Z"
                     display_name: Kraken Wallet
                     balances:
                       - name: XRP
@@ -5944,6 +5926,7 @@ paths:
                 status: active
                 created_by_name: User 1
                 created_at: "2025-10-02T11:02:09.000Z"
+                updated_at: "2026-02-25T14:25:01.000Z"
                 display_name: Coinbase Main
                 balances:
                   - name: ETH
@@ -6009,7 +5992,7 @@ paths:
           schema:
             type: string
             minLength: 1
-            maxLength: 10
+            maxLength: 25
       responses:
         "200":
           description: Synced crypto balance object
@@ -9775,7 +9758,7 @@ paths:
         
         You may submit the response from a `GET /tags/{id}` as the request body; however, only certain
         properties can be updated using this API. The following system set properties are
-        accepted in the request body but their values will be ignored: `id`, `updated_at`, `created_at`, and `archived_at`.<br><br>
+        accepted in the request body but their values will be ignored: `id`, `updated_at`, and `created_at`.<br><br>
 
         It is also possible to provide only the properties to be updated in the
         request body, as long as the request includes at least one of the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunch-money/v2-api-spec",
-  "version": "2.10.0-preview.3",
+  "version": "2.10.0-preview.5",
   "description": "OpenAPI specification and version history for the Lunch Money v2 API",
   "main": "lunch-money-api-v2.yaml",
   "files": [

package/version-history.md

@@ -10,9 +10,11 @@ The Lunch Money API spec uses a modified version of SEMVER for its versioning me
   - Discovering the currently supported currencies for manually managed crypto assets
   - Managing the complete lifecycle of manually managed crypto assets (create, read, update, delete)
   - Viewing the balances for currencies associated with both manually managed crypto assets and those that are synced via a synced crypto account (ie: coinbase, kraken, ethereum wallet)
-deferred.
   - Refreshing synced crypto account balances
 
+## v2.9.1 - Apr, 2026
+- You may now set `archived_at` when modifying a category or tag via the `PUT /categories` or `PUT /tags` endpoints.
+
 ## v2.9.0 - Feb 26, 2026
 - Add initial `/budgets` endpoint support:
   - `GET /budgets/settings` for account budget settings