/v1/folders/listFolderContent
—
post
Path Parameters
Request Headers
HttpEndpointRequestHeaders_AuthRequired_JsonContentType

FieldTypeRequiredDescription
AuthorizationstringYes

Access token

Example: Bearer <token>

Content-TypestringYes

HTTP JSON request content type

Example: application/json

Request Query
Request Body
ListFolderContentEndpointParams

Parameters for listing the contents of a folder with optional filtering and pagination

{
folderpath?: string
folderId?: string
contentType?: string
page?: number
pageSize?: number
}
200 — Response Headers
HttpEndpointResponseHeaders_ContentType_ContentLength

FieldTypeRequiredDescription
Content-TypestringYes

HTTP JSON response content type

Example: application/json

Content-LengthstringYes

HTTP response content length in bytes

Example: 1024

200 — Response Body
ListFolderContentEndpointResult

Response containing the folder contents with folders and files arrays

{
folders: Array<Folder>
files: Array<File>
page: number
notes?: Array<EndpointResultNote>
}
Folder

Represents a folder in the workspace with its metadata and hierarchy information

{
resourceId: string
createdBy: Agent
createdAt: number
lastUpdatedBy: Agent
lastUpdatedAt: number
isDeleted: boolean
deletedAt?: number
deletedBy?: Agent
workspaceId: string
name: string
description?: string
idPath: Array<string>
namepath: Array<string>
parentId: string | null
}
Agent

Represents a user or system entity that performed an action (e.g., created or updated a resource)

{
agentId: string
agentType: string
}
File

File resource with metadata and location information

{
resourceId: string
createdBy: Agent
createdAt: number
lastUpdatedBy: Agent
lastUpdatedAt: number
isDeleted: boolean
deletedAt?: number
deletedBy?: Agent
workspaceId: string
size: number
ext?: string
parentId: string | null
idPath: Array<string>
namepath: Array<string>
mimetype?: string
encoding?: string
name: string
description?: string
version: number
}
EndpointResultNote

{
code: string
message: string
}
4XX or 5XX — Response Headers
HttpEndpointResponseHeaders_ContentType_ContentLength

FieldTypeRequiredDescription
Content-TypestringYes

HTTP JSON response content type

Example: application/json

Content-LengthstringYes

HTTP response content length in bytes

4XX or 5XX — Response Body
EndpointErrorResult

Endpoint error result

{
errors?: Array<ExternalError>
}
ExternalError

{
message: string
}