Get Folder Breadcrumbs
## Get Folder Breadcrumbs
Retrieves the **breadcrumb path** for a specific folder.
This helps build navigation showing the folder hierarchy from the root to the selected folder.
**Method:** `GET`
**URL:** `{{base_url}}/folders/{{folder_id}}/breadcrumbs`
---
## Authentication
This endpoint requires authentication.
Use a **Bearer token** in the `Authorization` header:
```http
Authorization: Bearer {{access_token}}
```
---
## Headers
| Header | Value |
|---|---|
| Authorization | Bearer {{access_token}} |
---
## Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `folder_id` | integer | Yes | ID of the folder for which breadcrumbs are required |
Example endpoint:
```
{{base_url}}/folders/{{folder_id}}/breadcrumbs
```
---
## Required Variables
| Variable | Required | Description |
|---|---|---|
| `base_url` | Yes | Base API URL |
| `access_token` | Yes | Authentication access token |
| `folder_id` | Yes | Folder ID to retrieve breadcrumb path |
---
## Sample Request
```bash
curl --request GET "{{base_url}}/folders/{{folder_id}}/breadcrumbs" \
--header "Authorization: Bearer {{access_token}}"
```
---
## Sample Success Response
A successful request typically returns **HTTP 200 OK**.
```json
{
"success": true,
"data": [
{
"id": 9,
"name": "test"
},
{
"id": 10,
"name": "test2"
}
]
}
```
---
## Response Fields
| Field | Type | Description |
|---|---|---|
| `id` | integer | Folder ID in the breadcrumb path |
| `name` | string | Folder name |
---
## Notes
- The breadcrumb list is returned **in hierarchical order**.
- The first item is the **top-level parent folder**, and the last item is the **current folder**.
- Useful for building **folder navigation UI**, such as:
```
test / test2
```
Example UI usage:
```javascript
breadcrumbs.map(folder => {
return `<a href="/folders/${folder.id}">${folder.name}</a>`;
});
```
Response
OK
data
success