Create new folder

Create new folder

In this article, you will learn how to create a new folder.

Create new folder

Request Type: POST
Header: Authorization: ApiKey <my_api_token>
URL: https://app.banyanboard.com/api/orgs/<my_org_uuid>/folders/

Payload:
Info
{
  "name": "Sample Folder Name"
}

Results:
Info
{
  "banner_file_thumbnail_url": null,
  "creator_name": "service_admin_abcdef123456",
  "creator_nickname": "service_admin_user",
  "date_created": "2026-03-30T09:15:20.123456Z",
  "is_locked": false,
  "is_public": false,
  "last_accessed": "2026-03-30T09:15:20.123456Z",
  "name": "Sample Folder Name",
  "organization": "a1b2c3d4-5e6f-4a7b-9c8d-1e2f3a4b5c6d",
  "organization_name": "Sample Organization",
  "uuid": "e5f6a7b8-c9d0-4e1f-8a2b-3c4d5e6f7a8b",
  "is_owner_or_admin": true,
  "folder_permission_type": "owner",
  "thumbnail_url": null,
  "total_annotations": 0,
  "total_assets": 0,
  "total_comments": 0,
  "total_views": 0
}