Package ai.vectros.resources.documents.requests

Class FileUploadRequest

java.lang.Object
ai.vectros.resources.documents.requests.FileUploadRequest
public final class FileUploadRequest extends Object

  • Method Details

    • getUpsert

      public Optional<Boolean> getUpsert()
      Returns:
      When true and a document with the same externalId already exists, apply the submitted payload/title to that existing document (a metadata upsert) before re-issuing the presigned URL. The file body is replaced inherently by the re-upload; it cannot be diffed at upload-init. Defaults to false. Requires the documents:u scope in addition to documents:c.

    • getFileName

      public String getFileName()
      Returns:
      Original file name, including its extension. Used as the document title when no separate title is provided.

    • getFileType

      public String getFileType()
      Returns:
      MIME type of the file being uploaded. Used to set the correct Content-Type on the stored object.

    • getIndexMode

      public Optional<FileUploadRequestIndexMode> getIndexMode()
      Returns:
      Indexing strategy applied after the file is processed and its text is extracted. HYBRID runs both BM25 keyword and dense-vector semantic indexing (recommended). SEMANTIC indexes only as dense vectors. TEXT indexes only with BM25. NONE is store-only (archival): the file is still uploaded and its text extracted, but it is not search-indexed — retrievable by id/download and structured-field lookup only. Optional: omit to inherit the bound schema's default index mode. If neither this field nor the schema specifies one, the request is rejected. When both are set, this per-file value wins.

    • getFolderId

      public Optional<String> getFolderId()
      Returns:
      ID of the folder in which to place this document. Omit to use your account's default root folder.

    • getPayload

      public Optional<Map<String,Object>> getPayload()
      Returns:
      The document's structured data, as a flat key/value object. When schemaId is set, declared fields are validated against the schema and its lookup fields become directly queryable (matching record and text-ingest behavior); undeclared keys pass through as free-form and are searchable via the filters parameter on POST /v1/search.

    • getSchemaId

      public Optional<String> getSchemaId()
      Returns:
      Optional ID of a record schema to bind this document to. When set, the document's payload is validated against the schema and its lookup fields become directly queryable (matching record and text-ingest behavior).

    • getUserId

      public Optional<String> getUserId()
      Returns:
      Owning user ID — the Vectros-assigned UUID of a user in your account. Optional. With an API key, sets the document's owner explicitly. With a scoped token, must match the token's identity claim (if set) or fall within its data scope.

    • getOrgId

      public Optional<String> getOrgId()
      Returns:
      Owning organization ID — the Vectros-assigned UUID of an organization in your account. Optional. With an API key, sets the document's owning organization explicitly. With a scoped token, must match the token's identity claim (if set) or fall within its data scope.

    • getClientId

      public Optional<String> getClientId()
      Returns:
      Associated client ID — the Vectros-assigned UUID of a client in your account. Optional. With an API key, sets the document's client explicitly. With a scoped token, must match the token's identity claim (if set) or fall within its data scope.

    • getExternalId

      public Optional<String> getExternalId()
      Returns:
      Stable, caller-supplied identifier for this document. Optional. Immutable after create. Unique within your account and context: initiating an upload again with the same externalId returns the same document plus a fresh presigned URL (idempotent — no duplicate), and it is the key other records use to reference this one. Max 256 characters.

    • 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 FileUploadRequest.FileNameStage builder()