Package ai.vectros.resources.folders

Class AsyncFoldersClient

java.lang.Object
ai.vectros.resources.folders.AsyncFoldersClient
public class AsyncFoldersClient extends Object

  • Field Details

  • Constructor Details

    • AsyncFoldersClient

      public AsyncFoldersClient(ClientOptions clientOptions)

  • Method Details

    • withRawResponse

      public AsyncRawFoldersClient withRawResponse()
      Get responses with HTTP metadata like headers

    • listFolders

      public CompletableFuture<FolderPage> listFolders()
      Returns a paginated list of your folders. Pass parentFolderId to list the direct children of a specific folder (tree navigation); omit it for a flat list across your account. You can also filter by owner using userId, orgId, or clientId. Results are returned as a {data, nextCursor} envelope — pass nextCursor as startFrom to fetch the next page. Requires the folders:r scope.

    • listFolders

      public CompletableFuture<FolderPage> listFolders(RequestOptions requestOptions)
      Returns a paginated list of your folders. Pass parentFolderId to list the direct children of a specific folder (tree navigation); omit it for a flat list across your account. You can also filter by owner using userId, orgId, or clientId. Results are returned as a {data, nextCursor} envelope — pass nextCursor as startFrom to fetch the next page. Requires the folders:r scope.

    • listFolders

      public CompletableFuture<FolderPage> listFolders(ListFoldersRequest request)
      Returns a paginated list of your folders. Pass parentFolderId to list the direct children of a specific folder (tree navigation); omit it for a flat list across your account. You can also filter by owner using userId, orgId, or clientId. Results are returned as a {data, nextCursor} envelope — pass nextCursor as startFrom to fetch the next page. Requires the folders:r scope.

    • listFolders

      public CompletableFuture<FolderPage> listFolders(ListFoldersRequest request, RequestOptions requestOptions)
      Returns a paginated list of your folders. Pass parentFolderId to list the direct children of a specific folder (tree navigation); omit it for a flat list across your account. You can also filter by owner using userId, orgId, or clientId. Results are returned as a {data, nextCursor} envelope — pass nextCursor as startFrom to fetch the next page. Requires the folders:r scope.

    • createFolder

      public CompletableFuture<FolderResponse> createFolder(FolderRequest request)
      Creates a folder to organize your documents and records. If parentFolderId is omitted, the folder is created under your context's default root folder. Requires the folders:c scope.

    • createFolder

      public CompletableFuture<FolderResponse> createFolder(FolderRequest request, RequestOptions requestOptions)
      Creates a folder to organize your documents and records. If parentFolderId is omitted, the folder is created under your context's default root folder. Requires the folders:c scope.

    • getFolder

      public CompletableFuture<FolderResponse> getFolder(String id)
      Retrieves a single folder by its ID. Requires the folders:r scope.

    • getFolder

      public CompletableFuture<FolderResponse> getFolder(String id, RequestOptions requestOptions)
      Retrieves a single folder by its ID. Requires the folders:r scope.

    • getFolder

      public CompletableFuture<FolderResponse> getFolder(String id, GetFolderRequest request)
      Retrieves a single folder by its ID. Requires the folders:r scope.

    • getFolder

      public CompletableFuture<FolderResponse> getFolder(String id, GetFolderRequest request, RequestOptions requestOptions)
      Retrieves a single folder by its ID. Requires the folders:r scope.

    • updateFolder

      public CompletableFuture<FolderResponse> updateFolder(String id, UpdateFolderRequest request)
      Replaces a folder's name and description. Omitted fields are preserved (a null does not clear a field). The slug and parent folder are immutable and cannot be changed here. Requires the folders:u scope.

    • updateFolder

      public CompletableFuture<FolderResponse> updateFolder(String id, UpdateFolderRequest request, RequestOptions requestOptions)
      Replaces a folder's name and description. Omitted fields are preserved (a null does not clear a field). The slug and parent folder are immutable and cannot be changed here. Requires the folders:u scope.

    • deleteFolder

      public CompletableFuture<Void> deleteFolder(String id)
      Permanently deletes a folder. The folder must be empty (contain no documents or sub-folders) and must not be protected. Your context's root folder is protected and cannot be deleted. Requires the folders:d scope.

    • deleteFolder

      public CompletableFuture<Void> deleteFolder(String id, RequestOptions requestOptions)
      Permanently deletes a folder. The folder must be empty (contain no documents or sub-folders) and must not be protected. Your context's root folder is protected and cannot be deleted. Requires the folders:d scope.

    • deleteFolder

      public CompletableFuture<Void> deleteFolder(String id, DeleteFolderRequest request)
      Permanently deletes a folder. The folder must be empty (contain no documents or sub-folders) and must not be protected. Your context's root folder is protected and cannot be deleted. Requires the folders:d scope.

    • deleteFolder

      public CompletableFuture<Void> deleteFolder(String id, DeleteFolderRequest request, RequestOptions requestOptions)
      Permanently deletes a folder. The folder must be empty (contain no documents or sub-folders) and must not be protected. Your context's root folder is protected and cannot be deleted. Requires the folders:d scope.

    • patchFolder

      public CompletableFuture<FolderResponse> patchFolder(String id, PatchFolderRequest request)
      Partially updates a folder using an RFC 7386 JSON Merge Patch. The name, description, and ownership fields (userId, orgId, clientId) are applied when present and left unchanged when omitted; sending any of these as null is rejected, because clearing a field is not supported in this release (omit it instead). slug and parentFolderId are immutable — a folder cannot be re-slugged or moved via the API — and the request is rejected if either is present. Pass expectedVersion for optimistic concurrency (you get a 409 if the folder changed since you last read it). Requires the folders:u scope.

    • patchFolder

      public CompletableFuture<FolderResponse> patchFolder(String id, PatchFolderRequest request, RequestOptions requestOptions)
      Partially updates a folder using an RFC 7386 JSON Merge Patch. The name, description, and ownership fields (userId, orgId, clientId) are applied when present and left unchanged when omitted; sending any of these as null is rejected, because clearing a field is not supported in this release (omit it instead). slug and parentFolderId are immutable — a folder cannot be re-slugged or moved via the API — and the request is rejected if either is present. Pass expectedVersion for optimistic concurrency (you get a 409 if the folder changed since you last read it). Requires the folders:u scope.

    • getFolderVersions

      public CompletableFuture<ModelDataVersionPage> getFolderVersions(String id)
      Returns the audit trail of changes (create, update, and delete events) for a folder, newest first. Folder version history is always recorded; there is no setting to turn it off. Results are returned as a {data, nextCursor} envelope — pass nextCursor as startFrom to fetch the next page. Requires the folders:r scope.

    • getFolderVersions

      public CompletableFuture<ModelDataVersionPage> getFolderVersions(String id, RequestOptions requestOptions)
      Returns the audit trail of changes (create, update, and delete events) for a folder, newest first. Folder version history is always recorded; there is no setting to turn it off. Results are returned as a {data, nextCursor} envelope — pass nextCursor as startFrom to fetch the next page. Requires the folders:r scope.

    • getFolderVersions

      public CompletableFuture<ModelDataVersionPage> getFolderVersions(String id, GetFolderVersionsRequest request)
      Returns the audit trail of changes (create, update, and delete events) for a folder, newest first. Folder version history is always recorded; there is no setting to turn it off. Results are returned as a {data, nextCursor} envelope — pass nextCursor as startFrom to fetch the next page. Requires the folders:r scope.

    • getFolderVersions

      public CompletableFuture<ModelDataVersionPage> getFolderVersions(String id, GetFolderVersionsRequest request, RequestOptions requestOptions)
      Returns the audit trail of changes (create, update, and delete events) for a folder, newest first. Folder version history is always recorded; there is no setting to turn it off. Results are returned as a {data, nextCursor} envelope — pass nextCursor as startFrom to fetch the next page. Requires the folders:r scope.