Folders
Endpoints for creating, listing, renaming, and deleting folders to organize your media library.
List folders
GET /folders
List folders for your team.
Scope: folders.lists
Description: Returns all folders for your team. API tokens are automatically scoped to their own team. Supports search filtering.
Parameters
| Parameter | Type | Description |
|---|---|---|
q | string | Search query to filter by name |
Request
curl "https://api.presscart.com/folders" \
-H "Authorization: Bearer $PRESSCART_API_TOKEN"Response
{
"records": [
{
"id": "cccccccc-cccc-cccc-cccc-cccccccccccc",
"name": "Brand Assets",
"team_id": "11111111-1111-1111-1111-111111111111",
"created_by": "22222222-2222-2222-2222-222222222222",
"created_at": "2026-03-01T09:00:00.000Z",
"updated_at": "2026-03-01T09:00:00.000Z",
"deleted_at": null
},
{
"id": "dddddddd-dddd-dddd-dddd-dddddddddddd",
"name": "Campaign Photos",
"team_id": "11111111-1111-1111-1111-111111111111",
"created_by": "22222222-2222-2222-2222-222222222222",
"created_at": "2026-03-10T14:30:00.000Z",
"updated_at": "2026-03-10T14:30:00.000Z",
"deleted_at": null
}
]
}Create folder
POST /folders
Create a new folder.
Scope: folders.create
Description: Creates a folder in your team's media library for organizing files.
Body
| Field | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Folder name |
Request
curl -X POST "https://api.presscart.com/folders" \
-H "Authorization: Bearer $PRESSCART_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "name": "Brand Assets" }'Response
{
"id": "cccccccc-cccc-cccc-cccc-cccccccccccc",
"name": "Brand Assets",
"team_id": "11111111-1111-1111-1111-111111111111",
"created_by": "22222222-2222-2222-2222-222222222222",
"created_at": "2026-03-01T09:00:00.000Z",
"updated_at": "2026-03-01T09:00:00.000Z",
"deleted_at": null
}Rename folder
PATCH /folders/{folder_id}
Rename an existing folder.
Scope: folders.update
Description: Updates the name of a folder. The folder must belong to your team.
Path parameters
| Parameter | Type | Description |
|---|---|---|
folder_id | string | UUID of the folder |
Body
| Field | Type | Required | Description |
|---|---|---|---|
name | string | Yes | New folder name |
Request
curl -X PATCH "https://api.presscart.com/folders/cccccccc-cccc-cccc-cccc-cccccccccccc" \
-H "Authorization: Bearer $PRESSCART_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "name": "Updated Brand Assets" }'Response
{
"id": "cccccccc-cccc-cccc-cccc-cccccccccccc",
"name": "Updated Brand Assets",
"team_id": "11111111-1111-1111-1111-111111111111",
"created_by": "22222222-2222-2222-2222-222222222222",
"created_at": "2026-03-01T09:00:00.000Z",
"updated_at": "2026-04-16T11:00:00.000Z",
"deleted_at": null
}Delete folder
DELETE /folders/{folder_id}
Delete a folder.
Scope: folders.delete
Description: Soft-deletes a folder. Files inside the folder are not deleted — they remain accessible but lose their folder association.
Path parameters
| Parameter | Type | Description |
|---|---|---|
folder_id | string | UUID of the folder |
Request
curl -X DELETE "https://api.presscart.com/folders/cccccccc-cccc-cccc-cccc-cccccccccccc" \
-H "Authorization: Bearer $PRESSCART_API_TOKEN"Response
{
"success": true
}