Get a folder structure

GET /api/v1/folder/{folder_uuid}/tree

Headers

Authorization string
Content-Type string
Accept string

Path parameters

folder_uuid integer Required

Responses

200 application/json
Hide response attributes Show response attributes object
- uuid string
  
  The UUID of the resource.
- created_at string
  
  The timestamp of when the resource was created.
- updated_at string
  
  The timestamp of when the resource was updated.
- name string
  
  Folder name
- slug string
  
  Slug of the folder name
- path string
  
  Folder path
- clients_read boolean
  
  Denotes whether clients can access this folder and files
- clients_write boolean
  
  Denotes whether clients can upload files to this folder
- show_client_permissions boolean
  
  Denotes whether the option to change client permissions is enabled which depends on the firm show pseudo folders in client portal setting
- is_system_folder boolean
  
  Denotes if this folder is a system folder
- is_pseudo_folder boolean
  
  Denotes if this folder is a pseudo folder
- is_root_folder boolean
  
  Denotes if this folder is a root folder of a documentable item
- participants_count integer
  
  Number of accounts this folder has been directly shared with
- participants array[object]
  
  Participants whom this folder has been directly shared with.
  
  Additional properties are allowed.
- folders_count integer
  
  Number of subfolders within the folder
- folders array[object]
  
  Subfolders within the folder.
  
  Additional properties are allowed.
- files_count integer
  
  Number of files stored in the folder
- files array[object]
  
  Files stored in the folder.
  
  Additional properties are allowed.
- parents array[object]
  
  Parent folders.
  
  Additional properties are allowed.
- ancestors array[object]
  
  All parents folders up the folder heirarchy structure.
  
  Additional properties are allowed.
- children array[object]
  
  Subfolders within the folder.
  
  Additional properties are allowed.
- depth integer
  
  How many levels deep there are to this folder heirarchy structure
- owned boolean
  
  Is true if the authenticated account in the request has created this folder

GET /api/v1/folder/{folder_uuid}/tree

curl \
 -X GET https://api.plannrcrm.com/api/v1/folder/folder_uuid/tree \
 -H "Authorization: Bearer {OAUTH_ACCESS_TOKEN or PERSONAL_ACCESS_TOKEN}" \
 -H "Content-Type: application/json" \
 -H "Accept: application/json"

Response examples (200)

{
  "name": "Important Documents",
  "path": "Codepotato/Important Documents",
  "slug": "important-documents",
  "uuid": "56f807fe-0942-45b4-8def-d854963da9b5",
  "depth": 5,
  "files": [
    {
      "firm": "App\\Http\\Resources\\FirmResource",
      "name": "Welcome to Plannr",
      "size": "21691783",
      "tags": "App\\Http\\Resources\\TagResource",
      "type": "type",
      "uuid": "0f718e74-f8e0-409d-95aa-c2cfa57b3f8c",
      "parent": "Object",
      "status": "uploaded",
      "account": "App\\Http\\Resources\\AccountResource",
      "filename": "Welcome to Plannr.pdf",
      "progress": "100",
      "extension": "pdf",
      "created_at": "2025-01-17T11:18:30+00:00",
      "updated_at": "2025-01-17T11:18:30+00:00",
      "folder_name": "folder 2",
      "uploaded_at": "2025-01-17T11:18:30+00:00",
      "download_url": "https://plannr.valet/file/5b2c412a-c9e1-4d96-ae5f-f1d3f1fcadb4/download",
      "last_modified": "2025-01-17T11:18:30+00:00",
      "original_created_at": "2025-01-17T11:18:30+00:00"
    }
  ],
  "owned": false,
  "folders": [
    {
      "name": "Important Documents",
      "path": "Codepotato/Important Documents",
      "slug": "important-documents",
      "uuid": "4af915d4-4823-40da-9b1c-1f9132092be6",
      "depth": 5,
      "files": "App\\Http\\Resources\\FileResource",
      "owned": false,
      "folders": "App\\Http\\Resources\\FolderResource",
      "parents": "App\\Http\\Resources\\FolderResource",
      "children": "App\\Http\\Resources\\FolderResource",
      "ancestors": "App\\Http\\Resources\\FolderResource",
      "created_at": "2025-01-17T11:18:30+00:00",
      "updated_at": "2025-01-17T11:18:30+00:00",
      "files_count": 8,
      "clients_read": true,
      "participants": "App\\Http\\Resources\\FolderParticipantResource",
      "clients_write": true,
      "folders_count": 5,
      "is_root_folder": true,
      "is_pseudo_folder": true,
      "is_system_folder": true,
      "participants_count": 3,
      "show_client_permissions": true
    }
  ],
  "parents": [
    {
      "name": "Important Documents",
      "path": "Codepotato/Important Documents",
      "slug": "important-documents",
      "uuid": "f9591459-92d8-4c9d-b210-25dfa1927332",
      "depth": 5,
      "files": "App\\Http\\Resources\\FileResource",
      "owned": false,
      "folders": "App\\Http\\Resources\\FolderResource",
      "parents": "App\\Http\\Resources\\FolderResource",
      "children": "App\\Http\\Resources\\FolderResource",
      "ancestors": "App\\Http\\Resources\\FolderResource",
      "created_at": "2025-01-17T11:18:30+00:00",
      "updated_at": "2025-01-17T11:18:30+00:00",
      "files_count": 8,
      "clients_read": true,
      "participants": "App\\Http\\Resources\\FolderParticipantResource",
      "clients_write": true,
      "folders_count": 5,
      "is_root_folder": true,
      "is_pseudo_folder": true,
      "is_system_folder": true,
      "participants_count": 3,
      "show_client_permissions": true
    }
  ],
  "children": [
    {
      "name": "Important Documents",
      "path": "Codepotato/Important Documents",
      "slug": "important-documents",
      "uuid": "8d8e2842-25df-4d8f-8178-f08b10c8eac8",
      "depth": 5,
      "files": "App\\Http\\Resources\\FileResource",
      "owned": false,
      "folders": "App\\Http\\Resources\\FolderResource",
      "parents": "App\\Http\\Resources\\FolderResource",
      "children": "App\\Http\\Resources\\FolderResource",
      "ancestors": "App\\Http\\Resources\\FolderResource",
      "created_at": "2025-01-17T11:18:30+00:00",
      "updated_at": "2025-01-17T11:18:30+00:00",
      "files_count": 8,
      "clients_read": true,
      "participants": "App\\Http\\Resources\\FolderParticipantResource",
      "clients_write": true,
      "folders_count": 5,
      "is_root_folder": true,
      "is_pseudo_folder": true,
      "is_system_folder": true,
      "participants_count": 3,
      "show_client_permissions": true
    }
  ],
  "ancestors": [
    {
      "name": "Important Documents",
      "path": "Codepotato/Important Documents",
      "slug": "important-documents",
      "uuid": "cfc8adc0-7d56-4c26-b948-27145f6a9649",
      "depth": 5,
      "files": "App\\Http\\Resources\\FileResource",
      "owned": false,
      "folders": "App\\Http\\Resources\\FolderResource",
      "parents": "App\\Http\\Resources\\FolderResource",
      "children": "App\\Http\\Resources\\FolderResource",
      "ancestors": "App\\Http\\Resources\\FolderResource",
      "created_at": "2025-01-17T11:18:30+00:00",
      "updated_at": "2025-01-17T11:18:30+00:00",
      "files_count": 8,
      "clients_read": true,
      "participants": "App\\Http\\Resources\\FolderParticipantResource",
      "clients_write": true,
      "folders_count": 5,
      "is_root_folder": true,
      "is_pseudo_folder": true,
      "is_system_folder": true,
      "participants_count": 3,
      "show_client_permissions": true
    }
  ],
  "created_at": "2025-01-17T11:18:30+00:00",
  "updated_at": "2025-01-17T11:18:30+00:00",
  "files_count": 8,
  "clients_read": true,
  "participants": [
    {
      "name": "Gareth Thompson",
      "uuid": "72eebdb0-92bf-4d66-a5b5-b8f4545dae49",
      "write": true,
      "created_at": "2025-01-17T11:18:30+00:00",
      "updated_at": "2025-01-17T11:18:30+00:00"
    }
  ],
  "clients_write": true,
  "folders_count": 5,
  "is_root_folder": true,
  "is_pseudo_folder": true,
  "is_system_folder": true,
  "participants_count": 3,
  "show_client_permissions": true
}