ONonkernel
Vaults

Create or retrieve an identical vault item by immutable key

Changed on

Create an item under a key unique within its vault, or retrieve the existing item when its specification matches. An identical card PUT returns the existing card in any lifecycle state without polling the provider, reauthorizing, replacing aliases, or resetting recovery. Conflicting specifications return 409. Provider-specific authorization requirements and retry behavior are described in the item's request schema. Do not use credential items to store, collect, or fill credit card data, including card numbers (PANs), security codes (CVV/CVC), or expiration dates. Use wallet, payment_request and card item types for credit cards and payment checkout instead. Where enabled, Link and Kernel purchases can be payment_request items parented by their wallet; card items remain supported for them and for AgentCard reusable cards.

put/vaults/{id_or_name}/items/{key}

Request

  • Base URL
    https://api.onkernel.com
  • URL
    https://api.onkernel.com/vaults/{id_or_name}/items/{key}
  • Auth
    HTTP bearer

Request body

OR
OR
OR
OR

Response

Existing matching item; card retries preserve identity and state

OR
OR
OR
OR

Changes

  • 324a13ba3570Revision changes
    • breaking

      added to the //// response property oneOf list for the response status

    • breaking

      added to the //// response property oneOf list for the response status

    • breaking

      added to the //// response property oneOf list for the response status

    • breaking

      added to the //// response property oneOf list for the response status

    • breaking

      added to the //// response property oneOf list for the response status

    • breaking

      added to the //// response property oneOf list for the response status

    • breaking

      added to the //// response property oneOf list for the response status

    • breaking

      added to the //// response property oneOf list for the response status

    • breaking

      added to the //// response property oneOf list for the response status

    • breaking

      added to the //// response property oneOf list for the response status

    • breaking

      added to the //// response property oneOf list for the response status

    • breaking

      added to the //// response property oneOf list for the response status

    • breaking

      added to the //// response property oneOf list for the response status

    • breaking

      added to the //// response property oneOf list for the response status

    • info

      added shop_pay discriminator mapping keys to the //// request property

    • info

      added shop_pay discriminator mapping keys to the //// request property

    • info

      added to the //// request property oneOf list

    • info

      added to the //// request property oneOf list

    • info

      added shop_pay discriminator mapping keys to the //// response property for the response status

    • info

      added shop_pay discriminator mapping keys to the //// response property for the response status

    • info

      added shop_pay discriminator mapping keys to the //// response property for the response status

    • info

      added shop_pay discriminator mapping keys to the //// response property for the response status

    • info

      added shop_pay discriminator mapping keys to the //// response property for the response status

    • info

      added shop_pay discriminator mapping keys to the //// response property for the response status

    • info

      added shop_pay discriminator mapping keys to the //// response property for the response status

    • info

      added shop_pay discriminator mapping keys to the //// response property for the response status

    • info

      added shop_pay_oauth discriminator mapping keys to the //// response property for the response status

    • info

      added shop_pay_oauth discriminator mapping keys to the //// response property for the response status

    • info

      added shop_pay_oauth discriminator mapping keys to the //// response property for the response status

    • info

      added shop_pay_oauth discriminator mapping keys to the //// response property for the response status

    • info

      added shop_pay_oauth discriminator mapping keys to the //// response property for the response status

    • info

      added shop_pay_oauth discriminator mapping keys to the //// response property for the response status

  • 70e83a0e6df4Revision changes
    • info

      added the new optional request property /////////

    • info

      added the new optional request property ////////////

    • info

      added the new optional request property /////////

    • info

      added the optional property //////////// to the response with the status

    • info

      added the optional property //////////// to the response with the status