Task

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/task",
  "title": "Task",
  "type": "object",
  "description": "A task object.",
  "properties": {
    "id": {
      "type": "integer",
      "example": "abc123"
    },
    "created_on": {
      "type": "string",
      "format": "date-time",
      "example": "2026-01-15T10:30:00Z"
    },
    "updated_on": {
      "type": "string",
      "format": "date-time",
      "example": "2026-01-15T10:30:00Z"
    },
    "state": {
      "type": "string",
      "enum": [
        "RESOLVED",
        "UNRESOLVED"
      ],
      "example": "RESOLVED"
    },
    "content": {
      "type": "object",
      "properties": {
        "raw": {
          "type": "string",
          "description": "The text as it was typed by a user."
        },
        "markup": {
          "type": "string",
          "description": "The type of markup language the raw content is to be interpreted in.",
          "enum": [
            "markdown",
            "creole",
            "plaintext"
          ]
        },
        "html": {
          "type": "string",
          "description": "The user's content rendered as HTML."
        }
      },
      "additionalProperties": false,
      "example": "example_value"
    },
    "creator": {
      "$ref": "#/components/schemas/account"
    },
    "pending": {
      "type": "boolean",
      "example": true
    },
    "resolved_on": {
      "type": "string",
      "description": "The ISO8601 timestamp for when the task was resolved.",
      "format": "date-time",
      "example": "2026-01-15T10:30:00Z"
    },
    "resolved_by": {
      "$ref": "#/components/schemas/account"
    }
  },
  "required": [
    "created_on",
    "updated_on",
    "state",
    "content",
    "creator"
  ],
  "additionalProperties": false
}