--- title: "Changes to Create or retrieve an identical vault item by immutable key" method: PUT path: "/vaults/{id_or_name}/items/{key}" --- # Changes to Create or retrieve an identical vault item by immutable key `PUT /vaults/{id_or_name}/items/{key}` > Every recorded change to this operation, newest first. ## Timeline Changed in 11 of 123 revisions. - **2026-10-28** `324a13ba3570`: 2 warning, 2 info - **2026-10-28** `8e5483977604`: 14 breaking, 18 info - **2026-10-28** `70e83a0e6df4`: 5 info - **2026-10-28** `5e31244c396e`: 2 info - **2026-10-27** `5a44792dcbd1`: 2 breaking, 16 warning, 19 info - **2026-10-26** `5e2df2c5fc38`: 24 warning - **2026-10-23** `1108efa87717`: 3 info - **2026-10-23** `ec192d3c071d`: 16 warning, 4 info - **2026-10-20** `d68735be0749`: 4 info - **2026-10-16** `93f6f617a81b`: 1 breaking - **2026-10-16** `03b369edee49`: 1 info ## Changes - **2026-10-28** `324a13ba3570`: 2 warning, 2 info - the `oneOf[#/components/schemas/CardVaultItemRequest]/spec/oneOf[#/components/schemas/ShopPayCardVaultItemSpec]/amount` request property's max was set to `1000000.00` - changed the pattern of the request property `oneOf[#/components/schemas/CardVaultItemRequest]/spec/oneOf[#/components/schemas/ShopPayCardVaultItemSpec]/currency` from `^[A-Za-z]{3}$` to `^[Uu][Ss][Dd]$` - the `oneOf[#/components/schemas/CardVaultItem]/spec/oneOf[#/components/schemas/ShopPayCardVaultItemSpec]/currency` response's property pattern was changed from `^[A-Za-z]{3}$` to `^[Uu][Ss][Dd]$` for the status `200` - the `oneOf[#/components/schemas/CardVaultItem]/spec/oneOf[#/components/schemas/ShopPayCardVaultItemSpec]/currency` response's property pattern was changed from `^[A-Za-z]{3}$` to `^[Uu][Ss][Dd]$` for the status `201` - **2026-10-28** `8e5483977604`: 14 breaking, 18 info - added `#/components/schemas/ShopPayCardState` to the `oneOf[#/components/schemas/CardVaultItem]/state` response property `oneOf` list for the response status `200` - added `#/components/schemas/ShopPayCardState` to the `oneOf[#/components/schemas/CardVaultItem]/state` response property `oneOf` list for the response status `201` - added `#/components/schemas/ShopPayCardVaultItemSpec` to the `oneOf[#/components/schemas/CardVaultItem]/spec` response property `oneOf` list for the response status `200` - added `#/components/schemas/ShopPayCardVaultItemSpec` to the `oneOf[#/components/schemas/CardVaultItem]/spec` response property `oneOf` list for the response status `201` - added `#/components/schemas/ShopPayOAuthAction` to the `oneOf[#/components/schemas/CardVaultItem]/action` response property `oneOf` list for the response status `200` - added `#/components/schemas/ShopPayOAuthAction` to the `oneOf[#/components/schemas/CardVaultItem]/action` response property `oneOf` list for the response status `201` - added `#/components/schemas/ShopPayOAuthAction` to the `oneOf[#/components/schemas/PaymentRequestVaultItem]/action` response property `oneOf` list for the response status `200` - added `#/components/schemas/ShopPayOAuthAction` to the `oneOf[#/components/schemas/PaymentRequestVaultItem]/action` response property `oneOf` list for the response status `201` - added `#/components/schemas/ShopPayOAuthAction` to the `oneOf[#/components/schemas/WalletVaultItem]/action` response property `oneOf` list for the response status `200` - added `#/components/schemas/ShopPayOAuthAction` to the `oneOf[#/components/schemas/WalletVaultItem]/action` response property `oneOf` list for the response status `201` - added `#/components/schemas/ShopPayWalletState` to the `oneOf[#/components/schemas/WalletVaultItem]/state` response property `oneOf` list for the response status `200` - added `#/components/schemas/ShopPayWalletState` to the `oneOf[#/components/schemas/WalletVaultItem]/state` response property `oneOf` list for the response status `201` - added `#/components/schemas/ShopPayWalletVaultItemSpec` to the `oneOf[#/components/schemas/WalletVaultItem]/spec` response property `oneOf` list for the response status `200` - added `#/components/schemas/ShopPayWalletVaultItemSpec` to the `oneOf[#/components/schemas/WalletVaultItem]/spec` response property `oneOf` list for the response status `201` - added `shop_pay` discriminator mapping keys to the `oneOf[#/components/schemas/CardVaultItemRequest]/spec` request property - added `shop_pay` discriminator mapping keys to the `oneOf[#/components/schemas/WalletVaultItemRequest]/spec` request property - added `#/components/schemas/ShopPayCardVaultItemSpec` to the `oneOf[#/components/schemas/CardVaultItemRequest]/spec` request property `oneOf` list - added `#/components/schemas/ShopPayWalletVaultItemSpec` to the `oneOf[#/components/schemas/WalletVaultItemRequest]/spec` request property `oneOf` list - added `shop_pay` discriminator mapping keys to the `oneOf[#/components/schemas/CardVaultItem]/spec` response property for the response status `200` - added `shop_pay` discriminator mapping keys to the `oneOf[#/components/schemas/CardVaultItem]/spec` response property for the response status `201` - added `shop_pay` discriminator mapping keys to the `oneOf[#/components/schemas/CardVaultItem]/state` response property for the response status `200` - added `shop_pay` discriminator mapping keys to the `oneOf[#/components/schemas/CardVaultItem]/state` response property for the response status `201` - added `shop_pay` discriminator mapping keys to the `oneOf[#/components/schemas/WalletVaultItem]/spec` response property for the response status `200` - added `shop_pay` discriminator mapping keys to the `oneOf[#/components/schemas/WalletVaultItem]/spec` response property for the response status `201` - added `shop_pay` discriminator mapping keys to the `oneOf[#/components/schemas/WalletVaultItem]/state` response property for the response status `200` - added `shop_pay` discriminator mapping keys to the `oneOf[#/components/schemas/WalletVaultItem]/state` response property for the response status `201` - added `shop_pay_oauth` discriminator mapping keys to the `oneOf[#/components/schemas/CardVaultItem]/action` response property for the response status `200` - added `shop_pay_oauth` discriminator mapping keys to the `oneOf[#/components/schemas/CardVaultItem]/action` response property for the response status `201` - added `shop_pay_oauth` discriminator mapping keys to the `oneOf[#/components/schemas/PaymentRequestVaultItem]/action` response property for the response status `200` - added `shop_pay_oauth` discriminator mapping keys to the `oneOf[#/components/schemas/PaymentRequestVaultItem]/action` response property for the response status `201` - added `shop_pay_oauth` discriminator mapping keys to the `oneOf[#/components/schemas/WalletVaultItem]/action` response property for the response status `200` - added `shop_pay_oauth` discriminator mapping keys to the `oneOf[#/components/schemas/WalletVaultItem]/action` response property for the response status `201` - **2026-10-28** `70e83a0e6df4`: 5 info - added the new optional request property `oneOf[#/components/schemas/CredentialVaultItemRequest]/spec/oneOf[#/components/schemas/OnePasswordCredentialVaultItemSpecInput]/access_request_id` - added the new optional request property `oneOf[#/components/schemas/CredentialVaultItemRequest]/spec/oneOf[#/components/schemas/OnePasswordCredentialVaultItemSpecInput]/requests/entries/items/id` - added the new optional request property `oneOf[#/components/schemas/CredentialVaultItemRequest]/spec/oneOf[#/components/schemas/OnePasswordCredentialVaultItemSpecInput]/resolved` - added the optional property `oneOf[#/components/schemas/CredentialVaultItem]/spec/oneOf[#/components/schemas/OnePasswordCredentialVaultItemSpec]/requests/entries/items/id` to the response with the `200` status - added the optional property `oneOf[#/components/schemas/CredentialVaultItem]/spec/oneOf[#/components/schemas/OnePasswordCredentialVaultItemSpec]/requests/entries/items/id` to the response with the `201` status - **2026-10-28** `5e31244c396e`: 2 info - added the optional property `oneOf[#/components/schemas/CredentialVaultItem]/state/oneOf[#/components/schemas/OnePasswordCredentialVaultItemState]/access_request/resolved` to the response with the `200` status - added the optional property `oneOf[#/components/schemas/CredentialVaultItem]/state/oneOf[#/components/schemas/OnePasswordCredentialVaultItemState]/access_request/resolved` to the response with the `201` status - **2026-10-27** `5a44792dcbd1`: 2 breaking, 16 warning, 19 info - added `#/components/schemas/PaymentRequestVaultItem` to the response body `oneOf` list for the response status `200` - added `#/components/schemas/PaymentRequestVaultItem` to the response body `oneOf` list for the response status `201` - added the new `add_payment_method` enum value to the `oneOf[#/components/schemas/CardVaultItem]/available_operations/items/type` response property for the response status `200` - added the new `add_payment_method` enum value to the `oneOf[#/components/schemas/CardVaultItem]/available_operations/items/type` response property for the response status `201` - added the new `add_payment_method` enum value to the `oneOf[#/components/schemas/CredentialAccountVaultItem]/available_operations/items/type` response property for the response status `200` - added the new `add_payment_method` enum value to the `oneOf[#/components/schemas/CredentialAccountVaultItem]/available_operations/items/type` response property for the response status `201` - added the new `add_payment_method` enum value to the `oneOf[#/components/schemas/CredentialVaultItem]/available_operations/items/type` response property for the response status `200` - added the new `add_payment_method` enum value to the `oneOf[#/components/schemas/CredentialVaultItem]/available_operations/items/type` response property for the response status `201` - added the new `add_payment_method` enum value to the `oneOf[#/components/schemas/WalletVaultItem]/available_operations/items/type` response property for the response status `200` - added the new `add_payment_method` enum value to the `oneOf[#/components/schemas/WalletVaultItem]/available_operations/items/type` response property for the response status `201` - added the new `remove_payment_method` enum value to the `oneOf[#/components/schemas/CardVaultItem]/available_operations/items/type` response property for the response status `200` - added the new `remove_payment_method` enum value to the `oneOf[#/components/schemas/CardVaultItem]/available_operations/items/type` response property for the response status `201` - added the new `remove_payment_method` enum value to the `oneOf[#/components/schemas/CredentialAccountVaultItem]/available_operations/items/type` response property for the response status `200` - added the new `remove_payment_method` enum value to the `oneOf[#/components/schemas/CredentialAccountVaultItem]/available_operations/items/type` response property for the response status `201` - added the new `remove_payment_method` enum value to the `oneOf[#/components/schemas/CredentialVaultItem]/available_operations/items/type` response property for the response status `200` - added the new `remove_payment_method` enum value to the `oneOf[#/components/schemas/CredentialVaultItem]/available_operations/items/type` response property for the response status `201` - added the new `remove_payment_method` enum value to the `oneOf[#/components/schemas/WalletVaultItem]/available_operations/items/type` response property for the response status `200` - added the new `remove_payment_method` enum value to the `oneOf[#/components/schemas/WalletVaultItem]/available_operations/items/type` response property for the response status `201` - added the new optional request property `oneOf[#/components/schemas/CardVaultItemRequest]/spec/oneOf[#/components/schemas/KernelCardVaultItemSpec]/payment_method_id` - added `payment_request` mapping keys to the request discriminator - added `#/components/schemas/PaymentRequestVaultItemRequest` to the request body `oneOf` list - added `payment_request` mapping keys to the response discriminator for the response status `200` - added `payment_request` mapping keys to the response discriminator for the response status `201` - added the optional property `oneOf[#/components/schemas/CardVaultItem]/spec/oneOf[#/components/schemas/KernelCardVaultItemSpec]/payment_method_id` to the response with the `200` status - added the optional property `oneOf[#/components/schemas/CardVaultItem]/spec/oneOf[#/components/schemas/KernelCardVaultItemSpec]/payment_method_id` to the response with the `201` status - added the optional property `oneOf[#/components/schemas/CardVaultItem]/state/oneOf[#/components/schemas/KernelCardState]/funding_status` to the response with the `200` status - added the optional property `oneOf[#/components/schemas/CardVaultItem]/state/oneOf[#/components/schemas/KernelCardState]/funding_status` to the response with the `201` status - added the optional property `oneOf[#/components/schemas/CardVaultItem]/state/oneOf[#/components/schemas/KernelCardState]/payment_method_id` to the response with the `200` status - added the optional property `oneOf[#/components/schemas/CardVaultItem]/state/oneOf[#/components/schemas/KernelCardState]/payment_method_id` to the response with the `201` status - added the optional property `oneOf[#/components/schemas/WalletVaultItem]/expanded/payment_methods/items/action` to the response with the `200` status - added the optional property `oneOf[#/components/schemas/WalletVaultItem]/expanded/payment_methods/items/action` to the response with the `201` status - added the optional property `oneOf[#/components/schemas/WalletVaultItem]/expanded/payment_methods/items/expires_at` to the response with the `200` status - added the optional property `oneOf[#/components/schemas/WalletVaultItem]/expanded/payment_methods/items/expires_at` to the response with the `201` status - added the optional property `oneOf[#/components/schemas/WalletVaultItem]/expanded/payment_methods/items/status` to the response with the `200` status - added the optional property `oneOf[#/components/schemas/WalletVaultItem]/expanded/payment_methods/items/status` to the response with the `201` status - added the optional property `oneOf[#/components/schemas/WalletVaultItem]/expanded/payment_methods/items/status_reason` to the response with the `200` status - added the optional property `oneOf[#/components/schemas/WalletVaultItem]/expanded/payment_methods/items/status_reason` to the response with the `201` status - **2026-10-26** `5e2df2c5fc38`: 24 warning - added the new `arm_passkey` enum value to the `oneOf[#/components/schemas/CardVaultItem]/available_operations/items/type` response property for the response status `200` - added the new `arm_passkey` enum value to the `oneOf[#/components/schemas/CardVaultItem]/available_operations/items/type` response property for the response status `201` - added the new `arm_passkey` enum value to the `oneOf[#/components/schemas/CredentialAccountVaultItem]/available_operations/items/type` response property for the response status `200` - added the new `arm_passkey` enum value to the `oneOf[#/components/schemas/CredentialAccountVaultItem]/available_operations/items/type` response property for the response status `201` - added the new `arm_passkey` enum value to the `oneOf[#/components/schemas/CredentialVaultItem]/available_operations/items/type` response property for the response status `200` - added the new `arm_passkey` enum value to the `oneOf[#/components/schemas/CredentialVaultItem]/available_operations/items/type` response property for the response status `201` - added the new `arm_passkey` enum value to the `oneOf[#/components/schemas/WalletVaultItem]/available_operations/items/type` response property for the response status `200` - added the new `arm_passkey` enum value to the `oneOf[#/components/schemas/WalletVaultItem]/available_operations/items/type` response property for the response status `201` - added the new `disarm_passkey` enum value to the `oneOf[#/components/schemas/CardVaultItem]/available_operations/items/type` response property for the response status `200` - added the new `disarm_passkey` enum value to the `oneOf[#/components/schemas/CardVaultItem]/available_operations/items/type` response property for the response status `201` - added the new `disarm_passkey` enum value to the `oneOf[#/components/schemas/CredentialAccountVaultItem]/available_operations/items/type` response property for the response status `200` - added the new `disarm_passkey` enum value to the `oneOf[#/components/schemas/CredentialAccountVaultItem]/available_operations/items/type` response property for the response status `201` - added the new `disarm_passkey` enum value to the `oneOf[#/components/schemas/CredentialVaultItem]/available_operations/items/type` response property for the response status `200` - added the new `disarm_passkey` enum value to the `oneOf[#/components/schemas/CredentialVaultItem]/available_operations/items/type` response property for the response status `201` - added the new `disarm_passkey` enum value to the `oneOf[#/components/schemas/WalletVaultItem]/available_operations/items/type` response property for the response status `200` - added the new `disarm_passkey` enum value to the `oneOf[#/components/schemas/WalletVaultItem]/available_operations/items/type` response property for the response status `201` - added the new `register_passkey` enum value to the `oneOf[#/components/schemas/CardVaultItem]/available_operations/items/type` response property for the response status `200` - added the new `register_passkey` enum value to the `oneOf[#/components/schemas/CardVaultItem]/available_operations/items/type` response property for the response status `201` - added the new `register_passkey` enum value to the `oneOf[#/components/schemas/CredentialAccountVaultItem]/available_operations/items/type` response property for the response status `200` - added the new `register_passkey` enum value to the `oneOf[#/components/schemas/CredentialAccountVaultItem]/available_operations/items/type` response property for the response status `201` - added the new `register_passkey` enum value to the `oneOf[#/components/schemas/CredentialVaultItem]/available_operations/items/type` response property for the response status `200` - added the new `register_passkey` enum value to the `oneOf[#/components/schemas/CredentialVaultItem]/available_operations/items/type` response property for the response status `201` - added the new `register_passkey` enum value to the `oneOf[#/components/schemas/WalletVaultItem]/available_operations/items/type` response property for the response status `200` - added the new `register_passkey` enum value to the `oneOf[#/components/schemas/WalletVaultItem]/available_operations/items/type` response property for the response status `201` - **2026-10-23** `1108efa87717`: 3 info - added the new optional request property `oneOf[#/components/schemas/CardVaultItemRequest]/spec/oneOf[#/components/schemas/LinkCardVaultItemSpec]/recurring` - added the optional property `oneOf[#/components/schemas/CardVaultItem]/spec/oneOf[#/components/schemas/LinkCardVaultItemSpec]/recurring` to the response with the `200` status - added the optional property `oneOf[#/components/schemas/CardVaultItem]/spec/oneOf[#/components/schemas/LinkCardVaultItemSpec]/recurring` to the response with the `201` status - **2026-10-23** `ec192d3c071d`: 16 warning, 4 info - added the new `link_shipping_addresses` enum value to the `oneOf[#/components/schemas/CardVaultItem]/available_expansions/items/type` response property for the response status `200` - added the new `link_shipping_addresses` enum value to the `oneOf[#/components/schemas/CardVaultItem]/available_expansions/items/type` response property for the response status `201` - added the new `link_shipping_addresses` enum value to the `oneOf[#/components/schemas/CredentialAccountVaultItem]/available_expansions/items/type` response property for the response status `200` - added the new `link_shipping_addresses` enum value to the `oneOf[#/components/schemas/CredentialAccountVaultItem]/available_expansions/items/type` response property for the response status `201` - added the new `link_shipping_addresses` enum value to the `oneOf[#/components/schemas/CredentialVaultItem]/available_expansions/items/type` response property for the response status `200` - added the new `link_shipping_addresses` enum value to the `oneOf[#/components/schemas/CredentialVaultItem]/available_expansions/items/type` response property for the response status `201` - added the new `link_shipping_addresses` enum value to the `oneOf[#/components/schemas/WalletVaultItem]/available_expansions/items/type` response property for the response status `200` - added the new `link_shipping_addresses` enum value to the `oneOf[#/components/schemas/WalletVaultItem]/available_expansions/items/type` response property for the response status `201` - added the new `link_user_info` enum value to the `oneOf[#/components/schemas/CardVaultItem]/available_expansions/items/type` response property for the response status `200` - added the new `link_user_info` enum value to the `oneOf[#/components/schemas/CardVaultItem]/available_expansions/items/type` response property for the response status `201` - added the new `link_user_info` enum value to the `oneOf[#/components/schemas/CredentialAccountVaultItem]/available_expansions/items/type` response property for the response status `200` - added the new `link_user_info` enum value to the `oneOf[#/components/schemas/CredentialAccountVaultItem]/available_expansions/items/type` response property for the response status `201` - added the new `link_user_info` enum value to the `oneOf[#/components/schemas/CredentialVaultItem]/available_expansions/items/type` response property for the response status `200` - added the new `link_user_info` enum value to the `oneOf[#/components/schemas/CredentialVaultItem]/available_expansions/items/type` response property for the response status `201` - added the new `link_user_info` enum value to the `oneOf[#/components/schemas/WalletVaultItem]/available_expansions/items/type` response property for the response status `200` - added the new `link_user_info` enum value to the `oneOf[#/components/schemas/WalletVaultItem]/available_expansions/items/type` response property for the response status `201` - added the optional property `oneOf[#/components/schemas/WalletVaultItem]/expanded/link_shipping_addresses` to the response with the `200` status - added the optional property `oneOf[#/components/schemas/WalletVaultItem]/expanded/link_shipping_addresses` to the response with the `201` status - added the optional property `oneOf[#/components/schemas/WalletVaultItem]/expanded/link_user_info` to the response with the `200` status - added the optional property `oneOf[#/components/schemas/WalletVaultItem]/expanded/link_user_info` to the response with the `201` status - **2026-10-20** `d68735be0749`: 4 info - added the optional property `oneOf[#/components/schemas/CardVaultItem]/action/oneOf[#/components/schemas/CardEnrollmentAction]/capture_token` to the response with the `200` status - added the optional property `oneOf[#/components/schemas/CardVaultItem]/action/oneOf[#/components/schemas/CardEnrollmentAction]/capture_token` to the response with the `201` status - added the optional property `oneOf[#/components/schemas/WalletVaultItem]/action/oneOf[#/components/schemas/CardEnrollmentAction]/capture_token` to the response with the `200` status - added the optional property `oneOf[#/components/schemas/WalletVaultItem]/action/oneOf[#/components/schemas/CardEnrollmentAction]/capture_token` to the response with the `201` status - **2026-10-16** `93f6f617a81b`: 1 breaking - the `oneOf[#/components/schemas/CardVaultItemRequest]/spec/oneOf[#/components/schemas/LinkCardVaultItemSpec]/amount` request property's max was decreased to `50000.00` - **2026-10-16** `03b369edee49`: 1 info - endpoint added --- [Operation](https://skmtc.dev/kernel/apis/kernel-api/docs/vaults/:id_or_name/items/:key/put.md) - [API](https://skmtc.dev/kernel/apis/kernel-api.md) - [Page](https://skmtc.dev/kernel/apis/kernel-api/changes/vaults/:id_or_name/items/:key/put)