Class FolderRequest

java.lang.Object
ai.vectros.types.FolderRequest

public final class FolderRequest extends Object
  • Method Details

    • getName

      public String getName()
      Returns:
      Human-readable display name of the folder. Required.
    • getDescription

      public Optional<String> getDescription()
      Returns:
      Optional description of the folder's contents or purpose.
    • getParentFolderId

      public Optional<String> getParentFolderId()
      Returns:
      ID of the parent folder to create this folder under, applied at creation only. Omit to create the folder under your context's default root folder. Ignored on update: a folder cannot currently be moved via the API.
    • getSlug

      public Optional<String> getSlug()
      Returns:
      Optional stable slug for the folder, unique among its siblings under the same parent. Useful as an idempotency key so re-creating the same folder returns the existing one rather than a duplicate. Derived from the name when omitted. Must be lowercase letters, digits, and hyphens. Immutable once the folder is created.
    • getUserId

      public Optional<String> getUserId()
      Returns:
      Optional ID of the user that should own this folder — the Vectros-assigned UUID of a user in your account. With an API key, this sets the folder's owner directly. With a scoped token, it must match the token's identity claim (if one is set) or fall within the token's data scope.
    • getOrgId

      public Optional<String> getOrgId()
      Returns:
      Optional ID of the organization that should own this folder — the Vectros-assigned UUID of an organization in your account. With an API key, this sets the owning organization directly. With a scoped token, it must match the token's identity claim (if one is set) or fall within the token's data scope.
    • getClientId

      public Optional<String> getClientId()
      Returns:
      Optional ID of the client to associate with this folder — the Vectros-assigned UUID of a client in your account. With an API key, this sets the client directly. With a scoped token, it must match the token's identity claim (if one is set) or fall within the token's data scope.
    • getExpectedVersion

      public Optional<Long> getExpectedVersion()
      Returns:
      Optimistic-concurrency token for updates. Pass the version you last read to make the update conditional — it is rejected with a 409 version conflict (and the stored folder is left untouched) if the folder changed since. Omit for last-write-wins (the default). Ignored on create.
    • equals

      public boolean equals(Object other)
      Overrides:
      equals in class Object
    • getAdditionalProperties

      public Map<String,Object> getAdditionalProperties()
    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object
    • toString

      public String toString()
      Overrides:
      toString in class Object
    • builder

      public static FolderRequest.NameStage builder()