Mark a terrain as uploaded
PATCH
v1alpha/terrains/{elementId}/revisions/{revision}
This endpoint is used to mark a specific terrain as uploaded by providing the terrain’s elementId and revision.
Resource Information
| Method and URI | PATCH https://developer.api.autodesk.com/forma/terrain/v1alpha/terrains/{elementId}/revisions/{revision} |
| 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
Response
HTTP Status Code Summary
| 200 OK | Returns the updated terrain state. |
| 400 Bad Request | Error response |
| 403 Forbidden | Unauthorized |
| 404 Not Found | Error response |
| 500 Internal Server Error | Error response |
Response
Body Structure (200)
| id string | |
| revision string | |
| state enum:string | Possible values: creating, patching, complete, failed |
Example
Returns the updated terrain state.
Request
curl -v 'https://developer.api.autodesk.com/forma/terrain/v1alpha/terrains/:elementId/revisions/:revision' \
-X 'PATCH' \
-H 'Authorization: Bearer AuIPTf4KYLTYGVnOHQ0cuolwCW2a'
Response
{
"elementId": "5d943f58-042f-453e-b605-df7217fc5a3f",
"revision": "1682339192328",
"state": "complete"
}