UploadCreateΒΆ

Generated from the central API contract. Availability and permissions are checked by the connected service.

Field

Type / accepted values

Required

Default

Constraints / meaning

coordinate_units

"auto" / "mm" / "cm" / "m" / "in"

No

"auto"

Normally auto. STEP/STP/3MF use embedded units normalized to mm. STL units are resolved from measured bounds and supplied engineering context; ambiguous scale requires one clarification.

engineering_context

string or null

No

Omitted

maxLength: 1000; Brief supplied engineering context, e.g. a full-size passenger car or a GPU cold plate. Do not infer context from a filename alone.

expected_length_mm

number or null

No

Omitted

maximum: 1000000000.0; exclusiveMinimum: 0.0; Optional known approximate longest overall dimension in millimetres. Supply only when known from the user or source evidence, not an invented guess.

project_id

string (uuid) or null

No

Omitted

request_id

string (uuid) or null

No

Omitted

filename

string

Yes

Omitted

minLength: 1; maxLength: 180

kind

"surface"

No

"surface"

media_type

"model/stl" / "application/sla" / "application/octet-stream"

No

"model/stl"

size_bytes

integer

Yes

Omitted

maximum: 5000000000.0; exclusiveMinimum: 0.0

sha256

string

Yes

Omitted

pattern: "^[a-f0-9]{64}$"

Omission and explicit null are different. Defaults shown are schema defaults; validators may resolve conditional defaults or reject incompatible combinations. See the workflow guide and validate the complete request before submission.