{"components":{"schemas":{"AssetAnimationMetadata":{"additionalProperties":false,"properties":{"duration":{"type":["number","null"]},"index":{"type":"number"},"name":{"type":"string"},"trackCount":{"description":"glTF animation channels; absent on older collected records.","type":"number"}},"required":["index","duration"],"type":"object"},"AssetBoundsMetadata":{"additionalProperties":false,"description":"Axis-aligned bounds in the default pose, not bounds over an animation.","properties":{"approximate":{"description":"True when skinning or morph targets make the default-pose estimate uncertain.","type":"boolean"},"center":{"$ref":"#/components/schemas/AssetVector3"},"dimensions":{"$ref":"#/components/schemas/AssetVector3"},"max":{"$ref":"#/components/schemas/AssetVector3"},"min":{"$ref":"#/components/schemas/AssetVector3"},"originOffset":{"$ref":"#/components/schemas/AssetVector3","description":"Translation needed to put the bounds center at the origin."},"pose":{"const":"default","type":"string"}},"required":["approximate","center","dimensions","max","min","originOffset","pose"],"type":"object"},"AssetCompanionMetadata":{"additionalProperties":false,"description":"Compact complexity totals for a companion model or LOD.","properties":{"asset":{"$ref":"#/components/schemas/AssetEmbeddedMetadata","description":"Omitted when identical to the entrypoint's embedded asset information."},"collectorVersion":{"description":"Revision of the collector that measured these facts.","type":"number"},"geometry":{"$ref":"#/components/schemas/AssetGeometryMetadata"}},"required":["collectorVersion","geometry"],"type":"object"},"AssetEmbeddedMetadata":{"additionalProperties":false,"properties":{"attribution":{"additionalProperties":false,"description":"Claims declared by the file, not verified licenses or ownership.","properties":{"author":{"type":"string"},"license":{"type":"string"},"source":{"type":"string"},"title":{"type":"string"}},"type":"object"},"copyright":{"type":"string"},"generator":{"type":"string"},"minVersion":{"type":"string"},"version":{"type":"string"}},"required":["version","attribution"],"type":"object"},"AssetGeometryMetadata":{"additionalProperties":false,"properties":{"meshes":{"type":"number"},"primitives":{"type":"number"},"triangles":{"description":"Triangles only; points/lines contribute zero. Unknown accessor counts give null.","type":["number","null"]},"vertices":{"description":"Unique POSITION accessor elements per mesh primitive; scene totals count placements.","type":["number","null"]}},"required":["meshes","primitives","vertices","triangles"],"type":"object"},"AssetImageMetadata":{"additionalProperties":false,"properties":{"encodedBytes":{"description":"Encoded image payload bytes; absent on older records.","type":["number","null"]},"estimatedRgba8Bytes":{"type":["number","null"]},"height":{"type":["number","null"]},"index":{"type":"number"},"mimeType":{"type":["string","null"]},"width":{"type":["number","null"]}},"required":["index","mimeType","width","height","estimatedRgba8Bytes"],"type":"object"},"AssetLegacyBoundsMetadata":{"additionalProperties":false,"deprecated":"Historical records used static to mean default pose, not absence of animation.","properties":{"accuracy":{"enum":["static","approximate"],"type":"string"},"center":{"$ref":"#/components/schemas/AssetVector3"},"dimensions":{"$ref":"#/components/schemas/AssetVector3"},"max":{"$ref":"#/components/schemas/AssetVector3"},"min":{"$ref":"#/components/schemas/AssetVector3"},"originOffset":{"$ref":"#/components/schemas/AssetVector3","description":"Translation needed to put the bounds center at the origin."}},"required":["accuracy","center","dimensions","max","min","originOffset"],"type":"object"},"AssetLoadingMetadata":{"additionalProperties":false,"properties":{"dependencies":{"description":"Declared URIs, never fetched automatically by the collector.","items":{"type":"string"},"type":"array"},"mechanisms":{"items":{"type":"string"},"type":"array"},"meshLodLevels":{"description":"Maximum declared levels per resource, including the embedded base level.","type":"number"},"progressive":{"type":"boolean"},"textureLodLevels":{"type":"number"}},"required":["progressive","mechanisms","meshLodLevels","textureLodLevels","dependencies"],"type":"object"},"AssetMetadataCollectionState":{"enum":["pending","running","complete","partial","failed","unsupported"],"type":"string"},"AssetMetadataDetailResponse":{"additionalProperties":false,"properties":{"collected_at":{"type":["string","null"]},"collector_version":{"type":"number"},"data":{"anyOf":[{"$ref":"#/components/schemas/GltfAssetMetadata"},{"$ref":"#/components/schemas/AssetTechnicalMetadata"},{"type":"null"}]},"status":{"$ref":"#/components/schemas/AssetMetadataCollectionState"},"summary":{"anyOf":[{"$ref":"#/components/schemas/AssetMetadataSummary"},{"type":"null"}]},"verification":{"enum":["provisional","verified"],"type":"string"}},"required":["collected_at","collector_version","data","status","summary","verification"],"type":"object"},"AssetMetadataSummary":{"additionalProperties":false,"properties":{"animationCount":{"type":"number"},"dimensions":{"anyOf":[{"$ref":"#/components/schemas/AssetVector3"},{"type":"null"}],"description":"Only the declared default scene is summarized; never silently select scene zero."},"meshLodLevels":{"type":"number"},"progressive":{"type":"boolean"},"sceneCount":{"type":"number"},"status":{"description":"Partial means some requested measurements could not be established.","enum":["complete","partial"],"type":"string"},"textureLodLevels":{"type":"number"},"triangles":{"type":["number","null"]}},"required":["animationCount","dimensions","meshLodLevels","progressive","sceneCount","status","textureLodLevels","triangles"],"type":"object"},"AssetMetadataSummaryResponse":{"additionalProperties":false,"properties":{"collected_at":{"type":["string","null"]},"collector_version":{"type":"number"},"status":{"$ref":"#/components/schemas/AssetMetadataCollectionState"},"summary":{"anyOf":[{"$ref":"#/components/schemas/AssetMetadataSummary"},{"type":"null"}]},"verification":{"enum":["provisional","verified"],"type":"string"}},"required":["status","verification","collector_version","collected_at","summary"],"type":"object"},"AssetResourceUsage":{"additionalProperties":false,"description":"Facts measurable from glTF JSON. Binary/dependency inspection augments these later.","properties":{"geometryAssumption":{"const":"Unique dense mesh accessors, no renderer overhead","type":"string"},"geometryBytesEstimate":{"type":["number","null"]},"meshCompression":{"items":{"type":"string"},"type":"array"},"nodeCount":{"type":"number"}},"required":["nodeCount","meshCompression","geometryBytesEstimate","geometryAssumption"],"type":"object"},"AssetSceneMetadata":{"additionalProperties":false,"properties":{"bounds":{"anyOf":[{"$ref":"#/components/schemas/AssetBoundsMetadata"},{"$ref":"#/components/schemas/AssetLegacyBoundsMetadata"},{"type":"null"}],"description":"Default pose, node transforms applied. Null if any geometry bounds are unknown."},"geometry":{"$ref":"#/components/schemas/AssetGeometryMetadata"},"index":{"type":"number"},"name":{"type":"string"},"rootCount":{"type":"number"}},"required":["index","rootCount","geometry","bounds"],"type":"object"},"AssetTechnicalMetadata":{"additionalProperties":false,"properties":{"animationCount":{"type":"number"},"animations":{"items":{"$ref":"#/components/schemas/AssetAnimationMetadata"},"type":"array"},"asset":{"$ref":"#/components/schemas/AssetEmbeddedMetadata"},"collectorVersion":{"description":"Revision of the collector that measured these facts.","type":"number"},"companionAttributions":{"description":"Distinct companion attribution grouped by file-manifest indices. Other companion models inherit the entrypoint's asset information.","items":{"additionalProperties":false,"properties":{"asset":{"$ref":"#/components/schemas/AssetEmbeddedMetadata"},"fileIndices":{"items":{"type":"number"},"type":"array"}},"required":["asset","fileIndices"],"type":"object"},"type":"array"},"defaultSceneIndex":{"type":["number","null"]},"entrypoint":{"type":"string"},"extensionsRequired":{"items":{"type":"string"},"type":"array"},"extensionsUsed":{"items":{"type":"string"},"type":"array"},"files":{"items":{"additionalProperties":false,"properties":{"path":{"type":"string"},"sha256":{"type":"string"},"size":{"type":"number"}},"required":["path","size","sha256"],"type":"object"},"type":"array"},"fingerprint":{"description":"SHA-256 of the canonical entrypoint + sorted path/size/SHA-256 manifest.","type":"string"},"fingerprintComplete":{"description":"False if declared dependencies could not all be resolved from supplied files.","type":"boolean"},"geometry":{"$ref":"#/components/schemas/AssetGeometryMetadata"},"gpuMemoryEstimate":{"additionalProperties":false,"properties":{"assumption":{"const":"RGBA8 base level, no mipmaps; actual GPU formats may differ","type":"string"},"bytes":{"type":["number","null"]}},"required":["bytes","assumption"],"type":"object"},"imageCount":{"type":"number"},"images":{"items":{"$ref":"#/components/schemas/AssetImageMetadata"},"type":"array"},"issues":{"items":{"type":"string"},"type":"array"},"jointCount":{"type":"number"},"loading":{"$ref":"#/components/schemas/AssetLoadingMetadata"},"lodSummary":{"description":"Companion model ranges grouped by declared progressive level (1 is the first external level). Null means no declared level could be established. Shared files count once per level; ranges describe individual files, not the complexity of a fully assembled scene. Unknown measurements stay unknown.","items":{"additionalProperties":false,"properties":{"bytes":{"type":"number"},"fileCount":{"type":"number"},"level":{"type":["number","null"]},"triangles":{"additionalProperties":false,"properties":{"max":{"type":["number","null"]},"min":{"type":["number","null"]},"unknownCount":{"type":"number"}},"required":["min","max","unknownCount"],"type":"object"},"vertices":{"additionalProperties":false,"properties":{"max":{"type":["number","null"]},"min":{"type":["number","null"]},"unknownCount":{"type":"number"}},"required":["min","max","unknownCount"],"type":"object"}},"required":["level","fileCount","bytes","vertices","triangles"],"type":"object"},"type":"array"},"materialCount":{"type":"number"},"materialVariantCount":{"type":"number"},"morphTargetCount":{"type":"number"},"relatedModels":{"description":"Companion/LOD complexity, never summed into the entrypoint's geometry. Historical records may contain a full description for each companion.","items":{"additionalProperties":false,"properties":{"metadata":{"anyOf":[{"$ref":"#/components/schemas/AssetCompanionMetadata"},{"$ref":"#/components/schemas/GltfAssetMetadata"}]},"path":{"type":"string"}},"required":["path","metadata"],"type":"object"},"type":"array"},"resourceUsage":{"$ref":"#/components/schemas/AssetResourceUsage","description":"Absent on older collected records."},"sceneCount":{"type":"number"},"scenes":{"items":{"$ref":"#/components/schemas/AssetSceneMetadata"},"type":"array"},"schemaVersion":{"const":1,"description":"Metadata structure version.","type":"number"},"size":{"type":"number"},"skinCount":{"type":"number"},"status":{"description":"Partial means some requested measurements could not be established.","enum":["complete","partial"],"type":"string"},"textureCount":{"type":"number"},"textureEncodedBytes":{"description":"Sum over unique image definitions, excluding companion LOD files.","type":["number","null"]},"unit":{"const":"meter","description":"glTF coordinates use meters; this is a format convention, not a scale verification.","type":"string"}},"required":["animationCount","animations","asset","collectorVersion","defaultSceneIndex","entrypoint","extensionsRequired","extensionsUsed","files","fingerprint","fingerprintComplete","geometry","gpuMemoryEstimate","imageCount","images","issues","jointCount","loading","materialCount","materialVariantCount","morphTargetCount","relatedModels","sceneCount","scenes","schemaVersion","size","skinCount","status","textureCount","unit"],"type":"object"},"AssetVector3":{"items":{"type":"number"},"maxItems":3,"minItems":3,"type":"array"},"ContentFormat":{"description":"File format — e.g. `glb`, `usdz`, `gltf`, `ply`/`splat`/`spz`/`ksplat`/`sog` (Gaussian splats), `exr` (HDRI source), `pmrem` (engine-ready HDRI KTX2).","enum":["glb","gltf","usd","usda","usdz","obj","fbx","vrm","stl","ply","splat","spz","ksplat","sog","sogs","textures","html","exr","hdr","pmrem"],"type":"string"},"ContentLabel":{"additionalProperties":false,"description":"A named pointer label (e.g. \"latest\", \"main\") with a resolved URL.","properties":{"displayName":{"description":"Human-readable display name","type":"string"},"label":{"description":"Version label, for example \"latest\".","type":"string"},"url":{"anyOf":[{"type":"string"},{"enum":[null,"hidden"],"type":["null","string"]}],"description":"Resolved CDN URL. Null if unavailable, \"hidden\" if paywalled."}},"required":["label","displayName","url"],"type":"object"},"ContentListItem":{"additionalProperties":false,"properties":{"availability":{"description":"Collection membership can remain visible to editors when the source is unavailable.","enum":["available","unavailable"],"type":"string"},"content_formats":{"description":"Available content formats for this content item (e.g. [\"glb\", \"textures\"])","items":{"$ref":"#/components/schemas/ContentFormat"},"type":"array"},"content_type":{"anyOf":[{"$ref":"#/components/schemas/ContentType"},{"type":"null"}]},"created_at":{"type":"string"},"deleted_at":{"description":"When the item was moved to the trash (only present when trash=true)","type":["string","null"]},"deleted_by_name":{"description":"Display name of the user who deleted this item (only present when trash=true)","type":["string","null"]},"description":{"type":["string","null"]},"edit_url":{"description":"Page for editing this item in the cloud UI. Present for everything the caller can see through this endpoint, since it is already scoped to their org. Null only when the server has no configured frontend origin.","type":["string","null"]},"identifier":{"type":"string"},"is_public":{"description":"Whether this content is publicly readable via the public discovery API","type":"boolean"},"item_type":{"const":"content","type":"string"},"password_protected":{"description":"Whether the content is password-protected (requires commercial license)","type":"boolean"},"size":{"description":"Bytes in the latest primary artifact, including companion files; projects include their current document and attached files. Null when unavailable.","type":["number","null"]},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}]},"technical_metadata":{"anyOf":[{"$ref":"#/components/schemas/AssetMetadataSummaryResponse"},{"$ref":"#/components/schemas/AssetMetadataDetailResponse"},{"type":"null"}]},"thumbnail_url":{"description":"Resolved CDN URL for the thumbnail image","type":["string","null"]},"title":{"type":["string","null"]},"updated_at":{"type":"string"},"updated_by":{"description":"Identity associated with the latest recorded activity, when known.","type":["string","null"]},"updated_by_name":{"description":"Display name for that identity, when available.","type":["string","null"]},"url":{"description":"Resolved CDN URL for the asset. When `content_format` filter is set, points to the matching artifact's URL (e.g. PMREM `.ktx2` for HDRI); otherwise the latest upload's URL. Null when no completed job/output is available.","type":["string","null"]},"version_count":{"description":"Number of upload versions, or the latest saved project revision number.","type":"number"},"view_url":{"description":"Standalone viewer page. Null for deployments (they ARE a website — use `url`) and for items with no artifact to view yet.","type":["string","null"]}},"required":["content_formats","content_type","created_at","description","identifier","is_public","password_protected","tags","thumbnail_url","title","updated_at","url","version_count"],"type":"object"},"ContentListResponse":{"additionalProperties":false,"properties":{"deleted":{"type":"number"},"has_more":{"type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/ContentListItem"},"type":"array"},"limit":{"type":"number"},"page":{"type":"number"},"pages_count":{"type":"number"},"total":{"type":"number"}},"required":["deleted","has_more","items","limit","page","pages_count","total"],"type":"object"},"ContentType":{"description":"Semantic content type — what kind of asset this is (3D model, material, deployed website, HDRI environment).","enum":["3d-asset","material","deployment","hdri"],"type":"string"},"ContentVariant":{"anyOf":[{"additionalProperties":false,"properties":{"cdn_key":{"anyOf":[{"type":"string"},{"enum":[null,"hidden"],"type":["null","string"]}],"description":"CDN storage key. Null if not yet complete, \"hidden\" if paywalled."},"content_format":{"description":"File format","type":["string","null"]},"content_type":{"description":"Semantic content type","type":["string","null"]},"created_at":{"description":"ISO 8601 timestamp","type":"string"},"error":{"description":"Error message if the job failed","type":["string","null"]},"height":{"description":"User-facing pixel height. See `width`.","type":["number","null"]},"identifier":{"description":"Job identifier","type":"string"},"is_progressive":{"const":true,"description":"This variant supports progressive/streaming loading","type":"boolean"},"labels":{"description":"Named pointer labels with resolved URLs","items":{"$ref":"#/components/schemas/ContentLabel"},"type":"array"},"merge":{"description":"True for the experimental merged-mesh optimization variant.","type":"boolean"},"progress":{"description":"Progress percentage (0-100)","type":"number"},"progressive_size":{"description":"Total size in bytes of all LOD-0 chunks (initial download)","type":"number"},"size":{"description":"Output size in bytes","type":["number","null"]},"status":{"$ref":"#/components/schemas/JobStatus","description":"Current job status"},"status_message":{"description":"Human-readable status message","type":"string"},"technical_metadata":{"anyOf":[{"$ref":"#/components/schemas/AssetMetadataSummaryResponse"},{"$ref":"#/components/schemas/AssetMetadataDetailResponse"},{"type":"null"}]},"type":{"$ref":"#/components/schemas/JobType","description":"Job type: \"optimization\", \"deployment\", \"ai-material\", etc."},"updated_at":{"description":"ISO 8601 timestamp","type":"string"},"url":{"anyOf":[{"type":"string"},{"enum":[null,"hidden"],"type":["null","string"]}],"description":"Resolved CDN URL for the output file. Null if not yet complete. Website URL for deployments."},"usecase":{"description":"Optimization use case. Null for non-optimization variants or the default optimization.","enum":["product","world",null],"type":["string","null"]},"width":{"description":"Image width in pixels. Derived image variants report the source image's logical resolution, which may differ from the dimensions of the downloadable file. Null for non-image variants.","type":["number","null"]}},"required":["cdn_key","content_format","content_type","created_at","height","identifier","is_progressive","labels","progressive_size","size","status","type","updated_at","url","width"],"type":"object"},{"additionalProperties":false,"properties":{"cdn_key":{"anyOf":[{"type":"string"},{"enum":[null,"hidden"],"type":["null","string"]}],"description":"CDN storage key. Null if not yet complete, \"hidden\" if paywalled."},"content_format":{"description":"File format","type":["string","null"]},"content_type":{"description":"Semantic content type","type":["string","null"]},"created_at":{"description":"ISO 8601 timestamp","type":"string"},"error":{"description":"Error message if the job failed","type":["string","null"]},"height":{"description":"User-facing pixel height. See `width`.","type":["number","null"]},"identifier":{"description":"Job identifier","type":"string"},"is_progressive":{"const":false,"description":"This variant does not support progressive loading","type":"boolean"},"labels":{"description":"Named pointer labels with resolved URLs","items":{"$ref":"#/components/schemas/ContentLabel"},"type":"array"},"merge":{"description":"True for the experimental merged-mesh optimization variant.","type":"boolean"},"progress":{"description":"Progress percentage (0-100)","type":"number"},"size":{"description":"Output size in bytes","type":["number","null"]},"status":{"$ref":"#/components/schemas/JobStatus","description":"Current job status"},"status_message":{"description":"Human-readable status message","type":"string"},"technical_metadata":{"anyOf":[{"$ref":"#/components/schemas/AssetMetadataSummaryResponse"},{"$ref":"#/components/schemas/AssetMetadataDetailResponse"},{"type":"null"}]},"type":{"$ref":"#/components/schemas/JobType","description":"Job type: \"optimization\", \"deployment\", \"ai-material\", etc."},"updated_at":{"description":"ISO 8601 timestamp","type":"string"},"url":{"anyOf":[{"type":"string"},{"enum":[null,"hidden"],"type":["null","string"]}],"description":"Resolved CDN URL for the output file. Null if not yet complete. Website URL for deployments."},"usecase":{"description":"Optimization use case. Null for non-optimization variants or the default optimization.","enum":["product","world",null],"type":["string","null"]},"width":{"description":"Image width in pixels. Derived image variants report the source image's logical resolution, which may differ from the dimensions of the downloadable file. Null for non-image variants.","type":["number","null"]}},"required":["cdn_key","content_format","content_type","created_at","height","identifier","is_progressive","labels","size","status","type","updated_at","url","width"],"type":"object"}],"description":"A derived variant produced from an upload (optimization, deployment, etc)."},"ContentVersion":{"additionalProperties":false,"description":"A single version of the content, created by an upload or processing job.","properties":{"cdn_key":{"anyOf":[{"type":"string"},{"enum":[null,"hidden"],"type":["null","string"]}],"description":"CDN storage key. Null if upload not yet complete, \"hidden\" if paywalled."},"content_format":{"description":"File format (e.g. \"glb\", \"gltf\", \"fbx\")","type":["string","null"]},"content_type":{"description":"Semantic content type (e.g. \"3d-asset\", \"material\", \"deployment\")","type":["string","null"]},"created_at":{"description":"ISO 8601 timestamp","type":"string"},"error":{"description":"Error message if the job failed","type":["string","null"]},"height":{"description":"User-facing pixel height. See `width`.","type":["number","null"]},"identifier":{"description":"Job identifier of the upload","type":"string"},"labels":{"description":"Named pointer labels (e.g. \"latest\") with resolved URLs","items":{"$ref":"#/components/schemas/ContentLabel"},"type":"array"},"metadata":{"$ref":"#/components/schemas/JobMetadata","description":"Where this version came from — the change that produced it, and what ran it.\n\nOnly present when whoever created it supplied provenance, so treat it as optional everywhere. Visible to your team only; it is never part of a public listing."},"name":{"description":"Original filename","type":"string"},"preparing_optimizations":{"description":"Optimization jobs are being prepared for this version.","type":"boolean"},"progress":{"description":"Progress percentage (0-100)","type":"number"},"size":{"description":"File size in bytes","type":["number","null"]},"status":{"$ref":"#/components/schemas/JobStatus","description":"Current job status"},"status_message":{"description":"Human-readable status message","type":"string"},"technical_metadata":{"anyOf":[{"$ref":"#/components/schemas/AssetMetadataSummaryResponse"},{"$ref":"#/components/schemas/AssetMetadataDetailResponse"},{"type":"null"}]},"type":{"$ref":"#/components/schemas/JobType","description":"Job that produced this version. Older servers may omit this field."},"updated_at":{"description":"ISO 8601 timestamp","type":"string"},"url":{"anyOf":[{"type":"string"},{"enum":[null,"hidden"],"type":["null","string"]}],"description":"Resolved CDN URL for the uploaded file. Null if upload not yet complete."},"user":{"description":"Username of the uploader","type":"string"},"variants":{"description":"Derived variants (optimizations, deployments, AI generations)","items":{"$ref":"#/components/schemas/ContentVariant"},"type":"array"},"width":{"description":"Image width in pixels. Null for non-image content. Derived image variants report the source image's logical resolution, which may differ from the dimensions of the downloadable file.","type":["number","null"]}},"required":["cdn_key","content_format","content_type","created_at","height","identifier","labels","name","size","status","updated_at","url","user","variants","width"],"type":"object"},"DeleteContentResponse":{"additionalProperties":false,"description":"Response from moving a content item to Trash. Deletion immediately frees total storage capacity but does not refund monthly usage.","properties":{"identifier":{"type":"string"},"message":{"type":"string"}},"required":["identifier","message"],"type":"object"},"EnvironmentImageRef":{"anyOf":[{"type":"null"},{"const":"studio","type":"string"},{"additionalProperties":false,"properties":{"content_id":{"type":"string"},"url":{"type":"string"}},"required":["content_id"],"type":"object"}],"description":"Reference to an environment image used for scene lighting.\n\n- `null` — use the viewer's built-in environment.\n- `\"studio\"` — use the viewer's studio lighting preset.\n- `{ content_id, url? }` — use a specific HDRI content item. The server resolves this to the latest PMREM artifact URL at read time. On write, only `content_id` is required."},"GetContentDetailResponse":{"additionalProperties":false,"description":"Response for an uploaded item from GET /v1/content/:identifier","properties":{"colors_hex":{"description":"Dominant colors from AI analysis, hex format (e.g. `[\"#a83232\", \"#2e2e2e\"]`).","items":{"type":"string"},"type":"array"},"content_type":{"anyOf":[{"$ref":"#/components/schemas/ContentType"},{"type":"null"}],"description":"Semantic content type derived from the first version (e.g. \"3d-asset\", \"material\", \"deployment\")"},"copyrights":{"description":"Copyright strings collected from all job outputs","items":{"type":"string"},"type":"array"},"created_at":{"description":"ISO 8601 timestamp","type":"string"},"created_by":{"description":"Username of the content creator","type":["string","null"]},"description":{"description":"User-editable description","type":["string","null"]},"identifier":{"description":"Unique content identifier","type":"string"},"is_public":{"description":"Whether this content is publicly readable via the public discovery API. When true, anyone (authenticated or not) can fetch it.","type":"boolean"},"item_type":{"const":"content","description":"Uploaded content; omitted by older servers.","type":"string"},"moderation_status":{"description":"Content moderation status","enum":["ok","blocked"],"type":"string"},"name":{"description":"Original filename at first upload","type":"string"},"org":{"description":"Organization identifier","type":"string"},"password_protected":{"description":"Whether a password is required to view this content","type":"boolean"},"presentation":{"anyOf":[{"$ref":"#/components/schemas/PresentationV1"},{"type":"null"}],"description":"Viewer presentation settings (lighting, tone mapping, background). `null` when no custom presentation is configured."},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"User-assigned tags"},"thumbnail_url":{"description":"Resolved CDN URL for the thumbnail image","type":["string","null"]},"title":{"description":"User-editable title","type":["string","null"]},"updated_at":{"description":"ISO 8601 timestamp — latest across content and all jobs","type":"string"},"versions":{"description":"Upload versions, newest first","items":{"$ref":"#/components/schemas/ContentVersion"},"type":"array"}},"required":["identifier","created_at","updated_at","created_by","org","name","title","description","thumbnail_url","content_type","copyrights","colors_hex","tags","password_protected","is_public","moderation_status","presentation","versions"],"type":"object"},"GetContentRequestQuery":{"additionalProperties":false,"properties":{"include_metadata":{"enum":["none","summary","full"],"type":"string"}},"type":"object"},"GetContentResponse":{"$ref":"#/components/schemas/GetContentDetailResponse"},"GltfAssetMetadata":{"additionalProperties":false,"properties":{"animationCount":{"type":"number"},"animations":{"items":{"$ref":"#/components/schemas/AssetAnimationMetadata"},"type":"array"},"asset":{"$ref":"#/components/schemas/AssetEmbeddedMetadata"},"collectorVersion":{"description":"Revision of the collector that measured these facts.","type":"number"},"defaultSceneIndex":{"type":["number","null"]},"extensionsRequired":{"items":{"type":"string"},"type":"array"},"extensionsUsed":{"items":{"type":"string"},"type":"array"},"geometry":{"$ref":"#/components/schemas/AssetGeometryMetadata"},"imageCount":{"type":"number"},"issues":{"items":{"type":"string"},"type":"array"},"jointCount":{"type":"number"},"loading":{"$ref":"#/components/schemas/AssetLoadingMetadata"},"materialCount":{"type":"number"},"materialVariantCount":{"type":"number"},"morphTargetCount":{"type":"number"},"resourceUsage":{"$ref":"#/components/schemas/AssetResourceUsage","description":"Absent on older collected records."},"sceneCount":{"type":"number"},"scenes":{"items":{"$ref":"#/components/schemas/AssetSceneMetadata"},"type":"array"},"schemaVersion":{"const":1,"description":"Metadata structure version.","type":"number"},"skinCount":{"type":"number"},"status":{"description":"Partial means some requested measurements could not be established.","enum":["complete","partial"],"type":"string"},"textureCount":{"type":"number"},"unit":{"const":"meter","description":"glTF coordinates use meters; this is a format convention, not a scale verification.","type":"string"}},"required":["schemaVersion","collectorVersion","status","issues","asset","sceneCount","defaultSceneIndex","scenes","geometry","materialCount","animationCount","animations","skinCount","jointCount","morphTargetCount","textureCount","imageCount","materialVariantCount","extensionsUsed","extensionsRequired","loading","unit"],"type":"object"},"JobMetadata":{"additionalProperties":{"description":"Your own keys."},"description":"Provenance for a job — what produced it. Optional on job creation; shown on the version row in the Cloud UI so an asset answers \"where did this come from?\".\n\nDeliberately NOT git-shaped. `source` names whatever system the input came from and `runner` whatever executed it; git is one `source.type` among many, and a DCC export or a hosted runner fits the same slots. The generic fields (`label`, `author`, `message`, `url`) are what the UI renders, so a producer nobody has written yet still displays something useful.","properties":{"client":{"additionalProperties":false,"description":"What talked to the API.","properties":{"name":{"type":"string"},"version":{"type":"string"}},"type":"object"},"runner":{"additionalProperties":false,"description":"What EXECUTED the job — a CI runner, a workstation, a service.","properties":{"actor":{"description":"Who or what set it off.","type":"string"},"event":{"description":"`\"push\"`, `\"pull_request\"`, `\"manual\"`, `\"schedule\"`, …","type":"string"},"id":{"description":"Run id within that system.","type":"string"},"type":{"description":"`\"github-actions\"`, `\"gitlab-ci\"`, `\"local\"`, … — open on purpose.","type":"string"},"url":{"description":"Link to the run.","type":"string"}},"type":"object"},"source":{"additionalProperties":{"description":"System-specific extras (branch, tag, repository, project, scene, …)."},"description":"Where the INPUT came from.","properties":{"author":{"description":"Display name of whoever authored the change. Email addresses are rejected.","type":"string"},"id":{"description":"Stable id within that system: a commit sha, an asset guid, a document id.","type":"string"},"label":{"description":"Short label for display when the specific fields don't tell the story.","type":"string"},"message":{"description":"One short line: a commit subject, an export note. Max 200 characters.","type":"string"},"type":{"description":"`\"git\"`, `\"unity\"`, `\"blender\"`, … — open on purpose.","type":"string"},"url":{"description":"Link back to it — the commit, the asset page, the document.","type":"string"}},"type":"object"}},"type":"object"},"JobStatus":{"enum":["new","pending","running","completed","failed","canceled","stalled"],"type":"string"},"JobType":{"anyOf":[{"type":"string"},{"enum":["upload","conversion","optimization","deployment","ai-material","ai-3d-asset","hdri-compress","splat-compress"],"type":"string"}]},"ListContentRequestQuery":{"additionalProperties":false,"properties":{"collection_id":{"description":"Filter by collection — returns only items belonging to the specified collection, ordered by sort_order","type":"string"},"content_format":{"$ref":"#/components/schemas/ContentFormat","description":"Filter by output content format (e.g. \"glb\", \"textures\"). When set, only items with a matching output are returned, and artifact data comes from that output."},"content_type":{"$ref":"#/components/schemas/ContentType"},"include_metadata":{"enum":["none","summary","full"],"type":"string"},"is_public":{"description":"When true, returns only publicly discoverable items","type":"boolean"},"limit":{"description":"Maximum items per page (default 20, max 100)","type":"number"},"offset":{"description":"Number of items to skip (alternative to page-based pagination)","type":"number"},"page":{"description":"1-based page number (default 1)","type":"number"},"search":{"description":"Full-text search across name, title, description, tags, and identifier","type":"string"},"sort_by":{"description":"Sort the full matching library before pagination (default updated_at).","enum":["name","size","updated_at","created_at"],"type":"string"},"sort_direction":{"description":"Sort direction; defaults to asc for name, desc otherwise. Unknown sizes sort last.","enum":["asc","desc"],"type":"string"},"tags":{"description":"Filter by tags (comma-separated)","type":"string"},"trash":{"description":"When true, returns items in the trash instead of active items","type":"boolean"},"types":{"description":"Filter by job types (comma-separated, e.g. \"upload,optimization,deployment\")","type":"string"}},"type":"object"},"ListPublicContentQuery":{"additionalProperties":false,"description":"Query parameters for GET /v1/public/content","properties":{"content_format":{"$ref":"#/components/schemas/ContentFormat","description":"Filter by content format"},"content_type":{"$ref":"#/components/schemas/ContentType","description":"Filter by content type"},"cursor":{"description":"Opaque cursor from a previous response. When omitted, returns the first page.","type":"string"},"include_metadata":{"enum":["none","summary","full"],"type":"string"},"include_protected":{"description":"Include password-protected items in the listing. Default: false (excluded). Opt-in for the niche \"teaser\" pattern where the owner wants the metadata publicly discoverable but viewing requires a password.","type":"boolean"},"limit":{"description":"Page size (default 20, max 100)","type":"number"},"org_id":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"description":"Filter to content owned by one or more Needle Cloud teams. Pass a single team id, or an array of ids to include items from any of the listed teams. Team ids are shown on the team's details page at `https://cloud.needle.tools/team/`."},"search":{"description":"Substring match against identifier, title, description, and tags.","type":"string"}},"type":"object"},"ListPublicContentResponse":{"additionalProperties":false,"description":"Response from GET /v1/public/content","properties":{"items":{"items":{"$ref":"#/components/schemas/PublicContentItem"},"type":"array"},"next_cursor":{"description":"Cursor to fetch the next page; omitted when there are no more items.","type":"string"}},"required":["items"],"type":"object"},"ModelUnit":{"description":"Source-unit choice for a model. Defaults to `\"auto\"`.","enum":["auto","mm","cm","m","km"],"type":"string"},"MultipartAbortRequestBody":{"$ref":"#/components/schemas/MultipartUploadReference","description":"Abort a multipart upload and release its incomplete parts."},"MultipartAbortResponse":{"additionalProperties":false,"description":"Successful multipart abort.","properties":{"ok":{"const":true,"type":"boolean"}},"required":["ok"],"type":"object"},"MultipartCompleteRequestBody":{"additionalProperties":false,"description":"Complete a multipart upload using the ETag returned by each successful part PUT.","properties":{"key":{"type":"string"},"parts":{"items":{"additionalProperties":false,"properties":{"etag":{"type":"string"},"part_number":{"type":"number"}},"required":["part_number","etag"],"type":"object"},"type":"array"},"upload_id":{"type":"string"}},"required":["key","parts","upload_id"],"type":"object"},"MultipartCompleteResponse":{"additionalProperties":false,"description":"Response of `multipart/complete`.","properties":{"key":{"type":"string"},"ok":{"const":true,"type":"boolean"}},"required":["ok","key"],"type":"object"},"MultipartCreateResponse":{"additionalProperties":false,"description":"Response of multipart/create: retain both values for subsequent multipart operations.","properties":{"key":{"type":"string"},"upload_id":{"type":"string"}},"required":["upload_id","key"],"type":"object"},"MultipartPartUrlsRequestBody":{"additionalProperties":false,"description":"Request URLs for one-based part numbers in a previously created multipart upload.","properties":{"key":{"type":"string"},"part_numbers":{"items":{"type":"number"},"type":"array"},"upload_id":{"type":"string"}},"required":["key","part_numbers","upload_id"],"type":"object"},"MultipartPartUrlsResponse":{"additionalProperties":false,"description":"Response of `multipart/part-urls`: a presigned UploadPart url per requested part.","properties":{"urls":{"items":{"additionalProperties":false,"properties":{"part_number":{"type":"number"},"url":{"type":"string"}},"required":["part_number","url"],"type":"object"},"type":"array"}},"required":["urls"],"type":"object"},"MultipartUploadReference":{"additionalProperties":false,"description":"Identifiers returned by multipart/create. Pass both unchanged to later multipart calls.","properties":{"key":{"type":"string"},"upload_id":{"type":"string"}},"required":["upload_id","key"],"type":"object"},"PresentationHdriV1":{"additionalProperties":false,"description":"Presentation for HDRI content items. Carries metadata about how the HDRI should be used when consumed as the `skybox_image` of another content item's presentation — the backend resolver pulls these values and attaches them onto the consumer's resolved `skybox_image` ref, so a 3D-asset doesn't need to know or repeat them.\n\nDeliberately small for now (scene-geometry fields only). Tone mapping etc. stay off this type — HDRIs viewed standalone use the viewer's defaults.","properties":{"environment_height":{"description":"Height parameter for the engine's `GroundProjectedEnv` — the elevation the HDRI's source camera was at when the photo was taken. A larger value magnifies the downward part of the image (closer perspective); smaller flattens it. NOT a vertical ceiling for models. Default `5`. Range 0.1..50.","type":"number"},"environment_radius":{"description":"Radius of the visible HDRI projection dome (the sphere the HDRI is projected onto) in scene units (metres). Used by the engine's `GroundProjectedEnv` component. Default `30`. Range 0.5..1000.","type":"number"},"placement_radius":{"description":"Radius of the usable placement space around the origin where consumer models sit comfortably (the viewer's auto-fit clamp). Must be ≤ `environment_radius`. Default `15`. Range 0.5..1000.","type":"number"},"type":{"const":"hdri","type":"string"},"v":{"const":1,"type":"number"}},"required":["v","type"],"type":"object"},"PresentationV1":{"anyOf":[{"$ref":"#/components/schemas/PresentationViewerV1"},{"$ref":"#/components/schemas/PresentationHdriV1"}],"description":"Presentation settings — discriminated union on `type`.\n\n- `\"default\"` — for 3D-asset content items that USE environments.\n- `\"hdri\"` — for HDRI content items, carrying metadata about how the HDRI should be used by consumer presentations.\n\nThe discriminator lets each variant carry only the fields that make sense for its content type, so a 3D asset's presentation doesn't have unused HDRI-only knobs and vice-versa."},"PresentationViewerV1":{"additionalProperties":false,"description":"Viewer presentation settings for a content item.\n\nControls how the asset appears when opened in the viewer — lighting, background, and tone mapping. All fields are optional; omitted fields fall back to the viewer's defaults.\n\n`v` is the schema version (always `1` for now). `type` is `\"default\"` — the content item's default presentation.","properties":{"background_blurriness":{"description":"Blurriness of the background image (0 = sharp, 1 = fully blurred).","type":"number"},"background_color":{"description":"Background color (`#RRGGBB`) when skybox is hidden.","type":["string","null"]},"background_intensity":{"description":"Intensity multiplier for the background image (0–1).","type":"number"},"background_rotation_y":{"description":"Y-axis rotation of the background image in degrees (0–360).","type":"number"},"environment_image":{"$ref":"#/components/schemas/EnvironmentImageRef","description":"Scene lighting environment."},"environment_intensity":{"description":"Intensity multiplier for the environment lighting (0.01–2).","type":"number"},"environment_rotation_y":{"description":"Y-axis rotation of the environment lighting in degrees (0–360).","type":"number"},"ground_distance":{"description":"Vertical offset (in scaled-world metres) applied AFTER the auto-fit + `model_scale` composition. Positive lifts the model off the ground; negative sinks it into the ground. Range -50..50, default 0. Only meaningful when `ground_projection` is true.","type":"number"},"ground_projection":{"description":"When `true`, project the background image as a ground plane under the model so it sits on the environment instead of floating against the skybox. Only meaningful when a background image is set.","type":"boolean"},"model_scale":{"description":"Uniform scale multiplier applied on top of the viewer's auto-fit when ground projection is on. 1 = auto-fit only (model fits the envelope as computed by the viewer); <1 shrinks the model further; >1 grows it beyond the envelope. Clamped to 0.01..100. Only meaningful when `ground_projection` is true.","type":"number"},"model_unit":{"$ref":"#/components/schemas/ModelUnit","description":"Source-unit choice for the model:\n- `\"auto\"` (default) — viewer auto-fits to the placement space.\n- `\"mm\" | \"cm\" | \"m\" | \"km\"` — declares the literal source unit; the viewer applies the factor and renders the model at its TRUE real-world size relative to the placement space (no auto-fit clamp). `model_scale` is still applied on top for fine-tuning."},"skybox_image":{"$ref":"#/components/schemas/SkyboxImageRef","description":"Visible background / skybox. Use `\"\"` to hide."},"tone_mapping":{"$ref":"#/components/schemas/ToneMapping","description":"Tone-mapping algorithm. `\"default\"` keeps the viewer's built-in setting."},"tone_mapping_exposure":{"description":"Tone-mapping exposure multiplier (clamped to 0.1–4.0).","type":"number"},"type":{"const":"default","type":"string"},"v":{"const":1,"type":"number"}},"required":["v","type"],"type":"object"},"PublicContentDetail":{"additionalProperties":false,"description":"Full detail for a public content item — adds version information to the list shape.","properties":{"content_formats":{"description":"All formats available across versions (e.g. `[\"glb\"]` or `[\"glb\", \"textures\"]`).","items":{"$ref":"#/components/schemas/ContentFormat"},"type":"array"},"content_type":{"anyOf":[{"$ref":"#/components/schemas/ContentType"},{"type":"null"}],"description":"Semantic content type (e.g. `material`, `3d-asset`, `deployment`)."},"created_at":{"description":"ISO 8601 timestamp.","type":"string"},"description":{"type":["string","null"]},"embed_url":{"description":"Iframe-friendly embed URL. Drop into an `