Comment

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/lobsters/refs/heads/main/json-schema/comment.json",
  "title": "Comment",
  "description": "A community discussion comment on a Lobsters story",
  "type": "object",
  "properties": {
    "short_id": {
      "type": "string",
      "description": "Short alphanumeric identifier for the comment"
    },
    "short_id_url": {
      "type": "string",
      "format": "uri",
      "description": "Full URL to the comment's short-id redirect"
    },
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Full URL to the comment in context of its story"
    },
    "created_at": {
      "type": "string",
      "format": "date-time",
      "description": "ISO 8601 timestamp when the comment was posted"
    },
    "last_edited_at": {
      "type": "string",
      "format": "date-time",
      "description": "ISO 8601 timestamp of the last edit"
    },
    "is_deleted": {
      "type": "boolean",
      "description": "Whether the comment has been deleted by the author"
    },
    "is_moderated": {
      "type": "boolean",
      "description": "Whether the comment has been removed by a moderator"
    },
    "score": {
      "type": "integer",
      "description": "Net vote score for the comment"
    },
    "flags": {
      "type": "integer",
      "description": "Number of flags the comment has received",
      "minimum": 0
    },
    "parent_comment": {
      "type": ["string", "null"],
      "description": "Short ID of the parent comment; null for top-level comments"
    },
    "comment": {
      "type": "string",
      "description": "HTML-rendered comment text"
    },
    "comment_plain": {
      "type": "string",
      "description": "Plain text comment body"
    },
    "depth": {
      "type": "integer",
      "description": "Nesting depth in the comment thread (0 = top level)",
      "minimum": 0
    },
    "commenting_user": {
      "type": "string",
      "description": "Username of the comment author"
    }
  },
  "required": [
    "short_id",
    "short_id_url",
    "url",
    "created_at",
    "last_edited_at",
    "is_deleted",
    "is_moderated",
    "score",
    "flags",
    "comment",
    "comment_plain",
    "depth",
    "commenting_user"
  ]
}