1Password · JSON Structure

1Password Connect Item Structure

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

Type: object Properties: 12

Password ManagerPasswordsSecuritySecrets

Item is a JSON Structure definition published by 1Password, describing 12 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

id title vault category urls favorite tags version state createdAt updatedAt lastEditedBy

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/1password/refs/heads/main/json-structure/1password-connect-item-structure.json",
  "name": "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": "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": "int32",
      "description": "The version number of the item."
    },
    "state": {
      "type": "string",
      "description": "The state of the item.",
      "enum": [
        "ARCHIVED",
        "DELETED"
      ]
    },
    "createdAt": {
      "type": "datetime",
      "description": "The date and time the item was created."
    },
    "updatedAt": {
      "type": "datetime",
      "description": "The date and time the item was last updated."
    },
    "lastEditedBy": {
      "type": "uuid",
      "description": "The UUID of the user who last edited the item."
    }
  }
}