Get folders
Get Folders
This endpoint retrieves a list of folders based on pagination and sorting criteria.
Request Parameters
-
page (integer, required): The page number to retrieve. This parameter is used for pagination.
-
pageSize (integer, required): The number of folders to return per page. This parameter controls the size of the result set.
-
sortBy (string, required): The field by which to sort the folders. In this case, it is sorted by createdAt.
Response Format
The response will contain the following structure:
-
status (string): The status of the request.
-
data (object): Contains the details of the folders retrieved.
-
totalCount (integer): The total number of folders available.
-
pages (integer or null): The total number of pages available based on the pagination.
-
folders (array): An array of folder objects, each containing:
-
_id (string): The unique identifier for the folder.
-
defaultAssignTo (string): The default user assigned to the folder.
-
showOrder (integer): The order in which the folder should be displayed.
-
name (string): The name of the folder.
-
folderId (string): The identifier for the folder.
-
createdAt (string): The creation date of the folder.
-
updatedAt (string): The last updated date of the folder.
-
user (object): An object representing the user associated with the folder.
-
_id (string): The unique identifier for the user.
-
firstName (string): The first name of the user.
-
lastName (string): The last name of the user.
-
userId (string): The identifier for the user associated with the folder.
Notes
-
Ensure that the page and pageSize parameters are set correctly to retrieve the desired set of folders.
-
The response may return an empty array if no folders are available for the specified page and size.
Request
- Base URL: https://api.speakai.co/v1
- URL: https://api.speakai.co/v1/folder
- Auth: API key in header x-speakai-key and API key in header x-access-token
Query parameters
You can pass in the dateFormat
You can pass in the dateFormat
Response
OK
Changes
No recorded changes to this operation across all 2 revisions of this API.