API documentation
    • Back to home
    • Folder
    • Create
      POST
    • Update
      PUT
    • Delete
      DELETE
    • Move folder
      POST
    • Copy folder
      POST
    • List
      GET
    • Detail
      GET
    • Subfolders lists
      GET

      Create

      POST
      https://api.everabyte.io/api/folders/create/c0awv0oseisvm83lru953k12
      This endpoint create a folder inside a bucket identified by bucketId. You can create a top-level folder by setting parentId to null, or create a subfolder by providing an existing folder ID in parentId.

      Method#

      POST /folder/create/{bucketId}

      Request Body Parameters#

      Path parameters and body fields for this endpoint are shown below.
      ParameterLocationTypeRequiredDescription
      bucketIdPathstringYesThe ID of the bucket or parent container where the folder will be created. Example: a1b2c3d4-e5f6-7890-1234-567890abcdef.
      nameBodystringYesThe name of the new folder to create.
      parentIdBodystring or nullNoThe folder ID to use when creating a subfolder. Use null to create the folder at the root level of the specified bucket.
      Example request for a root-level folder:
      {
  "name": "Project Documents",
  "parentId": null
}
      Example request for a subfolder:
      {
  "name": "Invoices",
  "parentId": "beycwbmmvu2symytbmzh8r1f"
}
      Example HTTP request:

      Response Codes#

      201 Created — Folder was created successfully, and the response may include the new folder ID.
      400 Bad Request — The request body is invalid, for example if name is missing or too long.
      404 Not Found — The specified parent folder or bucket was not found.
      409 Conflict — A folder with the same name already exists in the target parent folder.
      500 Internal Server Error — The server failed while processing the request.

      Request

      Body Params application/json

      Example
      {
    "name": "Videos",
    "parentId": "beycwbmmvu2symytbmzh8r1f"
}

      Request Code Samples

      Shell
      JavaScript
      Java
      Swift
      Go
      PHP
      Python
      HTTP
      C
      C#
      Objective-C
      Ruby
      OCaml
      Dart
      R
      Request Request Example
      Shell
      JavaScript
      Java
      Swift
      curl --location 'https://api.everabyte.io/api/folders/create/c0awv0oseisvm83lru953k12' \
--header 'Content-Type: application/json' \
--data '{
    "name": "Videos",
    "parentId": "beycwbmmvu2symytbmzh8r1f"
}'

      Responses

      🟢200Success
      application/json
      Bodyapplication/json

      Example
      {
  "status": 200,
  "message": "Folder created successfully.",
  "data": {
    "id": "udxzapr8wsndsxc09bc41qes",
    "parentId": null,
    "name": "Credia",
    "visibility": "private",
    "isDelete": false,
    "createdAt": "2026-05-12T12:55:00.534Z",
    "updatedAt": "2026-05-12T12:55:00.534Z",
    "deletedAt": null
  }
}
      Modified at 2026-05-12 13:22:07
      Next
      Update
      Built with