Package ai.vectros.types

Interface SchemaRequest._FinalStage

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

  • Method Details

    • build

      SchemaRequest build()

    • additionalProperty

      SchemaRequest._FinalStage additionalProperty(String key, Object value)

    • additionalProperties

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

    • description

      SchemaRequest._FinalStage description(Optional<String> description)

      Optional description of what this schema is for.

    • description

      SchemaRequest._FinalStage description(String description)

    • fields

      SchemaRequest._FinalStage fields(Optional<List<FieldDef>> fields)

      Field definitions used to validate record payloads. Omit for a bare schema that performs no payload validation.

    • fields

      SchemaRequest._FinalStage fields(List<FieldDef> fields)

    • lookupFields

      SchemaRequest._FinalStage lookupFields(Optional<List<LookupDef>> lookupFields)

      Payload fields to index for direct lookup queries. Maximum 10 lookup fields.

    • lookupFields

      SchemaRequest._FinalStage lookupFields(List<LookupDef> lookupFields)

    • renderHints

      SchemaRequest._FinalStage renderHints(Optional<Map<String,RenderHintDef>> renderHints)

      UI rendering hints keyed by field id.

    • renderHints

      SchemaRequest._FinalStage renderHints(Map<String,RenderHintDef> renderHints)

    • capabilities

      SchemaRequest._FinalStage capabilities(Optional<Map<String,Boolean>> capabilities)

      Feature flags for this schema. auditHistory (default true) controls whether a change-history (version) trail is kept for this type's data; setting it false stops recording the trail but never affects your record or document data itself. readAccessLog (default false; opt-in) controls accounting-of-disclosures logging: when true, each governed read of this schema's records writes a retained, subject-enumerable access record. The effective value resolves in order: this schema flag, then your context's default, then the platform default (false).

    • capabilities

      SchemaRequest._FinalStage capabilities(Map<String,Boolean> capabilities)

    • indexMode

      SchemaRequest._FinalStage indexMode(Optional<SchemaRequestIndexMode> indexMode)

      Default search-index mode for instances of this type — applies to records of this type and to documents bound to this schema, unless the individual record or document sets its own indexMode. HYBRID, SEMANTIC, and TEXT make content searchable; NONE is store-only (the data is persisted, retrievable, and usable for lookups, but not searchable). Omit for no default: a record with no indexMode of its own then defaults to NONE, and a document with no indexMode is rejected.

    • indexMode

      SchemaRequest._FinalStage indexMode(SchemaRequestIndexMode indexMode)

    • storageProfile

      SchemaRequest._FinalStage storageProfile(Optional<SchemaRequestStorageProfile> storageProfile)

      Where this type's payload is stored. STANDARD (default): payloads of 4 KB or larger are externalized to S3, smaller ones are stored inline. LOW_LATENCY: always store inline for the lowest read latency. LARGE_PAYLOAD: always externalize to S3, which lifts the 400 KB item-size ceiling. For externalized types, list and lookup responses return only the indexed projection unless you pass includePayload=true.

    • storageProfile

      SchemaRequest._FinalStage storageProfile(SchemaRequestStorageProfile storageProfile)

    • allowedSurfaces

      SchemaRequest._FinalStage allowedSurfaces(List<SchemaRequestAllowedSurfacesItem> allowedSurfaces)

      Which typed surfaces may bind this schema by its id: record, document, user, or entity. Required and must be non-empty. Identity entities in ANY namespace — org, client, or one you registered, such as team — bind under the single entity surface; use the schema's typeName to distinguish them, not the surface. A schema may list several surfaces (for a shared type usable on both records and documents). This drives surface-scoped schema listing (GET /v1/schemas?surface=) and is enforced at bind time — for example, a document cannot bind a record-only schema.

    • addAllowedSurfaces

      SchemaRequest._FinalStage addAllowedSurfaces(SchemaRequestAllowedSurfacesItem allowedSurfaces)

    • addAllAllowedSurfaces

      SchemaRequest._FinalStage addAllAllowedSurfaces(List<SchemaRequestAllowedSurfacesItem> allowedSurfaces)

    • active

      SchemaRequest._FinalStage active(Optional<Boolean> active)

      Whether this schema is active. An inactive schema rejects creation of new records of its type.

    • active

      SchemaRequest._FinalStage active(Boolean active)

    • userId

      SchemaRequest._FinalStage userId(Optional<String> userId)

      Owning user — the Vectros-assigned UUID of a user in your account. Optional; omit to create an account-wide shared schema. With an API key, this sets the schema's owner explicitly. With a scoped token, the user must match the token's identity claim (if set) or fall within the token's data scope.

    • userId

      SchemaRequest._FinalStage userId(String userId)

    • scopes

      SchemaRequest._FinalStage scopes(Optional<List<String>> scopes)

      The schema's scope ownership, as namespace:value entries (at most 2 namespaces) — for example ["org:6ba7b810-9dad-11d1-80b4-00c04fd430c8", "group:eng-team"]. org and client are built-in namespaces; others are custom scopes you define (lowercase, 2-32 chars). Resolve a namespace's UUID from your own identifier with GET /v1/entities/{namespace}?externalId=. Optional — omit for an account-wide shared schema. When supplied, this is the schema's COMPLETE scope declaration: for a token that stamps identity, entries must match the token's identity values. On update, omit to leave ownership unchanged, or supply the complete new selection ([] clears it). Filter lists by these values with ?scope=.

    • scopes

      SchemaRequest._FinalStage scopes(List<String> scopes)

    • basedOn

      SchemaRequest._FinalStage basedOn(Optional<String> basedOn)

      The id of an existing schema this one is a CUSTOMIZATION of, when a schema named typeName already exists in this context — required in that case (a same-named schema without it is rejected: "specify basedOn"), and must be omitted when this create is the FIRST schema under that name (it becomes that name's shared base, and must be created with no userId/scopes — a root/unscoped credential). Must point directly at the base (one hop); a variant of a variant is not yet supported. Immutable once set. Every same-named schema in a context is provably related through this chain — see the recordType-shadowing design doc.

    • basedOn

      SchemaRequest._FinalStage basedOn(String basedOn)