{"openapi":"3.0.0","info":{"title":"3D Markup API","description":"API for managing 3D markup data in projects","version":"1.0.0"},"servers":[{"url":"/api/v1","description":"Base API path"}],"paths":{"/projects/{projectId}/markup-3d/{id}":{"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"integer"},"description":"ID of the project"},{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"ID of the 3D markup"}],"get":{"summary":"Retrieve a 3D markup","description":"Get the specified 3D markup by ID","responses":{"200":{"description":"Successfully retrieved the 3D markup","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Markup3D"}}}},"404":{"description":"Markup not found"}}},"post":{"summary":"Create or update a 3D markup","description":"Save the 3D markup configuration for future retrieval","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Markup3DRequest"}}}},"responses":{"200":{"description":"Successfully updated an existing 3D markup","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Markup3D"}}}},"201":{"description":"Successfully created a new 3D markup","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Markup3D"}}}},"400":{"description":"Invalid input"}}}},"/projects/{projectId}/markup-3d/{id}/snapshot-filter":{"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"integer"},"description":"ID of the project"},{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"ID of the 3D markup"}],"get":{"summary":"Retrieve the filter snapshot for a 3D markup","description":"Get the filter panel configuration for the specified 3D markup","responses":{"200":{"description":"Successfully retrieved the filter snapshot","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilterPanelSnapshot"}}}},"404":{"description":"Markup not found"}}}},"/projects/{projectId}/markup-3d/{id}/snapshot-statusviz":{"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"integer"},"description":"ID of the project"},{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"ID of the 3D markup"}],"get":{"summary":"Retrieve the statusviz snapshot for a 3D markup","description":"Get the status visualization panel configuration for the specified 3D markup","responses":{"200":{"description":"Successfully retrieved the statusviz snapshot","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatusvizPanelSnapshot"}}}},"404":{"description":"Markup not found"}}}},"/projects/{projectId}/markup-3d/{id}/snapshot-explorer-groupby":{"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"integer"},"description":"ID of the project"},{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"ID of the 3D markup"}],"get":{"summary":"Retrieve the explorer groupby snapshot for a 3D markup","description":"Get the explorer panel groupby configuration for the specified 3D markup","responses":{"200":{"description":"Successfully retrieved the explorer groupby snapshot","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExplorePanelSnapshot"}}}},"404":{"description":"Markup not found"}}}}},"components":{"schemas":{"Markup3DBase":{"type":"object","properties":{"markupId":{"type":"string","description":"Unique identifier for the 3D markup"},"generic":{"type":"object","additionalProperties":true,"description":"Generic configuration settings for the 3D markup","properties":{"discardColor":{"type":"boolean","description":"Whether to discard color information"},"ghost":{"type":"boolean","description":"Whether to display objects as ghosted"},"colorsMgt":{"type":"array","items":{"type":"string","enum":["origin","filter","statusviz","custom-color"]},"description":"Order of color management priorities"}}},"reconIds":{"type":"array","items":{"$ref":"#/components/schemas/ReconItem"},"description":"List of recon items with their states"}}},"Markup3D":{"allOf":[{"$ref":"#/components/schemas/Markup3DBase"},{"type":"object","required":["markupId","generic"]}]},"Markup3DRequest":{"allOf":[{"$ref":"#/components/schemas/Markup3DBase"},{"type":"object","required":["generic"],"properties":{"markupId":{"description":"Unique identifier for the 3D markup (not required for creation, system will generate one)"}}}]},"ExplorePanelSnapshot":{"type":"object","properties":{"state":{"type":"string","enum":["open","closed"],"description":"Current state of the explore panel"},"groupby":{"type":"string","description":"Property to group items by"},"visibility":{"type":"string","description":"Current visibility setting ID"},"visibility-filter":{"type":"string","description":"Filter type for visibility"}}},"FilterPanelSnapshot":{"type":"object","properties":{"predicate":{"type":"string","description":"Type of predicate for filtering"},"predicate-value":{"type":"string","description":"Value of the predicate"},"colors":{"type":"object","additionalProperties":{"type":"string"},"description":"Mapping of attribute values to colors"}}},"StatusvizPanelSnapshot":{"type":"object","properties":{"predicate":{"type":"string","description":"Type of predicate for status visualization"},"predicate-value":{"type":"string","description":"Value of the predicate"},"colors":{"type":"object","additionalProperties":{"type":"string"},"description":"Mapping of status values to colors"}}},"ReconItem":{"type":"object","required":["reconId"],"properties":{"reconId":{"type":"string","description":"Unique identifier for the recon item"},"invisible":{"type":"string","enum":["selected","isolated"],"description":"Invisibility state of the recon item"},"color":{"type":"string","description":"Color of the recon item","example":"#FFA500","format":"color"}}}}}}