{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/microsoft-azure-devops/json-schema/microsoft-azure-devops-work-item-comment-schema.json",
  "title": "WorkItemComment",
  "description": "A comment on a work item",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/microsoft-azure-devops-comments-api-openapi.yml#/components/schemas/WorkItemComment",
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "Unique ID of the comment"
    },
    "text": {
      "type": "string",
      "description": "Comment text in HTML format"
    },
    "workItemId": {
      "type": "integer",
      "description": "ID of the work item this comment belongs to"
    },
    "version": {
      "type": "integer",
      "description": "Version number of the comment"
    },
    "createdDate": {
      "type": "string",
      "format": "date-time",
      "description": "Date and time the comment was created"
    },
    "createdBy": {
      "$ref": "#/$defs/IdentityRef"
    },
    "modifiedDate": {
      "type": "string",
      "format": "date-time",
      "description": "Date and time the comment was last modified"
    },
    "modifiedBy": {
      "$ref": "#/$defs/IdentityRef"
    },
    "url": {
      "type": "string",
      "format": "uri"
    }
  },
  "$defs": {
    "IdentityRef": {
      "type": "object",
      "description": "Reference to an Azure DevOps user identity",
      "properties": {
        "id": {
          "type": "string",
          "format": "uuid",
          "description": "Unique identifier for the user"
        },
        "displayName": {
          "type": "string",
          "description": "Display name of the user"
        },
        "uniqueName": {
          "type": "string",
          "description": "Unique name (usually email address)"
        },
        "url": {
          "type": "string",
          "format": "uri"
        },
        "imageUrl": {
          "type": "string",
          "format": "uri",
          "description": "URL of the user's profile image"
        },
        "descriptor": {
          "type": "string",
          "description": "Subject descriptor for the identity"
        }
      }
    }
  }
}