Skip to content

Get Navigation Tree

Get folder structure hierarchy within File Request.

Endpoint

http
GET /api/v1/requests/{file_request_id}/items?include=tree

Parameters

Path parameters

ParameterTypeRequiredDescription
file_request_idstringyes-

Query parameters

ParameterTypeRequiredDescription
includestringyesUse tree to return the folder tree.

Request example

sh
curl --location --request GET 'https://files.ro/api/v1/requests/{file_request_id}/items?include=tree' \

Response

json
[
  {
    "name": "Upload request",
    "location": "upload-request",
    "folders": [
      {
        "id": "folder_123",
        "parent_id": null,
        "name": "Uploads",
        "folders": []
      }
    ],
    "isMovable": true,
    "isOpen": true
  }
]
json
{
  "type": "error",
  "message": "Access Denied"
}
json
{
  "message": "The given data was invalid.",
  "errors": {
    "field": [
      "The field is required."
    ]
  }
}