[
  {
    "endpoint": "/api/ticket-messages",
    "method": "GET",
    "description": "Retrieve all ticket messages.",
    "responses": {
      "200": { "$ref": "../examples/ticket_messages/list.200.json" },
      "403": { "$ref": "../examples/errors/403.json" }
    }
  },
  {
    "endpoint": "/api/ticket-messages/:id",
    "method": "GET",
    "description": "Retrieve a ticket message by ID.",
    "request": {
      "params": { "id": "integer" }
    },
    "responses": {
      "200": { "$ref": "../examples/ticket_messages/get.200.json" },
      "403": { "$ref": "../examples/errors/403.json" },
      "404": { "$ref": "../examples/errors/404.json" }
    }
  },
  {
    "endpoint": "/api/ticket-messages",
    "method": "POST",
    "description": "Create a new ticket message.",
    "request": {
      "body": {
        "ticket_id": "integer (required, must exist in tickets)",
        "sender_id": "integer (required, must exist in users)",
        "body": "string (required, non-empty)"
      }
    },
    "responses": {
      "201": { "$ref": "../examples/ticket_messages/post.201.json" },
      "400": { "$ref": "../examples/errors/400.json" },
      "403": { "$ref": "../examples/errors/403.json" }
    }
  },
  {
    "endpoint": "/api/ticket-messages/:id",
    "method": "PUT",
    "description": "Update an existing ticket message.",
    "request": {
      "params": { "id": "integer" },
      "body": {
        "body": "string (optional, non-empty)"
      }
    },
    "responses": {
      "200": { "$ref": "../examples/ticket_messages/put.200.json" },
      "400": { "$ref": "../examples/errors/400.json" },
      "403": { "$ref": "../examples/errors/403.json" },
      "404": { "$ref": "../examples/errors/404.json" }
    }
  },
  {
    "endpoint": "/api/ticket-messages/:id",
    "method": "DELETE",
    "description": "Delete a ticket message by ID.",
    "request": {
      "params": { "id": "integer" }
    },
    "responses": {
      "200": { "$ref": "../examples/ticket_messages/delete.200.json" },
      "403": { "$ref": "../examples/errors/403.json" },
      "404": { "$ref": "../examples/errors/404.json" }
    }
  }
]