Get folder info for a folder

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

• ORG_ADMIN
• CLUSTER_ADMIN
• CLUSTER_OPERATOR_WRITER
• CLUSTER_DEVELOPER
• CLUSTER_CREATOR
• FOLDER_ADMIN
• FOLDER_MOVER
• METRICS_VIEWER
• CLUSTER_MONITOR

GET /api/v1/folders/{folder_id}

cURL

cURL

curl --request GET \
  --url https://cockroachlabs.cloud/api/v1/folders/{folder_id} \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

200

{
  "labels": {},
  "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.

Path Parameters

folder_id · string · required

Response

200

application/json

A successful response.

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

labels · object · required

labels are key-value pairs used to organize and categorize resources.

Show child attributes

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