{
"opencollection": "1.0.0",
"info": {
"name": "Kiteworks API Documentation activities search API",
"version": "28"
},
"items": [
{
"info": {
"name": "search",
"type": "folder"
},
"items": [
{
"info": {
"name": "Return lists of files/folders/emails from search results",
"type": "http"
},
"http": {
"method": "GET",
"url": "{{baseUrl}}/rest/search",
"params": [
{
"name": "objectId",
"value": "",
"type": "query",
"description": "Id of folder to search"
},
{
"name": "content",
"value": "",
"type": "query",
"description": "Search by content"
},
{
"name": "content:contains",
"value": "",
"type": "query",
"description": "Search by content. Search for results that contain the specified characters in this parameter."
},
{
"name": "content:startswith",
"value": "",
"type": "query"
},
{
"name": "description",
"value": "",
"type": "query",
"description": "Search by description"
},
{
"name": "description:contains",
"value": "",
"type": "query",
"description": "Search by description. Search for results that contain the specified characters in this parameter."
},
{
"name": "description:startswith",
"value": "",
"type": "query"
},
{
"name": "user",
"value": "",
"type": "query",
"description": "Search by user"
},
{
"name": "modified",
"value": "",
"type": "query",
"description": "Search by modified date"
},
{
"name": "modified:gt",
"value": "",
"type": "query",
"description": "Search by modified date. Search for results where this parameter value is greater than the specified value."
},
{
"name": "modified:gte",
"value": "",
"type": "query",
"description": "Search by modified date. Search for results where this parameter value is greater than or equal to the specified value."
},
{
"name": "modified:lt",
"value": "",
"type": "query",
"description": "Search by modified date. Search for results where this parameter value is less than the specified value."
},
{
"name": "modified:lte",
"value": "",
"type": "query",
"description": "Search by modified date. Search for results where this parameter value is less than or equal to the specified value."
},
{
"name": "created",
"value": "",
"type": "query",
"description": "Search by created date"
},
{
"name": "created:gt",
"value": "",
"type": "query",
"description": "Search by created date. Search for results where this parameter value is greater than the specified value."
},
{
"name": "created:gte",
"value": "",
"type": "query",
"description": "Search by created date. Search for results where this parameter value is greater than or equal to the specified value."
},
{
"name": "created:lt",
"value": "",
"type": "query",
"description": "Search by created date. Search for results where this parameter value is less than the specified value."
},
{
"name": "created:lte",
"value": "",
"type": "query",
"description": "Search by created date. Search for results where this parameter value is less than or equal to the specified value."
},
{
"name": "locked",
"value": "",
"type": "query",
"description": "Search by lock status"
},
{
"name": "locked:gt",
"value": "",
"type": "query",
"description": "Search by lock status. Search for results where this parameter value is greater than the specified value."
},
{
"name": "locked:gte",
"value": "",
"type": "query",
"description": "Search by lock status. Search for results where this parameter value is greater than or equal to the specified value."
},
{
"name": "locked:lt",
"value": "",
"type": "query",
"description": "Search by lock status. Search for results where this parameter value is less than the specified value."
},
{
"name": "locked:lte",
"value": "",
"type": "query",
"description": "Search by lock status. Search for results where this parameter value is less than or equal to the specified value."
},
{
"name": "filesize",
"value": "",
"type": "query",
"description": "Search by file size"
},
{
"name": "filesize:gt",
"value": "",
"type": "query",
"description": "Search by file size. Search for results where this parameter value is greater than the specified value."
},
{
"name": "filesize:gte",
"value": "",
"type": "query",
"description": "Search by file size. Search for results where this parameter value is greater than or equal to the specified value."
},
{
"name": "filesize:lt",
"value": "",
"type": "query",
"description": "Search by file size. Search for results where this parameter value is less than the specified value."
},
{
"name": "filesize:lte",
"value": "",
"type": "query",
"description": "Search by file size. Search for results where this parameter value is less than or equal to the specified value."
},
{
"name": "file_type",
"value": "",
"type": "query",
"description": "Search by file type. Accepted values: `Documents`, `Spreadsheets`, `Presentations`, `Images`, `PDF`, `Multimedia`, `Text`."
},
{
"name": "email_type",
"value": "",
"type": "query",
"description": "Search by email type. Accepted values: `Inbox`, `Draft`, `Sent`."
},
{
"name": "tracking_id",
"value": "",
"type": "query",
"description": "Search files by tracking ID (UUID)"
},
{
"name": "tracking_id:eq",
"value": "",
"type": "query"
},
{
"name": "path",
"value": "",
"type": "query",
"description": "Search files/folders by path. If this is specified, other search criteria is no longer valid."
},
{
"name": "path:contains",
"value": "",
"type": "query",
"description": "Search files/folders by path. If this is specified, other search criteria is no longer valid.. Search for results that contain the specified characters in this parameter."
},
{
"name": "searchType",
"value": "",
"type": "query",
"description": "Search by object type. Accepted values: `f`, `d`, `m`, `k`."
},
{
"name": "searchFilter",
"value": "",
"type": "query",
"description": "Scope of the search. Accepted values: `all`, `shared`."
},
{
"name": "fls_only",
"value": "",
"type": "query",
"description": "Search only files shared to me."
},
{
"name": "sharedMailboxId",
"value": "",
"type": "query",
"description": "Id of shared mailbox to search"
},
{
"name": "orderBy",
"value": "",
"type": "query",
"description": "Sorting options"
},
{
"name": "offset",
"value": "",
"type": "query",
"description": "Offset"
},
{
"name": "limit",
"value": "",
"type": "query",
"description": "Limit"
},
{
"name": "with",
"value": "",
"type": "query",
"description": "With parameters"
},
{
"name": "mode",
"value": "",
"type": "query",
"description": "Determines the detail level of the response body."
}
]
},
"docs": "Searches across files, folders, and emails using the provided query. Returns matching results grouped by type, along with total counts and a flag indicating whether full-text search is enabled."
},
{
"info": {
"name": "Search SharePoint sites",
"type": "http"
},
"http": {
"method": "GET",
"url": "{{baseUrl}}/rest/sources/:id/query",
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The unique identifier of the entity."
},
{
"name": "include_kw",
"value": "",
"type": "query",
"description": "If true, includes Kiteworks native sources in the results."
},
{
"name": "include_container",
"value": "",
"type": "query",
"description": "If true, includes container-type sources (e.g. SharePoint document libraries) in the results."
},
{
"name": "limit",
"value": "",
"type": "query",
"description": "Maximum number of results to return."
},
{
"name": "offset",
"value": "",
"type": "query",
"description": "Number of results to skip before returning results, for pagination."
},
{
"name": "query",
"value": "",
"type": "query",
"description": "Search query string to filter sources or sites by name."
},
{
"name": "search_type",
"value": "",
"type": "query",
"description": "Type of search to perform against the source."
}
]
},
"docs": "### Description:\n Searches for SharePoint sites accessible through the specified source connection.\n### Precondition:\n User must have a valid SharePoint Online source connection configured.\n### Response:\n Returns a list of matching SharePoint sites.\n"
},
{
"info": {
"name": "Perform a search query",
"type": "http"
},
"http": {
"method": "GET",
"url": "{{baseUrl}}/rest/query",
"params": [
{
"name": "limit",
"value": "",
"type": "query",
"description": "Range limit."
},
{
"name": "offset",
"value": "",
"type": "query",
"description": "Range offset."
},
{
"name": "includeContent",
"value": "",
"type": "query",
"description": "Indicates whether it is a full-text search or a database search."
},
{
"name": "searchType",
"value": "",
"type": "query",
"description": "Comma-separated list of object types to search.
`f` – Files.
`d` – Folders.
`e` – Emails."
},
{
"name": "query",
"value": "",
"type": "query",
"description": "Search query string."
},
{
"name": "objectId",
"value": "",
"type": "query",
"description": "Search within a specific folder ID."
},
{
"name": "created",
"value": "",
"type": "query",
"description": "Exact creation date."
},
{
"name": "created:gt",
"value": "",
"type": "query",
"description": "Created after the specified date."
},
{
"name": "created:gte",
"value": "",
"type": "query",
"description": "Created on or after the specified date."
},
{
"name": "created:lt",
"value": "",
"type": "query",
"description": "Created before the specified date."
},
{
"name": "created:lte",
"value": "",
"type": "query",
"description": "Created on or before the specified date."
},
{
"name": "modified",
"value": "",
"type": "query",
"description": "Exact modified date."
},
{
"name": "modified:gt",
"value": "",
"type": "query",
"description": "Modified after the specified date."
},
{
"name": "modified:gte",
"value": "",
"type": "query",
"description": "Modified on or after the specified date."
},
{
"name": "modified:lt",
"value": "",
"type": "query",
"description": "Modified before the specified date."
},
{
"name": "modified:lte",
"value": "",
"type": "query",
"description": "Modified on or before the specified date."
},
{
"name": "fileSize",
"value": "",
"type": "query",
"description": "Exact file size in bytes."
},
{
"name": "fileSize:gt",
"value": "",
"type": "query",
"description": "File size greater than the specified value."
},
{
"name": "fileSize:gte",
"value": "",
"type": "query",
"description": "File size greater than or equal to the specified value."
},
{
"name": "fileSize:lt",
"value": "",
"type": "query",
"description": "File size less than the specified value."
},
{
"name": "fileSize:lte",
"value": "",
"type": "query",
"description": "File size less than or equal to the specified value."
},
{
"name": "user",
"value": "",
"type": "query",
"description": "User email of the folder creator."
},
{
"name": "fileType",
"value": "",
"type": "query",
"description": "List of comma-separated file types to filter search results."
},
{
"name": "flsOnly",
"value": "",
"type": "query",
"description": "If true, only includes files shared with the user."
},
{
"name": "sharedMailboxId",
"value": "",
"type": "query",
"description": "Shared mailbox ID."
},
{
"name": "orderBy",
"value": "",
"type": "query",
"description": "Field to sort results by.
Allowed values: `score`, `name`, `created`, `modified`."
},
{
"name": "orderType",
"value": "",
"type": "query",
"description": "Sort direction for the results.
`asc` – Ascending order.
`desc` – Descending order."
},
{
"name": "nameOnly",
"value": "",
"type": "query",
"description": "If true, searches only for file/folder names."
},
{
"name": "subject",
"value": "",
"type": "query",
"description": "Email subject filter."
},
{
"name": "senderId",
"value": "",
"type": "query",
"description": "Sender ID."
},
{
"name": "recipientId",
"value": "",
"type": "query",
"description": "Recipient ID."
},
{
"name": "fileName",
"value": "",
"type": "query",
"description": "File name filter."
},
{
"name": "folderName",
"value": "",
"type": "query",
"description": "Folder name filter."
},
{
"name": "fileContent",
"value": "",
"type": "query",
"description": "Search within file content."
},
{
"name": "spellCheck",
"value": "",
"type": "query",
"description": "If true, provides spelling suggestions for the search query."
},
{
"name": "bucket",
"value": "",
"type": "query",
"description": "Filter email search results by mailbox folder.
`inbox` – Search in the inbox.
`sent` – Search in sent items."
},
{
"name": "path",
"value": "",
"type": "query",
"description": "Search within a specific folder path."
},
{
"name": "tracking_id",
"value": "",
"type": "query",
"description": "Filter files by their tracking ID (UUID)."
},
{
"name": "extensions",
"value": "",
"type": "query",
"description": "Comma-separated file extensions to filter (e.g., \"pdf,form\" or \".pdf,.form\")."
}
]
},
"docs": "### Description:\n Searches for files, folders, or emails based on the provided query parameters.\n### Precondition:\n The user must be authenticated.\n### Response:\n Returns a list of matching files, folders, or emails.\n### Sorting:\n Sorting can be applied using two query parameters: `orderBy` for the field name,\n and `orderType` for the sort order, which can be either `asc` or `desc`.\n### Sorting options:\n | FIELD_NAME | Description |\n |------------|-------------|\n | score | The searc"
}
]
}
],
"bundled": true
}