1Password · Schema

Item

Represents a summary of a 1Password item with basic metadata. Use the get item endpoint to retrieve full details.

Password ManagerPasswordsSecuritySecrets

Properties

Name	Type	Description
id	string	The unique identifier for the item.
title	string	The title of the item.
vault	object
category	string	The category of the item.
urls	array	URLs associated with the item.
favorite	boolean	Whether the item is marked as a favorite.
tags	array	Tags applied to the item.
version	integer	The version number of the item.
state	string	The state of the item.
createdAt	string	The date and time the item was created.
updatedAt	string	The date and time the item was last updated.
lastEditedBy	string	The UUID of the user who last edited the item.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/1password/refs/heads/main/json-schema/1password-connect-item-schema.json",
  "title": "Item",
  "description": "Represents a summary of a 1Password item with basic metadata. Use the get item endpoint to retrieve full details.",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "description": "The unique identifier for the item."
    },
    "title": {
      "type": "string",
      "description": "The title of the item."
    },
    "vault": {
      "$ref": "#/components/schemas/VaultRef"
    },
    "category": {
      "type": "string",
      "description": "The category of the item.",
      "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",
      "description": "URLs associated with the item.",
      "items": {
        "$ref": "#/components/schemas/Url"
      }
    },
    "favorite": {
      "type": "boolean",
      "description": "Whether the item is marked as a favorite."
    },
    "tags": {
      "type": "array",
      "description": "Tags applied to the item.",
      "items": {
        "type": "string"
      }
    },
    "version": {
      "type": "integer",
      "description": "The version number of the item."
    },
    "state": {
      "type": "string",
      "description": "The state of the item.",
      "enum": [
        "ARCHIVED",
        "DELETED"
      ]
    },
    "createdAt": {
      "type": "string",
      "format": "date-time",
      "description": "The date and time the item was created."
    },
    "updatedAt": {
      "type": "string",
      "format": "date-time",
      "description": "The date and time the item was last updated."
    },
    "lastEditedBy": {
      "type": "string",
      "format": "uuid",
      "description": "The UUID of the user who last edited the item."
    }
  }
}