Request

Response

    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"
    }