Request

Response

    Buckets
    DELETE

    buckets/:bucketKey

    Deletes a bucket. The bucket must be owned by the application.

    Warning:This operation is irreversable and cannot be undone.

    We recommend only deleting small buckets used for acceptance testing or prototyping, since it can take a long time for a bucket to be deleted.

    Note that the bucket name will not be immediately available for reuse.

    Resource Information
    Method and URI
    DELETE
     https://developer.api.autodesk.com/oss/v2/buckets/:bucketKey
    Authentication Context
    app-only
    Required OAuth Scopes
    bucket:delete

    Request

    Headers
    Authorization*
    string
    		Must be “Bearer <token>”, where <token> is obtained via POST token.
    * Required

    Request

    URI Parameters
    bucketKey*
    string
    		URL-encoded bucket name
    * Required

    Response

    HTTP Status Code Summary
    200
    OK
    		Successful operation.
    400
    BAD REQUEST
    The request could not be understood by the server due to malformed syntax or missing request headers. The client SHOULD NOT repeat the request without modifications. The response body may give an indication of what is wrong with the request.
    401
    UNAUTHORIZED
    		The supplied Authorization header was not valid or the supplied token scope was not acceptable. Verify authentication and try again.
    403
    FORBIDDEN
    		The Authorization was successfully validated but permission is not granted. Don’t try again unless you solve permissions first.
    404
    NOT FOUND
    		The specified bucketKey does not exist.
    409
    CONFLICT
    		The bucket is currently marked for deletion
    500
    INTERNAL SERVER ERROR
    		Internal failure while processing the request, reason depends on error.

    Response

    Body Structure (200)

    For a successful delete request, an HTTP 200 will be returned with no text in the response body.

    Example

    Delete Bucket (200)

    Request

       curl -v "https://developer.api.autodesk.com/oss/v2/buckets/bucketexamplekey"
-X DELETE
-H "Authorization: Bearer kuhodzPEHSCrWH3Pm1WuBMBnxw39"

    Response

    HTTP/1.1 200 OK
Access-Control-Allow-Credentials: true
Access-Control-Allow-Headers: Authorization, Accept-Encoding, Range, Content-Type
Access-Control-Allow-Methods: GET
Access-Control-Allow-Origin: *
Date: Wed, 25 May 2016 19:39:39 GMT
Server: Apigee Router
Content-Length: 0
Connection: keep-alive
    Show More