Get a signed link to upload a payload
GET
v1alpha/upload-link
Useful for submitting element trees with more than 6MB of data
Resource Information
| Method and URI | GET https://developer.api.autodesk.com/forma/integrate/v1alpha/upload-link |
| Authentication Context | user context optional |
| Required OAuth Scopes | data:read data:write |
| Data Format | JSON |
Request
Headers
| Authorization* string | Must be Bearer <token>, where <token> is obtained via either a two-legged or three-legged OAuth flow. |
| X-Ads-Region string | Specifies the geographical location (region) of the service. US or EMEA. Defaults to US. |
* Required
Request
Query String Parameters
| authcontext* string | Authcontext for the request, such as the Forma project context. |
* Required
Response
HTTP Status Code Summary
| 200 OK | Id of upload, and corresponding upload URL |
| 400 Bad Request | Malformed request. The request body is not valid according to the schema. See response for details. |
| 401 Unauthorized | Bearer token is not valid |
| 403 Forbidden | Token does not have access to the specified authcontext. Are you in the right region? |
| 500 Internal Server Error | Internal server error |
Response
Body Structure (200)
| id string | |
| url string | |
| blobId string |
Example
Id of upload, and corresponding upload URL
Request
curl -v 'https://developer.api.autodesk.com/forma/integrate/v1alpha/upload-link?authcontext=pro_123' \
-H 'Authorization: Bearer AuIPTf4KYLTYGVnOHQ0cuolwCW2a'
Response
{
"id": "",
"url": "",
"blobId": ""
}