Skip to content
File Service

Delete space

Deletes the space. Upon deletion, all space associated resources are removed.

Delete space operation is eventually consistent. The specified space is removed immediately, while its children are deleted in a background. A jobId of that background process will be returned in the Location header of the response for tracking the progress of deletion.

In highly concurrent environments it is not guaranteed that all children will be marked as deleted. If active children creation or any other operation is ongoing in the space, those new and/or updated resources might stay active even after the job is completed, while parent resource will stay marked as deleted.

The following query parameters are available for the delete space operation:

  • permanent - Space can be deleted permanently by setting the permanent parameter to true. By default, spaces are only soft deleted.

  • recursive - For deleting non-empty space, recursive parameter needs to be specified as true.

Prerequisites

  • A space should be created. To know more about creating a space refer here

Request

DELETE {baseUrl}/spaces/{spaceId}

  • HEADER:

    • Authorization: Bearer {tid token}

Response

Response Headers:


Location: /jobs/d5fdc7b4-5ddd-44f0-8129-7596895c6fa6

To know more about the Delete space refer here.