Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Kiteworks folders API

The folders API from Kiteworks — 30 operation(s) for folders.

Kiteworks folders API is one of 41 APIs that Kiteworks publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include folders. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 39 operations across 30 paths, and defines 59 schemas. It is described by OpenAPI 3.0.2, at version 28.

Requests are made against the base URL https://your.kiteworks.domain/rest.

39 operations 30 paths 59 schemas 8 DELETE17 GET2 PATCH8 POST4 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.2
API Version
28
Base URL
https://your.kiteworks.domain/rest
Resource Areas
1

Paths & Operations 39

Across 30 paths, the API surfaces 39 operations — 8 DELETE, 17 GET, 2 PATCH, 8 POST, 4 PUT. Each is listed below with its method, path, parameters, and response codes.

folders 39
DELETE
/rest/folders
Delete a list of folders
3 params → 204490
POST
/rest/folders/actions/favorite
Set multiple folders as favorite
4 params → 200409490
DELETE
/rest/folders/actions/favorite
Removes specified folders from favorites
3 params → 204403490
DELETE
/rest/folders/actions/permanent
Permanently delete the specified folders
3 params → 204490
PATCH
/rest/folders/actions/recover
Recover deleted folders
4 params → 200490
POST
/rest/folders/actions/scan
Triggers on demand AV/DLP scan on multiple folders
4 params → 200490
GET
/rest/folders/shared
List top level shared folders
33 params → 200490
POST
/rest/folders/{id}/actions/move
Move a folder
4 params body → 201401403409413422490
DELETE
/rest/folders/{id}/actions/permanent
Permanently delete the specified folder
1 param → 204490
PATCH
/rest/folders/{id}/actions/recover
Recover deleted folder
3 params → 200490
POST
/rest/folders/{id}/actions/scan
Triggers on demand AV/DLP folder scan
6 params → 200403490
POST
/rest/folders/{id}/actions/sendMessage
Send message from a folder
1 param body → 201401403422490
GET
/rest/folders/{id}/comments
List comments for the folder
21 params → 200490
GET
/rest/folders/{id}/folders
List children folders of specified parent
34 params → 200403490
POST
/rest/folders/{id}/folders
Create a folder
4 params body → 201401403409490
POST
/rest/folders/{id}/members
Add members to a folder
7 params body → 201207401403409490
GET
/rest/folders/{id}/members
List folder members.
14 params → 200400401403422490
GET
/rest/folders/{id}/members/ldapGroup
List LDAP groups with access to a folder
10 params → 200490
GET
/rest/folders/{id}/members/ldapGroup/{ldap_group_id}
Return a specific LDAP group's access to a folder
4 params → 200490
PUT
/rest/folders/{id}/members/ldapGroup/{ldap_group_id}
Update folder LDAP group members
5 params body → 200403422490
DELETE
/rest/folders/{id}/members/ldapGroup/{ldap_group_id}
Delete a folder LDAP group member
3 params → 204401403422490
GET
/rest/folders/{id}/members/{member_user_id}
Return folder user member
4 params → 200490
PUT
/rest/folders/{id}/members/{member_user_id}
Update folder user members
5 params body → 200403422490
DELETE
/rest/folders/{id}/members/{member_user_id}
Delete a folder member
3 params → 204401403422490
GET
/rest/folders/{id}/tasks
Get tasks for a folder
30 params → 200490
GET
/rest/folders/{id}/tree
Get the ancestor path of a folder
3 params → 200403490
GET
/rest/folders/{parent}/files
Return the list of files in a folder
27 params → 200400401422490
GET
/rest/permissions/folder/{id}
List folder permissions
7 params → 200400401422490
POST
/rest/folders/actions/move
Move multiple folders
3 params body → 201207403490
GET
/rest/folders/{id}/quota
Return the folder quota
2 params → 200401403490
GET
/rest/folders/{id}/children
List folder children
12 params → 200400401422490
GET
/rest/folders/top
List top level folders
6 params → 200400401422490
PUT
/rest/folders/{id}
Update a folder
4 params body → 200401403409490
GET
/rest/folders/{id}
Return the folder
4 params → 200400401403490
DELETE
/rest/folders/{id}
Delete a folder
1 param → 204401403490
GET
/rest/folders/{id}/activities
Return folder activities
17 params → 200401422490
GET
/rest/folders/{id}/activities/actions/exportCSV
Export folder activities
17 params → 200401422490
DELETE
/rest/folders/{id}/members/me
Remove oneself as a folder member
2 params → 204401403422490
PUT
/rest/admin/folders
Bulk update folders
3 params body → 200401403422490

Schemas 59

The contract defines 59 schemas that model the data the API accepts and returns. The most detailed are File (46 properties), Mail (45 properties), Folder1 (44 properties), Folder (43 properties). Each schema is shown below with its type and property counts.

BulkOperationMoveFolders
object
3 properties
Requirement
object
22 properties
Errors
object
1 property
FolderFileAddMembers
object
3 properties
PushedObject
object
4 properties
Tag
object
3 properties
TrackingAccessRecipient
object
6 properties
Member.Put
object
Class Member
4 properties 1 required
MemberGroup.Put
object
Class MemberGroup
3 properties 1 required
Folder1
object
44 properties
MetaData
object
3 properties
UserBasic
object
4 properties
Attachment
object
19 properties
FolderPermissions
object
1 property
UserMetadata
object
Class UserMetadata
2 properties
Task
object
Class Task
17 properties 6 required
Mail
object
45 properties
Recipient
object
5 properties
FolderChildrenFiles
object
2 properties
FolderUpdatePutRequest
object
14 properties
ErrorStringSchemaAccessVerifications
object
6 properties
FolderSendMessageRequest
object
6 properties 1 required
DestinationFolderIdRequest
object
2 properties 1 required
Members
object
2 properties
Permission
object
3 properties
UserBasicInfo
object
4 properties 3 required
Favorite
object
Class Favorite
6 properties 3 required
Folder
object
43 properties
Error
object
2 properties
ActivityUser
object
4 properties
MemberGroup
object
Class MemberGroup
9 properties 3 required
Role
object
4 properties
File
object
46 properties
DrmFile
object
2 properties
FolderMemberPostRequest
object
6 properties 1 required
LdapGroup
object
Class LdapGroup
5 properties 2 required
RiskPolicy
object
20 properties
MobileInfo
object
5 properties
Fingerprint
object
2 properties
FolderQuota
object
6 properties
FoldersMetaData
object
5 properties
User
object
Class User
22 properties 6 required
ErrorString
object
4 properties
ActivityList
object
1 property
MultipleFolderIdRequest
object
2 properties 2 required
EmailReturnRecipient
object
2 properties
Folders
object
2 properties
Member
object
14 properties
FolderTreeItem
object
Represents a single node in a folder's ancestor chain, from root down to the target folder.
2 properties
AdminFolderPutRequest
object
5 properties 1 required
FolderCreatePostRequest
object
14 properties 1 required
SafeEdit
object
2 properties
Package
object
9 properties
Activity
object
9 properties
Variables
object
2 properties
Group
object
5 properties
BaseObject
object
Class Object
17 properties 4 required
AccessVerificationApproval
object
20 properties
Comment
object
Class Comment
15 properties 5 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

kiteworks-folders-api-openapi.yml Raw ↑

Other APIs Kiteworks publishes across the network.

Kiteworks activities API
Kiteworks admin API
Kiteworks adminRoles API
Kiteworks advancedForms API
Kiteworks cards API
Kiteworks clientEventLogs API
Kiteworks clients API
Kiteworks comments API
Kiteworks contacts API
Kiteworks devices API
Kiteworks dli API
Kiteworks externalDL API