---
title: "Update an Item"
method: PUT
path: "/vaults/{vaultUuid}/items/{itemUuid}"
tags: ["Items"]
---

# Update an Item

`PUT /vaults/{vaultUuid}/items/{itemUuid}`

## Path parameters

- `vaultUuid` string, required
- `itemUuid` string, required

## Request body

- FullItem
  - `id` string
  - `title` string
  - `vault` object, required
    - `id` string, required
  - `category` 'LOGIN' | 'PASSWORD' | 'API_CREDENTIAL' | 'SERVER' | 'DATABASE' | 'CREDIT_CARD' | 'MEMBERSHIP' | 'PASSPORT' | 'SOFTWARE_LICENSE' | 'OUTDOOR_LICENSE' | 'SECURE_NOTE' | 'WIRELESS_ROUTER' | 'BANK_ACCOUNT' | 'DRIVER_LICENSE' | 'IDENTITY' | 'REWARD_PROGRAM' | 'DOCUMENT' | 'EMAIL_ACCOUNT' | 'SOCIAL_SECURITY_NUMBER' | 'MEDICAL_RECORD' | 'SSH_KEY' | 'CUSTOM', required
  - `urls` object[]
    - `label` string
    - `primary` boolean
    - `href` string, url, required
  - `favorite` boolean
  - `tags` string[]
  - `version` integer
  - `state` 'ARCHIVED' | 'DELETED'
  - `createdAt` string, date-time
  - `updatedAt` string, date-time
  - `lastEditedBy` string
  - `sections` object[]
    - `id` string
    - `label` string
  - `fields` Field[]
    - `id` string, required
    - `section` object
      - `id` string
    - `type` 'STRING' | 'EMAIL' | 'CONCEALED' | 'URL' | 'TOTP' | 'DATE' | 'MONTH_YEAR' | 'MENU', required
    - `purpose` '' | 'USERNAME' | 'PASSWORD' | 'NOTES' — Some item types, Login and Password, have fields used for autofill. This property indicates that purpose and is required for some item types.
    - `label` string
    - `value` string
    - `generate` boolean — If value is not present then a new value should be generated for this field
    - `recipe` GeneratorRecipe — The recipe is used in conjunction with the "generate" property to set the character set used to generate a new secure value
      - `length` integer — Length of the generated value
      - `characterSets` string[]
      - `excludeCharacters` string — List of all characters that should be excluded from generated passwords.
    - `entropy` number — For fields with a purpose of `PASSWORD` this is the entropy of the value
  - `files` File[]
    - `id` string — ID of the file
    - `name` string — Name of the file
    - `size` integer — Size in bytes of the file
    - `content_path` string — Path of the Connect API that can be used to download the contents of this file.
    - `section` object — For files that are in a section, this field describes the section.
      - `id` string
    - `content` string, byte — Base64-encoded contents of the file. Only set if size <= OP_MAX_INLINE_FILE_SIZE_KB kb and `inline_files` is set to `true`.

## Response `200`

OK

- FullItem
  - `id` string
  - `title` string
  - `vault` object, required
    - `id` string, required
  - `category` 'LOGIN' | 'PASSWORD' | 'API_CREDENTIAL' | 'SERVER' | 'DATABASE' | 'CREDIT_CARD' | 'MEMBERSHIP' | 'PASSPORT' | 'SOFTWARE_LICENSE' | 'OUTDOOR_LICENSE' | 'SECURE_NOTE' | 'WIRELESS_ROUTER' | 'BANK_ACCOUNT' | 'DRIVER_LICENSE' | 'IDENTITY' | 'REWARD_PROGRAM' | 'DOCUMENT' | 'EMAIL_ACCOUNT' | 'SOCIAL_SECURITY_NUMBER' | 'MEDICAL_RECORD' | 'SSH_KEY' | 'CUSTOM', required
  - `urls` object[]
    - `label` string
    - `primary` boolean
    - `href` string, url, required
  - `favorite` boolean
  - `tags` string[]
  - `version` integer
  - `state` 'ARCHIVED' | 'DELETED'
  - `createdAt` string, date-time
  - `updatedAt` string, date-time
  - `lastEditedBy` string
  - `sections` object[]
    - `id` string
    - `label` string
  - `fields` Field[]
    - `id` string, required
    - `section` object
      - `id` string
    - `type` 'STRING' | 'EMAIL' | 'CONCEALED' | 'URL' | 'TOTP' | 'DATE' | 'MONTH_YEAR' | 'MENU', required
    - `purpose` '' | 'USERNAME' | 'PASSWORD' | 'NOTES' — Some item types, Login and Password, have fields used for autofill. This property indicates that purpose and is required for some item types.
    - `label` string
    - `value` string
    - `generate` boolean — If value is not present then a new value should be generated for this field
    - `recipe` GeneratorRecipe — The recipe is used in conjunction with the "generate" property to set the character set used to generate a new secure value
      - `length` integer — Length of the generated value
      - `characterSets` string[]
      - `excludeCharacters` string — List of all characters that should be excluded from generated passwords.
    - `entropy` number — For fields with a purpose of `PASSWORD` this is the entropy of the value
  - `files` File[]
    - `id` string — ID of the file
    - `name` string — Name of the file
    - `size` integer — Size in bytes of the file
    - `content_path` string — Path of the Connect API that can be used to download the contents of this file.
    - `section` object — For files that are in a section, this field describes the section.
      - `id` string
    - `content` string, byte — Base64-encoded contents of the file. Only set if size <= OP_MAX_INLINE_FILE_SIZE_KB kb and `inline_files` is set to `true`.

## Other responses

- `400` — Unable to create item due to invalid input
- `401` — Invalid or missing token
- `403` — Unauthorized access
- `404` — Item not found

---

[API](https://skmtc.net/1password/apis/1password-connect.md) · [All operations](https://skmtc.net/1password/apis/1password-connect/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/1password/1password-connect/versions/819fa3a9a104/schema)