{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/trimble/json-schema/trimble-topic-get-connect-schema.json",
  "title": "topic_GET_Connect",
  "x-generated": "2026-11-11",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/trimble-connect-topics-openapi.yml#/components/schemas/topic_GET_Connect",
  "type": "object",
  "required": [
    "guid",
    "title",
    "server_assigned_id",
    "creation_date",
    "creation_author"
  ],
  "properties": {
    "guid": {
      "type": "string"
    },
    "server_assigned_id": {
      "type": "string"
    },
    "topic_type": {
      "type": [
        "string",
        "null"
      ]
    },
    "topic_status": {
      "type": [
        "string",
        "null"
      ]
    },
    "reference_links": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "string"
      }
    },
    "title": {
      "type": "string"
    },
    "priority": {
      "type": [
        "string",
        "null"
      ]
    },
    "index": {
      "type": [
        "integer",
        "null"
      ]
    },
    "labels": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      }
    },
    "creation_date": {
      "type": "string"
    },
    "creation_author": {
      "type": "string"
    },
    "creation_author_uuid": {
      "type": "string"
    },
    "modified_date": {
      "type": "string"
    },
    "modified_author": {
      "type": "string"
    },
    "modified_author_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.\nNote that when both `assignees` and `assigned_to` are set in the request body, `assignees` will override `assigned_to`.\n",
      "type": [
        "array",
        "null"
      ],
      "items": {
        "$ref": "#/$defs/assignee_GET_Connect"
      }
    },
    "stage": {
      "type": [
        "string",
        "null"
      ]
    },
    "description": {
      "type": [
        "string",
        "null"
      ]
    },
    "bim_snippet": {
      "$ref": "#/$defs/bim_snippet"
    },
    "due_date": {
      "type": [
        "string",
        "null"
      ]
    },
    "marker": {
      "$ref": "#/$defs/marker_GET_Connect"
    },
    "viewpoint": {
      "$ref": "#/$defs/viewpoint_GET_Connect_Minimal"
    },
    "related_topics": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "$ref": "#/$defs/related_topic_GET"
      }
    },
    "files": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "$ref": "#/$defs/file_GET"
      }
    },
    "authorization": {
      "type": "object",
      "properties": {
        "topic_actions": {
          "$ref": "#/$defs/topic_actions"
        },
        "topic_status": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": "string"
          }
        }
      }
    }
  },
  "$defs": {
    "assignee_GET_Connect": {
      "type": "object",
      "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.\nNote that when both `assignees` and `assigned_to` are set in the request body, `assignees` will override `assigned_to`.\n",
      "required": [
        "id"
      ],
      "properties": {
        "id": {
          "type": "string",
          "description": "The Trimble Connect Id of the assignee."
        },
        "type": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "bim_snippet": {
      "type": [
        "object",
        "null"
      ],
      "required": [
        "snippet_type",
        "is_external",
        "reference",
        "reference_schema"
      ],
      "properties": {
        "snippet_type": {
          "type": "string"
        },
        "is_external": {
          "type": "string"
        },
        "reference": {
          "type": "string"
        },
        "reference_schema": {
          "type": "string"
        }
      }
    },
    "file_GET": {
      "description": "Schema for a single file GET, BCF REST API.",
      "type": "object",
      "properties": {
        "ifc_project": {
          "type": [
            "string",
            "null"
          ]
        },
        "ifc_spatial_structure_element": {
          "type": [
            "string",
            "null"
          ]
        },
        "filename": {
          "type": [
            "string",
            "null"
          ]
        },
        "date": {
          "type": [
            "string",
            "null"
          ]
        },
        "reference": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "marker_GET_Connect": {
      "type": "object",
      "properties": {
        "model_point": {
          "$ref": "#/$defs/point"
        }
      }
    },
    "point": {
      "type": "object",
      "properties": {
        "x": {
          "type": "number"
        },
        "y": {
          "type": "number"
        },
        "z": {
          "type": "number"
        }
      }
    },
    "related_topic_GET": {
      "description": "Schema for single related topic GET, BCF REST API.",
      "type": "object",
      "required": [
        "related_topic_guid"
      ],
      "properties": {
        "related_topic_guid": {
          "type": "string"
        }
      }
    },
    "topic_actions": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "update",
          "updateBimSnippet",
          "updateRelatedTopics",
          "updateDocumentReferences",
          "updateFiles",
          "createComment",
          "createViewpoint",
          "delete"
        ]
      }
    },
    "viewpoint_GET_Connect_Minimal": {
      "type": "object",
      "required": [
        "guid"
      ],
      "properties": {
        "guid": {
          "type": "string"
        },
        "view_id": {
          "type": [
            "string",
            "null"
          ]
        },
        "snapshot_url": {
          "type": [
            "string",
            "null"
          ]
        },
        "snapshot_thumb": {
          "type": [
            "string",
            "null"
          ],
          "description": "Base64 encoded string of the thumbnail image."
        }
      }
    }
  }
}