uploads
Returns a paginated list of Upload Requests based on the limit
, offset
and filter
query string parameters specified in the request. If no limit
and offset
query string parameters are specified, it will return the first 50 Upload Requests. A user should specify the accessType as USER and accessId as userid (parsed from the auth token).
Resource Information
Method and URI | GET https://developer.api.autodesk.com/industrialized-construction/informed-design/v1/uploads |
Authentication Context | user context required |
Required OAuth Scopes | data:read data:write data:create account:read |
Data Format | JSON |
Request
Headers
Authorization* string | Must be Bearer <token> , where <token> is obtained via a three-legged OAuth flow. |
Request
Query String Parameters
accessType* enum:string | Will always be: USER |
accessId* string | |
limit int | The number of items per page. |
offset int | The number of items to skip before starting to collect the result set. |
filter[project] string | |
filter[folder] string | |
filter[outputTypes] string | |
filter[createdAt] string | |
filter[updatedAt] string |
Response
HTTP Status Code Summary
200 OK | A page of Upload Requests was retrieved successfully. |
400 Bad Request | The server could not process your request. It is likely due to incorrect formatting or missing information. The response body may indicate what is wrong. Please review and resubmit your request. |
401 Unauthorized | The supplied authorization header was invalid or the token scope was not acceptable. Verify your authentication credentials and try again. |
403 Forbidden | The request was valid but lacked the necessary permissions. Verify your credentials and permissions before sending the request again. |
429 Too Many Requests | The server has received too many requests within the allowed time window. Please wait before retrying. |
500 Internal Server Error | An unexpected error occurred on the server. Please try again later. |
Response
Body Structure (200)
pagination object | The pagination information for the result set. |
limit number | The maximum number of items per page. |
offset number | The page number. |
totalResults number | The total matching results regardless of the limit. |
nextUrl string | The URL for the next page if the current page is not the last page. |
previousUrl string | The URL for the previous page if the current page is not the first page. |
filters object | |
project string | The project Id. |
folder string | The folder URN. |
outputTypes array: string | The list of output types to filter by. |
createdAt object | The datetime range filter for creation timestamp. |
start datetime: ISO 8601 | The start datetime of the filter range. |
end datetime: ISO 8601 | The end datetime of the filter range. |
updatedAt object | The datetime range filter for last update timestamp. |
start datetime: ISO 8601 | The start datetime of the filter range. |
end datetime: ISO 8601 | The end datetime of the filter range. |
results array: object | The array of upload requests matching the filters. |
accessType enum:string | The type of integration or service used to determine access context.
Possible values: ACC , BIM360 , FUSION , CONTENTCATALOG , BRIDGE , PUBLIC |
accessId string | A composite string of identifiers that define the access scope for the given access type. |
id string: UUID | The unique identifier of UploadRequest. |
outputs | |
anyOf | |
0 array | |
oneOf array:oneOf | |
Inventor RFA Output object | |
type enum:string | Defines this Output definition to be of RFA type. Will always be: RFA |
settings object | |
representation string | The representation for this Output. |
version enum:string | The application version for this Output.
Possible values: 2024 , 2025 , 2026 |
category string | The category to be set on generated Revit family. |
family string | The name for the generated Revit family. |
id string: UUID | The unique identifier of Output. |
status enum:string | Possible values: PENDING , SUCCESS , FAILED |
createdAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was created. |
updatedAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was last updated. |
variantSnapshot object | |
projectId string: UUID | The Project Id. |
accountId string: UUID | The Account Id. |
productId string: UUID | The unique identifier of Product. |
productName string | The name of the Product |
releaseId string: UUID | The unique identifier of Release. |
releaseNumber int | The Release number. |
id string: UUID | The unique identifier of Variant. |
name string | The name of the Variant.
Max length: 255 |
Inventor BCD Output object | |
type enum:string | Defines this Output definition to be of BCD type. Will always be: BCD |
settings object | |
representation string | The representation for this Output. |
category string | The category to be set on generated Revit family. |
family string | The name for the generated Revit family. |
id string: UUID | The unique identifier of Output. |
status enum:string | Possible values: PENDING , SUCCESS , FAILED |
createdAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was created. |
updatedAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was last updated. |
variantSnapshot object | |
projectId string: UUID | The Project Id. |
accountId string: UUID | The Account Id. |
productId string: UUID | The unique identifier of Product. |
productName string | The name of the Product |
releaseId string: UUID | The unique identifier of Release. |
releaseNumber int | The Release number. |
id string: UUID | The unique identifier of Variant. |
name string | The name of the Variant.
Max length: 255 |
Inventor BOM Output object | |
type enum:string | Defines this Output definition to be of BOM type. Will always be: BOM |
settings object | |
representation string | The representation for this Output. |
id string: UUID | The unique identifier of Output. |
status enum:string | Possible values: PENDING , SUCCESS , FAILED |
createdAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was created. |
updatedAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was last updated. |
variantSnapshot object | |
projectId string: UUID | The Project Id. |
accountId string: UUID | The Account Id. |
productId string: UUID | The unique identifier of Product. |
productName string | The name of the Product |
releaseId string: UUID | The unique identifier of Release. |
releaseNumber int | The Release number. |
id string: UUID | The unique identifier of Variant. |
name string | The name of the Variant.
Max length: 255 |
Inventor INV Output object | |
type enum:string | Defines this Output definition to be of INV type. Will always be: INV |
settings object | |
id string: UUID | The unique identifier of Output. |
status enum:string | Possible values: PENDING , SUCCESS , FAILED |
createdAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was created. |
updatedAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was last updated. |
variantSnapshot object | |
projectId string: UUID | The Project Id. |
accountId string: UUID | The Account Id. |
productId string: UUID | The unique identifier of Product. |
productName string | The name of the Product |
releaseId string: UUID | The unique identifier of Release. |
releaseNumber int | The Release number. |
id string: UUID | The unique identifier of Variant. |
name string | The name of the Variant.
Max length: 255 |
Inventor DWG Output object | |
type enum:string | Defines this Output definition to be of DWG type. Will always be: DWG |
settings object | |
templatePath string | The relative path to Drawing Template File. |
id string: UUID | The unique identifier of Output. |
status enum:string | Possible values: PENDING , SUCCESS , FAILED |
createdAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was created. |
updatedAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was last updated. |
variantSnapshot object | |
projectId string: UUID | The Project Id. |
accountId string: UUID | The Account Id. |
productId string: UUID | The unique identifier of Product. |
productName string | The name of the Product |
releaseId string: UUID | The unique identifier of Release. |
releaseNumber int | The Release number. |
id string: UUID | The unique identifier of Variant. |
name string | The name of the Variant.
Max length: 255 |
Inventor Thumbnail Output object | |
type enum:string | Defines this Output definition to be of THUMBNAIL type. Will always be: THUMBNAIL |
settings object | |
representation string | The representation for this Output. |
id string: UUID | The unique identifier of Output. |
status enum:string | Possible values: PENDING , SUCCESS , FAILED |
createdAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was created. |
updatedAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was last updated. |
variantSnapshot object | |
projectId string: UUID | The Project Id. |
accountId string: UUID | The Account Id. |
productId string: UUID | The unique identifier of Product. |
productName string | The name of the Product |
releaseId string: UUID | The unique identifier of Release. |
releaseNumber int | The Release number. |
id string: UUID | The unique identifier of Variant. |
name string | The name of the Variant.
Max length: 255 |
Inventor GLB Output object | |
type enum:string | Defines this Output definition to be of GLB type. Will always be: GLB |
settings object | |
representation string | The representation for this Output. |
id string: UUID | The unique identifier of Output. |
status enum:string | Possible values: PENDING , SUCCESS , FAILED |
createdAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was created. |
updatedAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was last updated. |
variantSnapshot object | |
projectId string: UUID | The Project Id. |
accountId string: UUID | The Account Id. |
productId string: UUID | The unique identifier of Product. |
productName string | The name of the Product |
releaseId string: UUID | The unique identifier of Release. |
releaseNumber int | The Release number. |
id string: UUID | The unique identifier of Variant. |
name string | The name of the Variant.
Max length: 255 |
Inventor STL Output object | |
type enum:string | Defines this Output definition to be of STL type. Will always be: STL |
settings object | |
representation string | The representation for this Output. |
id string: UUID | The unique identifier of Output. |
status enum:string | Possible values: PENDING , SUCCESS , FAILED |
createdAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was created. |
updatedAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was last updated. |
variantSnapshot object | |
projectId string: UUID | The Project Id. |
accountId string: UUID | The Account Id. |
productId string: UUID | The unique identifier of Product. |
productName string | The name of the Product |
releaseId string: UUID | The unique identifier of Release. |
releaseNumber int | The Release number. |
id string: UUID | The unique identifier of Variant. |
name string | The name of the Variant.
Max length: 255 |
Inventor STEP Output object | |
type enum:string | Defines this Output definition to be of STEP type. Will always be: STEP |
settings object | |
representation string | The representation for this Output. |
id string: UUID | The unique identifier of Output. |
status enum:string | Possible values: PENDING , SUCCESS , FAILED |
createdAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was created. |
updatedAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was last updated. |
variantSnapshot object | |
projectId string: UUID | The Project Id. |
accountId string: UUID | The Account Id. |
productId string: UUID | The unique identifier of Product. |
productName string | The name of the Product |
releaseId string: UUID | The unique identifier of Release. |
releaseNumber int | The Release number. |
id string: UUID | The unique identifier of Variant. |
name string | The name of the Variant.
Max length: 255 |
Inventor PDF Output object | |
type enum:string | Defines this Output definition to be of PDF type. Will always be: PDF |
settings object | |
templatePath string | The relative path to Drawing Template File. |
id string: UUID | The unique identifier of Output. |
status enum:string | Possible values: PENDING , SUCCESS , FAILED |
createdAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was created. |
updatedAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was last updated. |
variantSnapshot object | |
projectId string: UUID | The Project Id. |
accountId string: UUID | The Account Id. |
productId string: UUID | The unique identifier of Product. |
productName string | The name of the Product |
releaseId string: UUID | The unique identifier of Release. |
releaseNumber int | The Release number. |
id string: UUID | The unique identifier of Variant. |
name string | The name of the Variant.
Max length: 255 |
Inventor IDW Output object | |
type enum:string | Defines this Output definition to be of IDW type. Will always be: IDW |
settings object | |
templatePath string | The relative path to Drawing Template File. |
id string: UUID | The unique identifier of Output. |
status enum:string | Possible values: PENDING , SUCCESS , FAILED |
createdAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was created. |
updatedAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was last updated. |
variantSnapshot object | |
projectId string: UUID | The Project Id. |
accountId string: UUID | The Account Id. |
productId string: UUID | The unique identifier of Product. |
productName string | The name of the Product |
releaseId string: UUID | The unique identifier of Release. |
releaseNumber int | The Release number. |
id string: UUID | The unique identifier of Variant. |
name string | The name of the Variant.
Max length: 255 |
Inventor SAT Output object | |
type enum:string | Defines this Output definition to be of SAT type. Will always be: SAT |
settings object | |
representation string | The representation for this Output. |
id string: UUID | The unique identifier of Output. |
status enum:string | Possible values: PENDING , SUCCESS , FAILED |
createdAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was created. |
updatedAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was last updated. |
variantSnapshot object | |
projectId string: UUID | The Project Id. |
accountId string: UUID | The Account Id. |
productId string: UUID | The unique identifier of Product. |
productName string | The name of the Product |
releaseId string: UUID | The unique identifier of Release. |
releaseNumber int | The Release number. |
id string: UUID | The unique identifier of Variant. |
name string | The name of the Variant.
Max length: 255 |
Inventor SVF Output object | |
type enum:string | Defines this Output definition to be of SVF type. Will always be: SVF |
settings object | |
representation string | The representation for this Output. |
id string: UUID | The unique identifier of Output. |
status enum:string | Possible values: PENDING , SUCCESS , FAILED |
createdAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was created. |
updatedAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was last updated. |
variantSnapshot object | |
projectId string: UUID | The Project Id. |
accountId string: UUID | The Account Id. |
productId string: UUID | The unique identifier of Product. |
productName string | The name of the Product |
releaseId string: UUID | The unique identifier of Release. |
releaseNumber int | The Release number. |
id string: UUID | The unique identifier of Variant. |
name string | The name of the Variant.
Max length: 255 |
Inventor DWG3D Output object | |
type enum:string | Defines this Output definition to be of DWG3D type. Will always be: DWG3D |
settings object | |
representation string | The representation for this Output. |
id string: UUID | The unique identifier of Output. |
status enum:string | Possible values: PENDING , SUCCESS , FAILED |
createdAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was created. |
updatedAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was last updated. |
variantSnapshot object | |
projectId string: UUID | The Project Id. |
accountId string: UUID | The Account Id. |
productId string: UUID | The unique identifier of Product. |
productName string | The name of the Product |
releaseId string: UUID | The unique identifier of Release. |
releaseNumber int | The Release number. |
id string: UUID | The unique identifier of Variant. |
name string | The name of the Variant.
Max length: 255 |
1 array | |
oneOf array:oneOf | |
Fusion RFA Output object | |
type enum:string | Defines this Output definition to be of RFA type. Will always be: RFA |
settings object | |
version enum:string | The application version for this Output.
Possible values: 2024 , 2025 , 2026 |
category string | The category to be set on generated Revit family. |
family string | The name for the generated Revit family. |
id string: UUID | The unique identifier of Output. |
status enum:string | Possible values: PENDING , SUCCESS , FAILED |
createdAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was created. |
updatedAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was last updated. |
variantSnapshot object | |
projectId string: UUID | The Project Id. |
accountId string: UUID | The Account Id. |
productId string: UUID | The unique identifier of Product. |
productName string | The name of the Product |
releaseId string: UUID | The unique identifier of Release. |
releaseNumber int | The Release number. |
id string: UUID | The unique identifier of Variant. |
name string | The name of the Variant.
Max length: 255 |
Fusion BCD Output object | |
type enum:string | Defines this Output definition to be of BCD type. Will always be: BCD |
settings object | |
category string | The category to be set on generated Revit family. |
family string | The name for the generated Revit family. |
id string: UUID | The unique identifier of Output. |
status enum:string | Possible values: PENDING , SUCCESS , FAILED |
createdAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was created. |
updatedAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was last updated. |
variantSnapshot object | |
projectId string: UUID | The Project Id. |
accountId string: UUID | The Account Id. |
productId string: UUID | The unique identifier of Product. |
productName string | The name of the Product |
releaseId string: UUID | The unique identifier of Release. |
releaseNumber int | The Release number. |
id string: UUID | The unique identifier of Variant. |
name string | The name of the Variant.
Max length: 255 |
Fusion SAT Output object | |
type enum:string | Defines this Output definition to be of SAT type. Will always be: SAT |
settings object | |
id string: UUID | The unique identifier of Output. |
status enum:string | Possible values: PENDING , SUCCESS , FAILED |
createdAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was created. |
updatedAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was last updated. |
variantSnapshot object | |
projectId string: UUID | The Project Id. |
accountId string: UUID | The Account Id. |
productId string: UUID | The unique identifier of Product. |
productName string | The name of the Product |
releaseId string: UUID | The unique identifier of Release. |
releaseNumber int | The Release number. |
id string: UUID | The unique identifier of Variant. |
name string | The name of the Variant.
Max length: 255 |
Fusion STEP Output object | |
type enum:string | Defines this Output definition to be of STEP type. Will always be: STEP |
settings object | |
id string: UUID | The unique identifier of Output. |
status enum:string | Possible values: PENDING , SUCCESS , FAILED |
createdAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was created. |
updatedAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was last updated. |
variantSnapshot object | |
projectId string: UUID | The Project Id. |
accountId string: UUID | The Account Id. |
productId string: UUID | The unique identifier of Product. |
productName string | The name of the Product |
releaseId string: UUID | The unique identifier of Release. |
releaseNumber int | The Release number. |
id string: UUID | The unique identifier of Variant. |
name string | The name of the Variant.
Max length: 255 |
Fusion Thumbnail Output object | |
type enum:string | Defines this Output definition to be of THUMBNAIL type. Will always be: THUMBNAIL |
settings object | |
id string: UUID | The unique identifier of Output. |
status enum:string | Possible values: PENDING , SUCCESS , FAILED |
createdAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was created. |
updatedAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was last updated. |
variantSnapshot object | |
projectId string: UUID | The Project Id. |
accountId string: UUID | The Account Id. |
productId string: UUID | The unique identifier of Product. |
productName string | The name of the Product |
releaseId string: UUID | The unique identifier of Release. |
releaseNumber int | The Release number. |
id string: UUID | The unique identifier of Variant. |
name string | The name of the Variant.
Max length: 255 |
Fusion F3D Output object | |
type enum:string | Defines this Output definition to be of F3D type. Will always be: F3D |
settings object | |
id string: UUID | The unique identifier of Output. |
status enum:string | Possible values: PENDING , SUCCESS , FAILED |
createdAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was created. |
updatedAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was last updated. |
variantSnapshot object | |
projectId string: UUID | The Project Id. |
accountId string: UUID | The Account Id. |
productId string: UUID | The unique identifier of Product. |
productName string | The name of the Product |
releaseId string: UUID | The unique identifier of Release. |
releaseNumber int | The Release number. |
id string: UUID | The unique identifier of Variant. |
name string | The name of the Variant.
Max length: 255 |
metaInfo object | The metaInfo for Upload. Supports adding custom properties. |
source object | The metaInfo for source. Supports adding custom properties. |
modelName string | The name of the source model. |
modelId string | The unique identifier of the source model. |
accountId string | The ID of the source account. |
accountName string | The name of the source account. |
projectId string | The ID of the source project. |
projectName string | The name of the source project. |
uploadLocation object | The metaInfo for upload location. Supports adding custom properties. |
vendor enum:string | The vendor location.
Possible values: ACC , BIM360 , FUSIONTEAM |
project string | The ID of the target project for the upload. |
folder string | The URN of the target folder for the upload. |
folderName string | The name of the target folder. |
location one of | |
BIM360 object | The upload location details for BIM360. |
vendor enum:string | The upload location vendor. Will always be: BIM360 |
project string | The project Id. |
folder string | The folder URN. |
ACC object | The upload location details for ACC. |
vendor enum:string | The upload location vendor. Will always be: ACC |
project string | The project Id. |
folder string | The folder URN. |
FUSIONTEAM object | The upload location details for Fusion Team. |
vendor enum:string | The upload location vendor. Will always be: FUSIONTEAM |
project string | The project Id. |
folder string | The folder URN. |
onComplete object | The onComplete URL and VERB. |
verb enum:string | The HTTP verb to use for the callback.
Possible values: POST , PUT , PATCH , GET |
url string | The URL to send the callback to. |
onProgress object | The onProgress URL and VERB. |
verb enum:string | The HTTP verb to use for the callback.
Possible values: POST , PUT , PATCH , GET |
url string | The URL to send the callback to. |
status enum:string | The status of the upload request.
Possible values: SUCCESS , FAILED , PENDING |
logFile string | The URL to the log file for the upload request |
createdAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was created. |
updatedAt datetime: ISO 8601 | The timestamp(ISO 8601) when the resource was last updated. |
Example
A page of Upload Requests was retrieved successfully.
Request
curl -v 'https://developer.api.autodesk.com/industrialized-construction/informed-design/v1/uploads?limit=50&offset=1&filter[project]=12345678-1234-1234-1234-1234567890ab&filter[folder]=urn:adsk.wipstg:fs.folder:co.ObAD7BpLXdKZiXK_OSJBow&filter[outputTypes]=RFA,BOM,THUMBNAIL' \
-H 'Authorization: Bearer AuIPTf4KYLTYGVnOHQ0cuolwCW2a'
Response
{
"pagination": {
"limit": "",
"offset": "",
"totalResults": "",
"nextUrl": "",
"previousUrl": ""
},
"filters": {
"project": "",
"folder": "",
"outputTypes": [
"RFA"
],
"createdAt": {
"start": "",
"end": ""
},
"updatedAt": {
"start": "",
"end": ""
}
},
"results": [
{
"accessType": "ACC",
"accessId": "",
"id": "",
"outputs": {},
"metaInfo": {
"source": {
"modelName": "",
"modelId": "",
"accountId": "",
"accountName": "",
"projectId": "",
"projectName": ""
},
"uploadLocation": {
"vendor": "ACC",
"project": "",
"folder": "",
"folderName": ""
}
},
"location": {
"vendor": "BIM360",
"project": "",
"folder": ""
},
"onComplete": {
"verb": "POST",
"url": ""
},
"onProgress": {
"verb": "POST",
"url": ""
},
"status": "SUCCESS",
"logFile": "",
"createdAt": "",
"updatedAt": ""
}
]
}