Delete a synced root folder
Permanently removes a synced root folder and all its associated content from Mindtickle Content Center.
Prerequisites
- Authentication and setup: A valid access token.
- Create an integration: The integration must exist and provide the integration ID and root folder ID.
Endpoint
Section titled “Endpoint”DELETE /services/data/v1.0/content/integration/{integrationId}Base URL: the standard REST host for your region. See Base URLs.
| Header | Required | Value or description |
|---|---|---|
Authorization |
Required | Bearer ACCESS_TOKEN |
X-Consumer-Custom-Id |
Required | COMPANY_ID |
Content-Type |
Required | application/json |
Path parameters
Section titled “Path parameters”| Parameter | Type | Description |
|---|---|---|
integrationId |
string | The unique identifier for the integration. |
Query parameters
Section titled “Query parameters”| Parameter | Type | Required | Description |
|---|---|---|---|
rootFolderId |
string | Required | The unique identifier of the root folder in Content Center that you want to permanently delete. |
Request
Section titled “Request”This endpoint has no request body.
Request example
Section titled “Request example”curl --location --request DELETE \'https://api.mindtickle.com/services/data/v1.0/content/integration/INTEGRATION_ID?rootFolderId=ROOT_FOLDER_ID' \--header 'Authorization: Bearer ACCESS_TOKEN' \--header 'X-Consumer-Custom-Id: COMPANY_ID' \--header 'Content-Type: application/json'Response
Section titled “Response”A successful call returns 200 OK. Check the HTTP status to determine the outcome.
Response example
Section titled “Response example”200 OK- Behavior: This operation deletes the specified root folder and all its subfolders and files.
- Permissions: Only users with admin privileges can perform this operation.
- Limitations: The action is irreversible. Ensure you have backups if necessary.
- Files in use: If a file is in use while this API runs, the file goes into offline mode. The file and the folders in its hierarchy are not deleted, and you must manually delete the file along with the relevant folders and subfolders from the Content Center.