> ## Documentation Index
> Fetch the complete documentation index at: https://www.1password.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Update an Item



## OpenAPI

````yaml /openapi/connect_server_api.yaml put /vaults/{vaultUuid}/items/{itemUuid}
openapi: 3.0.2
info:
  title: 1Password Connect
  description: REST API interface for 1Password Connect.
  version: 1.8.1
  contact:
    name: 1Password Integrations
    email: support@1password.com
    url: https://support.1password.com/
servers:
  - url: http://localhost:8080/v1
security: []
tags:
  - name: Items
    description: Access and manage items inside 1Password Vaults
  - name: Vaults
    description: Access 1Password Vaults
  - name: Activity
    description: Access API Request Activity
paths:
  /vaults/{vaultUuid}/items/{itemUuid}:
    put:
      tags:
        - Items
      summary: Update an Item
      operationId: UpdateVaultItem
      parameters:
        - in: path
          name: vaultUuid
          schema:
            type: string
            pattern: ^[\da-z]{26}$
          required: true
          description: The UUID of the Item's Vault
        - in: path
          name: itemUuid
          schema:
            type: string
            pattern: ^[\da-z]{26}$
          required: true
          description: The UUID of the Item to update
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FullItem'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FullItem'
        '400':
          description: Unable to create item due to invalid input
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                status: 400
                message: The item doesn't have a {example field name} field.
        '401':
          description: Invalid or missing token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                status: 401
                message: Invalid token signature
        '403':
          description: Unauthorized access
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                status: 403
                message: vault {vaultUuid} is not in scope
        '404':
          description: Item not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                itemNotFound:
                  summary: Item not found
                  value:
                    status: 404
                    message: item {itemUuid} not found
                vaultNotFound:
                  summary: Vault not found
                  value:
                    status: 404
                    message: vault {vaultUuid} not found
      security:
        - ConnectToken: []
components:
  schemas:
    FullItem:
      allOf:
        - $ref: '#/components/schemas/Item'
        - type: object
          properties:
            sections:
              type: array
              items:
                type: object
                properties:
                  id:
                    type: string
                  label:
                    type: string
            fields:
              type: array
              items:
                $ref: '#/components/schemas/Field'
            files:
              type: array
              items:
                $ref: '#/components/schemas/File'
    ErrorResponse:
      type: object
      properties:
        status:
          type: integer
          description: HTTP Status Code
        message:
          type: string
          description: A message detailing the error
    Item:
      type: object
      required:
        - vault
        - category
      properties:
        id:
          type: string
          pattern: ^[\da-z]{26}$
        title:
          type: string
        vault:
          type: object
          required:
            - id
          properties:
            id:
              type: string
              pattern: ^[\da-z]{26}$
        category:
          type: string
          enum:
            - 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
        urls:
          type: array
          items:
            type: object
            required:
              - href
            properties:
              label:
                type: string
              primary:
                type: boolean
              href:
                type: string
                format: url
          example:
            - primary: true
              href: https://example.com
            - href: https://example.org
        favorite:
          type: boolean
          default: false
        tags:
          type: array
          items:
            type: string
        version:
          type: integer
        state:
          type: string
          readOnly: true
          enum:
            - ARCHIVED
            - DELETED
        createdAt:
          type: string
          format: date-time
          readOnly: true
        updatedAt:
          type: string
          format: date-time
          readOnly: true
        lastEditedBy:
          type: string
          readOnly: true
    Field:
      type: object
      required:
        - id
        - type
      properties:
        id:
          type: string
        section:
          type: object
          properties:
            id:
              type: string
        type:
          type: string
          default: STRING
          enum:
            - STRING
            - EMAIL
            - CONCEALED
            - URL
            - OTP
            - DATE
            - MONTH_YEAR
            - MENU
        purpose:
          description: >-
            Some item types, Login and Password, have fields used for autofill.
            This property indicates that purpose and is required for some item
            types.
          type: string
          enum:
            - ''
            - USERNAME
            - PASSWORD
            - NOTES
        label:
          type: string
        value:
          type: string
        generate:
          description: >-
            If value is not present then a new value should be generated for
            this field
          type: boolean
          default: false
        recipe:
          $ref: '#/components/schemas/GeneratorRecipe'
        entropy:
          description: >-
            For fields with a purpose of `PASSWORD` this is the entropy of the
            value
          type: number
          readOnly: true
    File:
      type: object
      properties:
        id:
          type: string
          description: ID of the file
        name:
          type: string
          description: Name of the file
        size:
          type: integer
          description: Size in bytes of the file
        content_path:
          type: string
          description: >-
            Path of the Connect API that can be used to download the contents of
            this file.
          readOnly: true
        section:
          type: object
          description: For files that are in a section, this field describes the section.
          properties:
            id:
              type: string
        content:
          type: string
          format: byte
          description: >-
            Base64-encoded contents of the file. Only set if size <=
            OP_MAX_INLINE_FILE_SIZE_KB kb and `inline_files` is set to `true`.
      example:
        id: 6r65pjq33banznomn7q22sj44e
        name: foo.txt
        size: 35
        content_path: >-
          v1/vaults/ionaiwtdvgclrixbt6ztpqcxnq/items/p7eflcy7f5mk7vg6zrzf5rjjyu/files/6r65pjq33banznomn7q22sj44e/content
        content: VGhlIGZ1dHVyZSBiZWxvbmdzIHRvIHRoZSBjdXJpb3VzLgo=
    GeneratorRecipe:
      description: >-
        The recipe is used in conjunction with the "generate" property to set
        the character set used to generate a new secure value
      type: object
      properties:
        length:
          type: integer
          description: Length of the generated value
          default: 32
          minimum: 1
          maximum: 64
        characterSets:
          type: array
          items:
            type: string
            enum:
              - LETTERS
              - DIGITS
              - SYMBOLS
          minimum: 0
          maximum: 3
          uniqueItems: true
        excludeCharacters:
          type: string
          description: >-
            List of all characters that should be excluded from generated
            passwords.
          example: abc1
  securitySchemes:
    ConnectToken:
      type: http
      scheme: bearer
      bearerFormat: JWT

````