Folders

Folders within a workspace.

On this page

getList folders/workspaces/{workspaceId}/folders
postCreate folder/workspaces/{workspaceId}/folders
deleteDelete folder/workspaces/{workspaceId}/folders/{id}
getGet folder/workspaces/{workspaceId}/folders/{id}
patchUpdate folder/workspaces/{workspaceId}/folders/{id}

List folders

Lists folders in the workspace tree.

Technical details

Exact HTTP method and path your client calls

get/workspaces/{workspaceId}/folders

Path parameters

Name	Type	Required	Description
workspaceId	string	required

Headers

Name	Type	Required	Description
X-Workspace-ID	string	optional	Target workspace when the API key is tenant-wide or to disambiguate scope.

Responses

List folders

Field	Type	Description
	Folder[]
	object

Example

[
  {
    "id": "string",
    "tenantId": "string",
    "workspaceId": "string",
    "name": "string",
    "parentId": "string",
    "createdAt": "2026-01-01T00:00:00.000Z",
    "updatedAt": "2026-01-01T00:00:00.000Z"
  }
]

Errors return the standard envelope. See error reference.

Code samples

curl --request GET \
  --url 'https://api.not24get.me/workspaces/%3AworkspaceId/folders' \
  --header 'Authorization: Bearer <your-api-key>' \
  --header 'Content-Type: application/json' \
  --header 'X-Workspace-ID: <workspace-id>'

Try it

Path parameters

workspaceId*

Headers

X-Workspace-ID

This endpoint requires a workspace ID. Set one in the API key dialog.

Create folder

Creates a folder under the workspace root or a parent folder.

Technical details

Exact HTTP method and path your client calls

post/workspaces/{workspaceId}/folders

Path parameters

Name	Type	Required	Description
workspaceId	string	required

Headers

Name	Type	Required	Description
X-Workspace-ID	string	optional	Target workspace when the API key is tenant-wide or to disambiguate scope.

Request body

Field	Type	Description
namerequired	string
parentId	string

Responses

Create folder

Field	Type	Description
id	string
tenantId	string
workspaceId	string
name	string
parentId	string
createdAt	string<date-time> · date-time
updatedAt	string<date-time> · date-time

Example

{
  "id": "string",
  "tenantId": "string",
  "workspaceId": "string",
  "name": "string",
  "parentId": "string",
  "createdAt": "2026-01-01T00:00:00.000Z",
  "updatedAt": "2026-01-01T00:00:00.000Z"
}

Errors return the standard envelope. See error reference.

Code samples

curl --request POST \
  --url 'https://api.not24get.me/workspaces/%3AworkspaceId/folders' \
  --header 'Authorization: Bearer <your-api-key>' \
  --header 'Content-Type: application/json' \
  --header 'X-Workspace-ID: <workspace-id>' \
  --data '{
  "name": "string",
  "parentId": "string"
}'

Try it

Path parameters

workspaceId*

Headers

X-Workspace-ID

Request body (JSON)

This endpoint requires a workspace ID. Set one in the API key dialog.

Delete folder

Deletes a folder and optionally its contents. Returns no body on success.

Technical details

Exact HTTP method and path your client calls

delete/workspaces/{workspaceId}/folders/{id}

Path parameters

Name	Type	Required	Description
workspaceId	string	required
id	string	required

Headers

Name	Type	Required	Description
X-Workspace-ID	string	optional	Target workspace when the API key is tenant-wide or to disambiguate scope.

Responses

No Content

Field	Type	Description
(value)	EmptyResponsePart

Example

null

Errors return the standard envelope. See error reference.

Code samples

curl --request DELETE \
  --url 'https://api.not24get.me/workspaces/%3AworkspaceId/folders/%3Aid' \
  --header 'Authorization: Bearer <your-api-key>' \
  --header 'Content-Type: application/json' \
  --header 'X-Workspace-ID: <workspace-id>'

Try it

Path parameters

workspaceId*id*

Headers

X-Workspace-ID

This endpoint requires a workspace ID. Set one in the API key dialog.

Get folder

Returns folder metadata by id.

Technical details

Exact HTTP method and path your client calls

get/workspaces/{workspaceId}/folders/{id}

Path parameters

Name	Type	Required	Description
workspaceId	string	required
id	string	required

Headers

Name	Type	Required	Description
X-Workspace-ID	string	optional	Target workspace when the API key is tenant-wide or to disambiguate scope.

Responses

Get folder

Field	Type	Description
id	string
tenantId	string
workspaceId	string
name	string
parentId	string
createdAt	string<date-time> · date-time
updatedAt	string<date-time> · date-time

Example

{
  "id": "string",
  "tenantId": "string",
  "workspaceId": "string",
  "name": "string",
  "parentId": "string",
  "createdAt": "2026-01-01T00:00:00.000Z",
  "updatedAt": "2026-01-01T00:00:00.000Z"
}

Errors return the standard envelope. See error reference.

Code samples

curl --request GET \
  --url 'https://api.not24get.me/workspaces/%3AworkspaceId/folders/%3Aid' \
  --header 'Authorization: Bearer <your-api-key>' \
  --header 'Content-Type: application/json' \
  --header 'X-Workspace-ID: <workspace-id>'

Try it

Path parameters

workspaceId*id*

Headers

X-Workspace-ID

This endpoint requires a workspace ID. Set one in the API key dialog.

Update folder

Renames a folder or moves it within the tree.

Technical details

Exact HTTP method and path your client calls

patch/workspaces/{workspaceId}/folders/{id}

Path parameters

Name	Type	Required	Description
workspaceId	string	required
id	string	required

Headers

Name	Type	Required	Description
X-Workspace-ID	string	optional	Target workspace when the API key is tenant-wide or to disambiguate scope.

Request body

Field	Type	Description
name	string
parentId	string

Responses

Update folder

Field	Type	Description
id	string
tenantId	string
workspaceId	string
name	string
parentId	string
createdAt	string<date-time> · date-time
updatedAt	string<date-time> · date-time

Example

{
  "id": "string",
  "tenantId": "string",
  "workspaceId": "string",
  "name": "string",
  "parentId": "string",
  "createdAt": "2026-01-01T00:00:00.000Z",
  "updatedAt": "2026-01-01T00:00:00.000Z"
}

Errors return the standard envelope. See error reference.

Code samples

curl --request PATCH \
  --url 'https://api.not24get.me/workspaces/%3AworkspaceId/folders/%3Aid' \
  --header 'Authorization: Bearer <your-api-key>' \
  --header 'Content-Type: application/json' \
  --header 'X-Workspace-ID: <workspace-id>' \
  --data '{
  "name": "string",
  "parentId": "string"
}'

Try it

Path parameters

workspaceId*id*

Headers

X-Workspace-ID

Request body (JSON)

This endpoint requires a workspace ID. Set one in the API key dialog.