v1

latestOpenAPI 3.0.0Superhuman Developer Terms2026-08-06124404444.0 KB

Folders

Get folder

Returns the requested folder.

get/folders/{folderId}

Path parameters

folderIdstring required

ID of the folder.

Response

The requested Superhuman Docs folder.

idstring required

ID of the Superhuman Docs folder.

type'folder' required

The type of this resource.

namestring required

The name of the folder.

browserLinkstring url required

Browser-friendly link to the folder.

descriptionstring

The description of the folder.

createdAtstring date-time

Timestamp for when the folder was created.

canEditboolean

Whether the folder settings can be edited. E.g., some folder types (like personal folders - "My Docs") cannot be edited.

Example response

{
  "id": "fl-1Ab234",
  "name": "Projects",
  "browserLink": "https://docs.superhuman.com/folders/fl-1Ab234",
  "description": "A collection of project docs.",
  "icon": {
    "browserLink": "https://cdn.coda.io/icons/png/color/icon-32.png"
  },
  "createdAt": "2018-04-11T00:18:57.946Z",
  "canEdit": true,
  "workspace": {
    "id": "ws-1Ab234",
    "organizationId": "org-2Bc456",
    "browserLink": "https://docs.superhuman.com/docs?workspaceId=ws-1Ab234",
    "name": "My workspace"
  }
}