---
title: "Delete drive folder"
method: DELETE
path: "/drive_folders/{id}"
tags: ["Drive Folders"]
---

# Delete drive folder

`DELETE /drive_folders/{id}`

Soft-delete a drive folder. Root folder and entity folders cannot be deleted.

## Path parameters

- `id` integer, required

## Response `200`

Folder deleted (soft-deleted) successfully

- object
  - `data` DriveFolderWithFiles — Drive folder including nested sub-folders and files
    - `id` integer
    - `name` string
    - `client_visible` boolean
    - `entity_id` integer, nullable
    - `path` string
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `parent_folder` DriveFolder — Drive folder (shallow representation)
      - `id` integer
      - `name` string
      - `client_visible` boolean
      - `entity_id` integer, nullable
      - `path` string — Full path to the folder from the root (e.g. "/Root/2024/Client")
      - `created_at` string, date-time
      - `updated_at` string, date-time
    - `entity` EntityExtended
      - `id` integer
      - `client_id_number` string
      - `name` string
      - `entity_type` string
      - `metadata` object — Additional metadata for the entity, contents may vary
      - `ein` string — Employer Identification Number (EIN)
      - `other_ids` object — Other identifying information, contents may vary
      - `created_at` string, date-time
      - `updated_at` string, date-time
      - `primary_contact` object — Primary contact for this entity
      - `contacts` ContactExtended[] — List of contacts associated with this entity
        - `id` integer
        - `first_name` string
        - `last_name` string
        - `nick_name` string
        - `company` string
        - `job_title` string
        - `client_id_number` string
        - `tags` Tag[]
          - `id` integer
          - `name` string
        - `contact_emails` ContactEmail[]
          - `id` integer
          - `email` string
          - `primary` boolean
          - `created_at` string, date-time
          - `updated_at` string, date-time
        - `contact_phones` ContactPhone[]
          - `id` integer
          - `phone_number` string
          - `country_code` string
          - `country_phone_code` string
          - `phone_type` 'mobile' | 'home' | 'work' | 'fax' | 'office' | 'other'
          - `primary` boolean
          - `metadata` object
          - `created_at` string, date-time
          - `updated_at` string, date-time
        - `contact_addresses` ContactAddress[]
          - `id` integer
          - `street_address` string
          - `city` string
          - `state` string
          - `zip` string
          - `primary` boolean
          - `created_at` string, date-time
          - `updated_at` string, date-time
        - `entity_origins` Entity[]
          - `id` integer
          - `client_id_number` string
          - `name` string
          - `entity_type` string
          - `metadata` object
          - `ein` string
          - `other_ids` object
          - `created_at` string, date-time
          - `updated_at` string, date-time
          - `primary_contact` Contact
            - `contact` object
              - …
          - `contacts` Contact[]
            - `contact` object
              - …
          - `projects` Project[]
            - `id` integer
            - `name` string
            - `idempotency_key` string
            - `metadata` object
            - `due_date` string, date-time
            - `assignees` Assignee[]
              - …
            - `user` User
              - …
            - `tags` Tag[]
              - …
            - `tasks` Task[]
              - …
            - `project_status` ProjectStatus
              - …
      - `projects` ProjectExtended[] — List of projects associated with this entity
        - `id` integer
        - `name` string
        - `tax_year` string
        - `idempotency_key` string
        - `metadata` object
        - `due_date` string, date-time
        - `assignees` Assignee[]
          - `id` integer
          - `email` string
        - `tasks` Task[]
          - `id` integer
          - `name` string — Name of the task
          - `description` string — Description of the task - supports limited subset of HTML <b>, <ul>, <li>, <br>, and <a>.
          - `status` 'to_do' | 'pending_review' | 'approved' — Status of the task
        - `user` User
          - `id` integer
          - `email` string
        - `tags` Tag[]
          - `id` integer
          - `name` string
        - `entity` Entity
          - `id` integer
          - `client_id_number` string
          - `name` string
          - `entity_type` string
          - `metadata` object
          - `ein` string
          - `other_ids` object
          - `created_at` string, date-time
          - `updated_at` string, date-time
          - `primary_contact` Contact
            - `contact` object
              - …
          - `contacts` Contact[]
            - `contact` object
              - …
          - `projects` Project[]
            - `id` integer
            - `name` string
            - `idempotency_key` string
            - `metadata` object
            - `due_date` string, date-time
            - `assignees` Assignee[]
              - …
            - `user` User
              - …
            - `tags` Tag[]
              - …
            - `tasks` Task[]
              - …
            - `project_status` ProjectStatus
              - …
    - `sub_folders` DriveFolder[]
      - `id` integer
      - `name` string
      - `client_visible` boolean
      - `entity_id` integer, nullable
      - `path` string — Full path to the folder from the root (e.g. "/Root/2024/Client")
      - `created_at` string, date-time
      - `updated_at` string, date-time
    - `files` DriveFolderFile[] — Files in this folder
      - `attachment_id` integer — ID of the file attachment
      - `blob_id` integer — ID of the underlying ActiveStorage blob
      - `filename` string
      - `content_type` string
      - `byte_size` integer
      - `temporary_download_url` string, uri, nullable — Temporary pre-signed URL to download the file. Valid for a short period (e.g. 10 minutes).
      - `client_visible` boolean — Whether the file is visible to clients in their portal
      - `created_at` string, date-time

## Other responses

- `400` — Folder not found, attempt to delete root/entity folder, or drive not activated
- `422` — Validation errors when deleting the folder

---

[API](https://skmtc.net/gettruss/apis/api-v1.md) · [All operations](https://skmtc.net/gettruss/apis/api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gettruss/api-v1/versions/9418bb2b65bf/schema)