Package ai.vectros.types

Interface DocumentRequest._FinalStage

All Known Implementing Classes:
DocumentRequest.Builder
Enclosing class:
DocumentRequest
public static interface DocumentRequest._FinalStage

  • Method Details

    • build

      DocumentRequest build()

    • additionalProperty

      DocumentRequest._FinalStage additionalProperty(String key, Object value)

    • additionalProperties

      DocumentRequest._FinalStage additionalProperties(Map<String,Object> additionalProperties)

    • text

      DocumentRequest._FinalStage text(Optional<String> text)

      Raw text content to ingest. Required when creating a document via the text-ingest path. On update, supply it to replace the stored text; omit it to leave the existing text unchanged.

    • text

      DocumentRequest._FinalStage text(String text)

    • indexMode

      DocumentRequest._FinalStage indexMode(Optional<DocumentRequestIndexMode> indexMode)

      Indexing strategy for this document. HYBRID runs both BM25 keyword and dense-vector semantic indexing (recommended for most use cases). SEMANTIC indexes only as dense vectors — best for conceptual similarity search. TEXT indexes only with BM25 — best for exact keyword matching. NONE stores the document without search indexing (store-only / archival): it remains retrievable by id and by structured-field lookup but never appears in search results. 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-document value wins.

    • indexMode

      DocumentRequest._FinalStage indexMode(DocumentRequestIndexMode indexMode)

    • storeText

      DocumentRequest._FinalStage storeText(Optional<Boolean> storeText)

      If true, the raw text is retained so you can later fetch it via GET /v1/documents/{id}/text. Defaults to false to minimize storage costs.

    • storeText

      DocumentRequest._FinalStage storeText(Boolean storeText)

    • folderId

      DocumentRequest._FinalStage folderId(Optional<String> folderId)

      ID of the folder to place this document in. On create, omit to use your account's default root folder. On update, omit to leave unchanged — this field cannot currently be cleared once set.

    • folderId

      DocumentRequest._FinalStage folderId(String folderId)

    • payload

      DocumentRequest._FinalStage payload(Optional<Map<String,Object>> payload)

      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 via GET /v1/documents?type=&field=&value= (sensitive fields are blind-indexed); undeclared keys pass through as free-form and are searchable via the filters parameter on POST /v1/search. A strict schema rejects undeclared keys. On update, the supplied object replaces the stored payload in full (it is not key-merged); omit to leave it unchanged.

    • payload

      DocumentRequest._FinalStage payload(Map<String,Object> payload)

    • schemaId

      DocumentRequest._FinalStage schemaId(Optional<String> schemaId)

      Optional ID of a record schema to bind this document to. When set, the document's payload is validated against the schema's fields on save, and the schema's lookup fields become directly queryable (the same behavior as records). On update, omit to leave unchanged.

    • schemaId

      DocumentRequest._FinalStage schemaId(String schemaId)

    • userId

      DocumentRequest._FinalStage userId(Optional<String> userId)

      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.

    • userId

      DocumentRequest._FinalStage userId(String userId)

    • orgId

      DocumentRequest._FinalStage orgId(Optional<String> orgId)

      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.

    • orgId

      DocumentRequest._FinalStage orgId(String orgId)

    • clientId

      DocumentRequest._FinalStage clientId(Optional<String> clientId)

      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.

    • clientId

      DocumentRequest._FinalStage clientId(String clientId)

    • externalId

      DocumentRequest._FinalStage externalId(Optional<String> externalId)

      Stable, caller-supplied identifier for this document. Optional. Immutable after create. Unique within your account and context: posting again with the same externalId returns the existing document (idempotent ingest), and it is the key other records use to reference this one. Max 256 characters.

    • externalId

      DocumentRequest._FinalStage externalId(String externalId)

    • expectedVersion

      DocumentRequest._FinalStage expectedVersion(Optional<Long> expectedVersion)

      Optimistic-concurrency token. Pass the version you last read (from a GET or a prior write response) to make this update conditional — it is rejected with 409 VERSION_CONFLICT if the document was modified since, leaving the stored document untouched. Omit for last-write-wins (the default). Ignored on create.

    • expectedVersion

      DocumentRequest._FinalStage expectedVersion(Long expectedVersion)