Package ai.vectros.resources.folders.requests

Class ListFoldersRequest.Builder

java.lang.Object

ai.vectros.resources.folders.requests.ListFoldersRequest.Builder

Enclosing class:

ListFoldersRequest

public static final class ListFoldersRequest.Builder
extends Object

Method Summary

Modifier and Type	Method	Description
ListFoldersRequest.Builder	additionalProperties(Map<String,Object> additionalProperties)
ListFoldersRequest.Builder	additionalProperty(String key, Object value)
ListFoldersRequest	build()
ListFoldersRequest.Builder	from(ListFoldersRequest other)
ListFoldersRequest.Builder	limit(Long limit)
ListFoldersRequest.Builder	limit(Optional<Long> limit)	Maximum number of folders to return per page.
ListFoldersRequest.Builder	parentFolderId(String parentFolderId)
ListFoldersRequest.Builder	parentFolderId(Optional<String> parentFolderId)	List only the direct children of this folder — the Vectros-assigned UUID of a folder — for tree navigation.
ListFoldersRequest.Builder	scope(String scope)
ListFoldersRequest.Builder	scope(Optional<String> scope)	Filter to folders carrying this scope value, in namespace:value form (a value is 1-128 chars: a letter or digit first, then letters, digits, _ or -) — for example group:eng-team, org:<id>, or client:<id>.
ListFoldersRequest.Builder	startFrom(String startFrom)
ListFoldersRequest.Builder	startFrom(Optional<String> startFrom)	Pagination cursor.
ListFoldersRequest.Builder	userId(String userId)
ListFoldersRequest.Builder	userId(Optional<String> userId)	Filter to folders owned by this user — the Vectros-assigned UUID of a user.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

from

public ListFoldersRequest.Builder from(ListFoldersRequest other)

parentFolderId

public ListFoldersRequest.Builder parentFolderId(Optional<String> parentFolderId)

List only the direct children of this folder — the Vectros-assigned UUID of a folder — for tree navigation. Omit for a flat list across your account.

parentFolderId

public ListFoldersRequest.Builder parentFolderId(String parentFolderId)

userId

public ListFoldersRequest.Builder userId(Optional<String> userId)

Filter to folders owned by this user — the Vectros-assigned UUID of a user. Use GET /v1/users?externalId= to resolve your own external ID to this UUID.

userId

public ListFoldersRequest.Builder userId(String userId)

scope

public ListFoldersRequest.Builder scope(Optional<String> scope)

Filter to folders carrying this scope value, in namespace:value form (a value is 1-128 chars: a letter or digit first, then letters, digits, _ or -) — for example group:eng-team, org:<id>, or client:<id>. Resolve an entity's UUID from your own identifier via GET /v1/entities/{namespace}?externalId=.

scope

public ListFoldersRequest.Builder scope(String scope)

startFrom

public ListFoldersRequest.Builder startFrom(Optional<String> startFrom)

Pagination cursor. Pass the nextCursor returned by the previous page to fetch the next page; omit it for the first page. The cursor is opaque — echo it back unchanged, and do not parse it or construct one. Keep every other query parameter identical while paging: a cursor is valid only for the exact query that returned it, and reusing one against a different query is rejected with a 400.

startFrom

public ListFoldersRequest.Builder startFrom(String startFrom)

limit

public ListFoldersRequest.Builder limit(Optional<Long> limit)

Maximum number of folders to return per page. Must be between 1 and 100; defaults to 20.

limit

public ListFoldersRequest.Builder limit(Long limit)

build

public ListFoldersRequest build()

additionalProperty

public ListFoldersRequest.Builder additionalProperty(String key,
 Object value)

additionalProperties

public ListFoldersRequest.Builder additionalProperties(Map<String,Object> additionalProperties)