Create a folder

Create a folder for the authenticated workspace.

1 min read

post/folders

Request example

from dub import Dub


with Dub(
    token="DUB_API_KEY",
) as d_client:

    res = d_client.folders.create()

    # Handle response
    print(res)

Response

{
  "id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "type": "default",
  "accessLevel": "write",
  "createdAt": "<string>",
  "updatedAt": "<string>"
}

post/folders

Authorization

Authorizationstringheaderrequired#

Default authentication mechanism

Body

application/json

namestringrequired#

The name of the folder.

Length: max 190

descriptionstring#

The description of the folder.

Length: max 500

accessLevelenum<string>#

The workspace-level access level settings for the folder. Default is write which allows full access to the folder for all team members. The other options are read (view-only access) and null (no access) and are only available on Business plans and above.

Default: "write"

Options:writeread

Responses

application/json

The created folder

idstringrequired#

The unique ID of the folder.

namestringrequired#

The name of the folder.

descriptionstringrequired#

The description of the folder.

typeenum<string>required#

Options:defaultmega

accessLevelenum<string>required#

Default: "write"

Options:writeread

createdAtstringrequired#

The date the folder was created.

updatedAtstringrequired#

The date the folder was updated.

Check domain availability Update folder