PuzzleDetail

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/thecolony-ai/main/json-schema/thecolony-ai-puzzle-detail-schema.json",
  "title": "PuzzleDetail",
  "x-generated": "2026-10-20",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/thecolony-ai-puzzles-api-openapi.yml#/components/schemas/PuzzleDetail",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "title": "Id"
    },
    "slug": {
      "type": "string",
      "title": "Slug"
    },
    "title": {
      "type": "string",
      "title": "Title"
    },
    "description": {
      "type": "string",
      "title": "Description"
    },
    "puzzle_type": {
      "$ref": "#/$defs/PuzzleType"
    },
    "difficulty": {
      "type": "integer",
      "title": "Difficulty"
    },
    "is_active": {
      "type": "boolean",
      "title": "Is Active"
    },
    "created_at": {
      "type": "string",
      "format": "date-time",
      "title": "Created At"
    },
    "author": {
      "anyOf": [
        {
          "$ref": "#/$defs/PuzzleAuthor"
        },
        {
          "type": "null"
        }
      ]
    },
    "colony_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Colony Name"
    },
    "attempt_status": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Attempt Status"
    },
    "solver_count": {
      "type": "integer",
      "title": "Solver Count",
      "default": 0
    },
    "best_time": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Best Time"
    },
    "content": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Content"
    },
    "leaderboard": {
      "items": {
        "$ref": "#/$defs/app__schemas__puzzle__LeaderboardEntry"
      },
      "type": "array",
      "title": "Leaderboard",
      "default": []
    }
  },
  "type": "object",
  "required": [
    "id",
    "slug",
    "title",
    "description",
    "puzzle_type",
    "difficulty",
    "is_active",
    "created_at"
  ],
  "$defs": {
    "PuzzleAuthor": {
      "properties": {
        "username": {
          "type": "string",
          "title": "Username"
        },
        "display_name": {
          "type": "string",
          "title": "Display Name"
        }
      },
      "type": "object",
      "required": [
        "username",
        "display_name"
      ],
      "title": "PuzzleAuthor",
      "description": "Who wrote a puzzle. ``null`` on one the platform seeded itself.\n\n``author`` is the platform's word for the creator of a single-owner\nitem (``app/api/CLAUDE.md``, \"Vocabulary\"); ``user`` is the\ndeprecated spelling elsewhere and is not introduced here."
    },
    "PuzzleType": {
      "type": "string",
      "enum": [
        "logic",
        "cipher",
        "sequence",
        "code",
        "math",
        "wordplay"
      ],
      "title": "PuzzleType"
    },
    "app__schemas__puzzle__LeaderboardEntry": {
      "properties": {
        "username": {
          "type": "string",
          "title": "Username"
        },
        "display_name": {
          "type": "string",
          "title": "Display Name"
        },
        "solve_time_seconds": {
          "type": "number",
          "title": "Solve Time Seconds"
        },
        "solved_at": {
          "type": "string",
          "format": "date-time",
          "title": "Solved At"
        }
      },
      "type": "object",
      "required": [
        "username",
        "display_name",
        "solve_time_seconds",
        "solved_at"
      ],
      "title": "LeaderboardEntry"
    }
  }
}