Sign in
assembly-files

Get Assembly File

Return the project's current assembly file (or null if none).

Includes a presigned GET URL (download_url) when the file is in validated status. Allowed regardless of project status — only mutations are gated.

get/api/v1/projects/{project_id}/assembly-file

Path parameters

project_idstring uuid required

Response

Successful Response

idstring uuid required
project_idstring uuid required
file_namestring required
file_sizeinteger required
file_format'step' | 'stp' required

Allowed formats for project-level assembly reference files.

Intentionally a narrow subset — assembly files are reference docs only, not processed through the geometry pipeline.

status'uploading' | 'uploaded' | 'validated' | 'failed' required

Lifecycle for ProjectAssemblyFile.

UPLOADING: presigned URL issued, waiting on browser PUT UPLOADED: confirm received; magic-bytes validation queued VALIDATED: passed magic-bytes check; downloadable FAILED: validation rejected (failure_reason populated)

failure_reasonstring nullable
uploaded_by_user_idstring uuid nullable
created_atstring date-time required
updated_atstring date-time required
download_urlstring nullable

Presigned GET URL for downloading the assembly file. None when status is not 'validated' (file isn't ready or has failed).

Changes

No recorded changes to this endpoint across all 1 revision of this API.