Package ai.vectros.resources.schemas.requests

Class ListSchemasRequest.Builder

java.lang.Object
ai.vectros.resources.schemas.requests.ListSchemasRequest.Builder
Enclosing class:
ListSchemasRequest
public static final class ListSchemasRequest.Builder extends Object

  • Method Details

    • from

      public ListSchemasRequest.Builder from(ListSchemasRequest other)

    • userId

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

      Filter to schemas owned by this user — the Vectros-assigned UUID of a user in your account. Use GET /v1/users?externalId= to resolve a UUID from your own external id.

    • userId

      public ListSchemasRequest.Builder userId(String userId)

    • scope

      public ListSchemasRequest.Builder scope(Optional<String> scope)

      Filter to schemas carrying this scope value, as a single namespace:value entry — for example org:6ba7b810-9dad-11d1-80b4-00c04fd430c8 or group:eng-team. org and client are built-in namespaces; others are custom scopes you define. Resolve a namespace's UUID from your own identifier with GET /v1/entities/{namespace}?externalId=.

    • scope

      public ListSchemasRequest.Builder scope(String scope)

    • surface

      public ListSchemasRequest.Builder surface(Optional<String> surface)

      Filter to schemas bindable to this surface: record, document, user, or entity — identity entities in any namespace (org, client, or one you registered) bind under the single entity surface. Returns only schemas whose allowed surfaces include the given one — useful for listing, say, document types separately from record types. The identity surfaces (user, entity) are account-wide: filtering by one lists your account's identity schemas regardless of the calling context, whereas record and document list within the calling context.

    • surface

      public ListSchemasRequest.Builder surface(String surface)

    • recordType

      public ListSchemasRequest.Builder recordType(Optional<String> recordType)

      Resolve the single schema for this record type — the natural handle for a schema, and the direct alternative to remembering its opaque id. Returns a one-element page, or an empty page if no such schema exists. Resolved in the calling context for record and document types; combine with surface=user or surface=entity to resolve an account-wide identity schema. Takes precedence over userId; a scope filter still applies, so a resolved schema outside that scope returns an empty page. A type name is unique per owner, not per context — if more than one owner in this context has defined a schema with this name, the request fails with 400 AMBIGUOUS_RECORD_TYPE instead of guessing; resolve by id instead, or add userId/scope to narrow to one owner first.

    • recordType

      public ListSchemasRequest.Builder recordType(String recordType)

    • startFrom

      public ListSchemasRequest.Builder startFrom(Optional<String> startFrom)

      Pagination cursor. Pass the nextCursor from the previous page to fetch the next page; omit it for the first page.

    • startFrom

      public ListSchemasRequest.Builder startFrom(String startFrom)

    • limit

      public ListSchemasRequest.Builder limit(Optional<Long> limit)

      Maximum number of schemas to return per page (1–100; defaults to 20).

    • limit

      public ListSchemasRequest.Builder limit(Long limit)

    • build

      public ListSchemasRequest build()

    • additionalProperty

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

    • additionalProperties

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