Files
Request pre-signed upload URLs — the single canonical upload endpoint for the API. Obtain an upload slot, PUT your file (e.g. a model import or mesh-stream data) 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 to reference the uploaded file in a follow-up call — e.g. creating a model (POST /v1/projects/{projectId}/models) or streaming a mesh (POST /v1/sessions/stream-meshes). 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