Create a folder

Can be used by the following roles assigned at the organization or folder scope:

• FOLDER_ADMIN

POST /api/v1/folders

cURL

cURL

curl --request POST \
  --url https://cockroachlabs.cloud/api/v1/folders \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "folder_name"
}
'

200

{
  "name": "<string>",
  "organization_id": "<string>",
  "parent_id": "<string>",
  "path": [
    {
      "id": "<string>",
      "name": "<string>"
    }
  ],
  "resource_id": "<string>"
}

{
  "code": 123,
  "details": [
    {
      "@type": "<string>"
    }
  ],
  "message": "<string>"
}

This endpoint is in Preview and subject to change. Refer to the API support policy for more details.

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

name · string · required

parent_id · string

The parent ID is a folder ID. An empty string or "root" will create a folder at the root level.

Response

200

application/json

A successful response.

FolderResource describes a resource, and includes info about its lineage (parent/ancestors).

name · string · required

name is the resource's name.

organization_id · string · required

organization_id is the id of the organization this resource belongs to.

parent_id · string · required

parent_id is the id of the resource's parent folder. "root" represents a root level resource.

path · object[] · required

path contains the ids and names of ancestors that make up the resource's lineage.

Show child attributes

resource_id · string · required

resource_id is the resource's id.

resource_type · enum<string> · required

Available options: FOLDER, CLUSTER