Request

Response

    Delete Manifest
    DELETE

    {urn}/manifest

    Deletes the manifest of the specified source design. It also deletes all derivatives (translated output files) generated from the source design. However, it does not delete the source design.

    Note: This operation is idempotent. So, if you call it multiple times, even when no manifest exists, will still return a successful response (200).

    Resource Information
    Method and URI
    DELETE
     https://developer.api.autodesk.com/modelderivative/v2/designdata/{urn}/manifest
    Method and URI (EMEA)
    DELETE
     https://developer.api.autodesk.com/modelderivative/v2/regions/eu/designdata/{urn}/manifest
    Authentication Context
    user context optional
    Required OAuth Scopes
    data:write data:read
    Data Format
    JSON

    Request

    Headers
    Authorization*
    string
    		Must be Bearer <token>, where <token> is obtained via POST /authentication/v2/token
    region
    enum: string
    		Specifies the data center where the specified manifest is stored in. Possible values are:
    • US : (Default) Data center for the US region.
    • EMEA : Data center for the European Union, Middle East, and Africa regions.
    • AUS : (Beta) Data centre for the Australia region.

    Note:

    • Beta features are subject to change. Please avoid using them in production environments.
    • The Model Derivative service ignores this parameter if you use the EMEA URI for this operation.
    * Required

    Request

    URI Parameters
    urn
    string
    		The URL safe Base64 encoded URN of the source design.

    Response

    HTTP Status Code Summary
    200
    OK
    		Manifest and derivatives are deleted. Note that this code is also returned if the manifest does not exist.
    400
    BAD REQUEST
    		Invalid request. E.g. input URN format is invalid.
    401
    UNAUTHORIZED
    		Invalid authorization header, the token scope is invalid, or the Client ID lacks access privileges for this operation.
    403
    FORBIDDEN
    		Access denied regardless of authorization status. Verify if the token scope includes``data:write``.
    404
    NOT FOUND
    		The manifest does not exist.
    500
    INTERNAL SERVICE ERROR
    		Unexpected service interruption.

    Response

    HTTP Headers
    x-ads-app-identifier
    string
    		The service identifier. Comprises of the service name, version, and environment.
    x-ads-startup-time
    string
    		The service startup time with data format EEE MMM dd HH:mm:ss Z yyyy.
    x-ads-duration
    string
    		The request duration in milliseconds.

    Response

    Body Structure (200)
    result
    string
    		A message describing outcome of the operation. Always success for status 200.

    Response

    Body Structure (400)
    diagnostics
    string
    		reason for failure

    Example

    Success. Deletes a Manifest and its Derivatives (200)

    Request

    curl -X 'DELETE' \
     -H 'Authorization: Bearer PtnrvrtSRpWwUi3407QhgvqdUVKL' \
     -v 'https://developer.api.autodesk.com/modelderivative/v2/designdata/dXJuOmFkc2sub2JqZWN0czpvcy5vYmplY3Q6bW9kZWxkZXJpdmF0aXZlL0E1LnppcA/manifest'

    Response

    Status Code: 200 OK
Content-Type:application/json;charset=utf-8
x-ads-app-identifier:platform-viewing-2016.05.03.1102.2f6bfbf-production
x-ads-startup-time:Wed May 11 14:03:54 CST 2016
x-ads-duration:280 ms

{
  "result":"success"
}
    Show More