# Delete folder

Delete a folder by ID.

Endpoint: DELETE /entities/folders/{id}
Version: 1.0.0

## Path parameters:

  - `id` (integer, required)
    Delete a folder

## Response 200 fields (application/vnd.treasuredata.v1+json):

  - `data` (object, required)

  - `data.id` (string, required)

  - `data.type` (string, required)
    Enum: "folder-segment"

  - `data.attributes` (object, required)

  - `data.attributes.audienceId` (string, required)

  - `data.attributes.name` (string, required)

  - `data.attributes.description` (string,null, required)

  - `data.attributes.createdAt` (string, required)

  - `data.attributes.updatedAt` (string, required)

  - `data.attributes.enrichments` (object,null)

  - `data.attributes.rule` (object,null)

  - `data.attributes.permissions` (object, required)

  - `data.attributes.permissions.view` (boolean)

  - `data.attributes.permissions.edit` (boolean)

  - `data.relationships` (object, required)

  - `data.relationships.children` (object)

  - `data.relationships.parentFolder` (object)

  - `data.relationships.createdBy` (object)

  - `data.relationships.updatedBy` (object)

  - `included` (array, required)

## Response 400 fields (application/json):

  - `errors` (array, required)

## Response 403 fields (application/json):

  - `errors` (array, required)

  - `errors.code` (string, required)
    Error code in string
    Enum: "permission-error"

  - `errors.status` (string, required)
    Status code for error
    Enum: "403"

  - `errors.detail` (string, required)
    Detailed error message
    Example: "SegmentFolder View Permission Required"

  - `errors.meta` (object)
    Meta info for storing permissionCode. Note that in some cases, meta can be null.

  - `errors.meta.permissionCode` (string, required)
    Detailed validation error code
    Enum: "SEGMENT_FOLDER_VIEW_REQUIRED", "SEGMENT_FOLDER_EDIT_REQUIRED"

## Response 404 fields (application/json):

  - `errors` (array, required)

  - `errors.code` (string, required)
    Error code in string
    Enum: "record-not-found-error"

  - `errors.status` (string, required)
    Enum: "404"

  - `errors.detail` (string, required)
    Detailed error message
    Example: "Record not found"

## Response 409 fields (application/json):

  - `errors` (object, required)
    Error messages. Key name can be vary depends on endpoint.

  - `errors.id` (array)
    Example: ["Segment is referenced by other segments: 123, 345"]

  - `errors.deletion` (array)
    Example: ["SegmentFolder has segments: 123, 456"]

  - `referencedBySegments` (array)
    This field exists only for segment deletion

  - `referencedBySegments.id` (string)
    Other Segment ID referencing this segment

  - `referencedByPredictiveSegments` (array)
    This field exists only for segment deletion

  - `referencedByPredictiveSegments.id` (string)
    PredictiveSegment ID referencing this segment