Package ai.vectros.types

Class RecordRequest.Builder

java.lang.Object
ai.vectros.types.RecordRequest.Builder
Enclosing class:
RecordRequest
public static final class RecordRequest.Builder extends Object

  • Method Details

    • from

      public RecordRequest.Builder from(RecordRequest other)

    • typeName

      public RecordRequest.Builder typeName(Optional<String> typeName)

      The record type, matching a schema's record type. Provide typeName or schemaId (at least one is required); when only schemaId is given, the type is resolved from the schema, and when both are given they must agree. Immutable after creation and ignored on update.

    • typeName

      public RecordRequest.Builder typeName(String typeName)

    • schemaId

      public RecordRequest.Builder schemaId(Optional<String> schemaId)

      Identifier of the schema to validate against. Optional: omit it and the server resolves the schema from typeName (record types are unique within your account and context); supply it (and omit typeName) to pin a schema and resolve the type from it. Provide typeName or schemaId (at least one); when both are given the server checks that they agree. Immutable after creation and ignored on update.

    • schemaId

      public RecordRequest.Builder schemaId(String schemaId)

    • payload

      public RecordRequest.Builder payload(Optional<Map<String,Object>> payload)

      The record's data payload — a JSON object whose structure is validated against the referenced schema. Fields the schema marks as searchable contribute to full-text and semantic search. On update, the supplied object replaces the stored payload in full (it is not key-merged); omit it to leave the payload unchanged.

    • payload

      public RecordRequest.Builder payload(Map<String,Object> payload)

    • status

      public RecordRequest.Builder status(Optional<String> status)

      Record lifecycle status. Defaults to ACTIVE. Use it to model soft-delete or workflow states without physically deleting records.

    • status

      public RecordRequest.Builder status(String status)

    • folderId

      public RecordRequest.Builder folderId(Optional<String> folderId)

      Identifier of the folder to group this record with related documents. On create, omit to leave the record ungrouped. On update, omit to leave it unchanged; once set, this field cannot be cleared.

    • folderId

      public RecordRequest.Builder folderId(String folderId)

    • userId

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

      Identifier of the owning user — the Vectros-assigned UUID of a user in your account. Optional, and may be set automatically from the calling token's identity. Use GET /v1/users?externalId= to resolve the UUID from your own identifier.

    • userId

      public RecordRequest.Builder userId(String userId)

    • orgId

      public RecordRequest.Builder orgId(Optional<String> orgId)

      Identifier of the owning organization — the Vectros-assigned UUID of an organization in your account. Optional, and may be set automatically from the calling token's identity. Use GET /v1/orgs?externalId= to resolve the UUID from your own identifier.

    • orgId

      public RecordRequest.Builder orgId(String orgId)

    • clientId

      public RecordRequest.Builder clientId(Optional<String> clientId)

      Identifier of the associated client — the Vectros-assigned UUID of a client in your account. Optional, and may be set automatically from the calling token's identity. Use GET /v1/clients?externalId= to resolve the UUID from your own identifier.

    • clientId

      public RecordRequest.Builder clientId(String clientId)

    • externalId

      public RecordRequest.Builder externalId(Optional<String> externalId)

      Your own stable identifier for this record. Optional, and immutable after create. Unique within your account, context, and record type: posting again with the same externalId returns the existing record (idempotent create), and it is the key other records reference. Maximum 256 characters.

    • externalId

      public RecordRequest.Builder externalId(String externalId)

    • indexMode

      public RecordRequest.Builder indexMode(Optional<RecordRequestIndexMode> indexMode)

      Per-record override of the search-index mode. HYBRID, SEMANTIC, and TEXT index this record for search; NONE is store-only (persisted, retrievable by id, and findable by structured-field lookup, but not searchable). Optional — omit it to inherit the schema's type-level default index mode (which itself defaults to NONE when the schema declares none). When both are set, this per-record value wins. Immutable after create.

    • indexMode

      public RecordRequest.Builder indexMode(RecordRequestIndexMode indexMode)

    • expectedVersion

      public RecordRequest.Builder expectedVersion(Optional<Long> expectedVersion)

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

    • expectedVersion

      public RecordRequest.Builder expectedVersion(Long expectedVersion)

    • build

      public RecordRequest build()

    • additionalProperty

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

    • additionalProperties

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