action box_get_folders_id_trash {
  label: "Get trashed folder"
  description: "Retrieves a folder that has been moved to the trash.\n\nPlease note that only if the folder itself has been moved to the\ntrash can it be retrieved with this API call. If instead one of\nits parent folders was moved to the trash, only that folder\ncan be inspected using the\n[`GET /folders/:id/trash`](e://get_folders_id_trash) API.\n\nTo list all items that have been moved to the trash, please\nuse the [`GET /folders/trash/items`](e://get-folders-trash-items/)\nAPI."
  provider: box
  method: GET
  path: "/folders/{folder_id}/trash"
  encoding: json
  input: {
    type: "object"
    properties: {
      fields: {
        type: "array"
        items: {
          type: "string"
        }
      }
      folder_id: {
        type: "string"
      }
    }
    required: ["folder_id"]
    additionalProperties: false
  }
  output: {
    type: "object"
    description: "Represents a trashed folder."
    required: ["created_by", "description", "id", "item_status", "modified_by", "name", "owned_by", "path_collection", "size", "type"]
    properties: {
      content_created_at: {
        type: "string"
        format: "date-time"
        description: "The date and time at which this folder was originally\ncreated."
      }
      content_modified_at: {
        type: "string"
        format: "date-time"
        description: "The date and time at which this folder was last updated."
      }
      created_at: {
        type: "string"
        format: "date-time"
        description: "The date and time when the folder was created. This value may\nbe `null` for some folders such as the root folder or the trash\nfolder."
      }
      created_by: {
        type: "object"
      }
      description: {
        type: "object"
      }
      etag: {
        type: "string"
        description: "The HTTP `etag` of this folder. This can be used within some API\nendpoints in the `If-Match` and `If-None-Match` headers to only\nperform changes on the folder if (no) changes have happened."
      }
      folder_upload_email: {
        type: "string"
        description: "The folder upload email for this folder. This will\nbe `null` if a folder has been trashed, since the upload will no longer\nwork."
      }
      id: {
        type: "string"
        description: "The unique identifier that represent a folder.\n\nThe ID for any folder can be determined\nby visiting a folder in the web application\nand copying the ID from the URL. For example,\nfor the URL `https://*.app.box.com/folders/123`\nthe `folder_id` is `123`."
      }
      item_status: {
        type: "string"
        description: "Defines if this item has been deleted or not.\n\n* `active` when the item has is not in the trash\n* `trashed` when the item has been moved to the trash but not deleted\n* `deleted` when the item has been permanently deleted."
        enum: ["active", "trashed", "deleted"]
      }
      modified_at: {
        type: "string"
        format: "date-time"
        description: "The date and time when the folder was last updated. This value may\nbe `null` for some folders such as the root folder or the trash\nfolder."
      }
      modified_by: {
        type: "object"
      }
      name: {
        type: "string"
        description: "The name of the folder."
      }
      owned_by: {
        type: "object"
      }
      parent: {
        type: "object"
      }
      path_collection: {
        type: "object"
      }
      purged_at: {
        type: "string"
        format: "date-time"
        description: "The time at which this folder is expected to be purged\nfrom the trash."
      }
      sequence_id: {
        type: "object"
      }
      shared_link: {
        type: "string"
        description: "The shared link for this folder. This will\nbe `null` if a folder has been trashed, since the link will no longer\nbe active."
      }
      size: {
        type: "integer"
        format: "int64"
        description: "The folder size in bytes.\n\nBe careful parsing this integer as its\nvalue can get very large."
      }
      trashed_at: {
        type: "string"
        format: "date-time"
        description: "The time at which this folder was put in the trash."
      }
      type: {
        type: "string"
        description: "`folder`"
        enum: ["folder"]
      }
    }
  }
}