REST endpoint · GET All products

Get Folder

GET /v1/folders/:folderId

Updated May 30, 2026· 3 min read

Returns metadata for a single folder resource. Works identically across providers; provider-specific fields are nested under native.

Path parameters

Parameter		Description
`folderId` string	required	CloudFiles resource ID of the folder.

Query parameters

Parameter		Description
`fields` string	optional	Comma-separated projection, e.g. `id,name,path`.
`library` string	optional	Disambiguate when the same ID exists in two connected libraries (rare).

curl https://api.cloudfiles.io/v1/folders/01ABC \
  -H "Authorization: Bearer $CLOUDFILES_API_KEY"

const res = await fetch(
  'https://api.cloudfiles.io/v1/folders/01ABC',
  { headers: { Authorization: `Bearer ${KEY}` } }
);
const folder = await res.json();

import requests
r = requests.get(
  "https://api.cloudfiles.io/v1/folders/01ABC",
  headers={"Authorization": f"Bearer {KEY}"})
folder = r.json()

// In Salesforce, prefer the Apex client:
Resource r = Client.getResourceDetails('01ABC', null);

Response · 200

{
  "id": "01ABC",
  "type": "folder",
  "name": "Contracts",
  "path": "/Accounts/Acme Corp/Contracts",
  "library": "sharepoint_a8x2",
  "driveId": "b!xT9k",
  "parentId": "01AA0",
  "childCount": 14,
  "updatedAt": "2026-05-29T08:11:02Z",
  "native": { "webUrl": "https://acme.sharepoint.com/..." }
}

Errors

Status	Code	When
`401`	`unauthorized`	Missing or invalid API key.
`403`	`plan_required`	API access not in your plan — see the 403 guide.
`404`	`not_found`	Unknown folder ID, or resource is in an unregistered site.

Client.createFolders()