Request

Response

    Download a terrain GLB file
    GET

    v1alpha/terrains/{elementId}/revisions/{revision}/download

    This endpoint is used to download a specific terrain GLB file by providing the terrain’s elementId and revision.

    Resource Information

    Method and URI
    GET
    https://developer.api.autodesk.com/forma/terrain/v1alpha/terrains/{elementId}/revisions/{revision}/download
    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

    URI Parameters

    elementId
    string
    ID of the element
    revision
    string
    Revision

    Request

    Query String Parameters

    authcontext*
    string
    Provides the authcontext of the request, such as the forma project
    * Required

    Response

    HTTP Status Code Summary

    307
    Redirects to the terrain GLB file download location.
    400
    Bad Request
    Error response
    403
    Forbidden
    Unauthorized
    404
    Not Found
    Error response
    500
    Internal Server Error
    Error response

    Response

    Body Structure

    Response for has no body.

    Example

    Request

    curl -v 'https://developer.api.autodesk.com/forma/terrain/v1alpha/terrains/:elementId/revisions/:revision/download?authcontext=pro_123' \
      -H 'Authorization: Bearer AuIPTf4KYLTYGVnOHQ0cuolwCW2a'
    

    Response