{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/trimble/json-schema/trimble-create-topic-dto-schema.json",
  "title": "CreateTopicDto",
  "x-generated": "2026-11-11",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/trimble-connect-topics-openapi.yml#/components/schemas/CreateTopicDto",
  "type": "object",
  "required": [
    "title"
  ],
  "properties": {
    "guid": {
      "type": [
        "string",
        "null"
      ]
    },
    "title": {
      "type": "string"
    },
    "description": {
      "type": [
        "string",
        "null"
      ]
    },
    "topic_type": {
      "type": [
        "string",
        "null"
      ]
    },
    "topic_status": {
      "type": [
        "string",
        "null"
      ]
    },
    "priority": {
      "type": [
        "string",
        "null"
      ]
    },
    "labels": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "string"
      }
    },
    "assigned_to": {
      "type": [
        "string",
        "null"
      ]
    },
    "assigned_to_uuid": {
      "type": [
        "string",
        "null"
      ]
    },
    "assignees": {
      "description": "The `assignees` is a Connect-specific extension of the `assigned_to` property specified by the BCF standard, making it possible to have multiple assignees. Note that when both `assignees` and `assigned_to` are set in the request body, `assignees` will override `assigned_to`.",
      "type": [
        "array",
        "null"
      ],
      "items": {
        "$ref": "#/$defs/AssigneeDto"
      }
    },
    "reference_links": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "string"
      }
    },
    "index": {
      "type": [
        "integer",
        "null"
      ],
      "format": "int32"
    },
    "stage": {
      "type": [
        "string",
        "null"
      ]
    },
    "creation_date": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "creation_author": {
      "type": [
        "string",
        "null"
      ]
    },
    "creation_author_uuid": {
      "type": [
        "string",
        "null"
      ]
    },
    "due_date": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "marker": {
      "$ref": "#/$defs/MarkerDto"
    },
    "bim_snippet": {
      "$ref": "#/$defs/BimSnippetDto"
    }
  },
  "additionalProperties": false,
  "$defs": {
    "AssigneeDto": {
      "type": "object",
      "required": [
        "id"
      ],
      "properties": {
        "id": {
          "type": "string",
          "description": "The Trimble Connect Id of the assignee."
        },
        "type": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "additionalProperties": false
    },
    "BimSnippetDto": {
      "type": "object",
      "required": [
        "snippet_type",
        "is_external",
        "reference",
        "reference_schema"
      ],
      "properties": {
        "snippet_type": {
          "type": [
            "string",
            "null"
          ]
        },
        "is_external": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "reference": {
          "type": [
            "string",
            "null"
          ]
        },
        "reference_schema": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "additionalProperties": false
    },
    "MarkerDto": {
      "type": "object",
      "properties": {
        "model_point": {
          "$ref": "#/$defs/PointDto"
        }
      },
      "additionalProperties": false
    },
    "PointDto": {
      "type": "object",
      "required": [
        "x",
        "y"
      ],
      "properties": {
        "x": {
          "type": "number",
          "format": "double"
        },
        "y": {
          "type": "number",
          "format": "double"
        },
        "z": {
          "type": "number",
          "format": "double"
        }
      },
      "additionalProperties": false
    }
  }
}