Files
Request pre-signed upload URLs for model imports and other files. Obtain an upload slot, PUT your file to the returned URL, then pass the returned key to the consuming endpoint.
GET https://api.qonic.com/v1/files/upload-url
Get file upload URLs
Generates one or more pre-signed URLs for uploading files directly to storage. Use the returned Key in a follow-up operation that accepts uploaded-file keys — for example, creating a model (POST /v1/projects/{projectId}/models). The URLs are temporary and should be used shortly after they are issued.
Query parameters
-
- Name
-
count - Type
- integer
- Required
- Optional
- Description
- Number of upload slots to generate (1–100, default 1).
-
- Name
-
fileName - Type
- string
- Required
- Optional
- Description
- Optional file name; its extension is preserved in the storage key.
Response fields
-
- Name
-
items - Type
- array<object>
- Required
- Optional
- Description
- One pre-signed upload slot per requested item. Length matches the count query parameter (1–100, default 1).
-
-
- Name
-
uploadUrl - Type
- string
- Required
- Optional
- Description
- The pre-signed URL to which the file should be uploaded.
-
- Name
-
key - Type
- string
- Required
- Optional
- Description
- The storage key that identifies this upload, passed back to the endpoint that consumes the file (e.g. model creation or mesh streaming).
-
Error responses
-
- Name
-
401 - Type
- application/problem+json
- Description
- Authentication required. Provide a valid Bearer token in the Authorization header.
Body:
ProblemDetails
-
- Name
-
403 - Type
- application/problem+json
- Description
- Insufficient permissions for this operation
Body:
ProblemDetails