Preview

customerUnifiedListByMarketplaceTenant is in Preview status and is subject to change without notice. For more information about Preview status, see the GraphQL API policy.

customerUnifiedListByMarketplaceTenant

Cursor-paged list of unified customers in a marketplace tenant. Returned rows span every advisor in the marketplace (the warehouse marketplace_tenant column on gold.party drives the filter). Authorized for ROLE_CHANNEL_ADMIN only — the marketplace-manager (channel) persona. The marketplaceTenant argument MUST match the caller's JWT tenant claim.

This page contains

    Authorization Rules

    This request requires authorization with at least one of the following scopes:

    Scopes

    ROLE_CHANNEL_ADMIN

    Arguments

    marketplaceTenant ID!

    Marketplace tenant from the caller's JWT (e.g. "APPSMART").

    first Int

    Maximum rows to return.

    after String

    Opaque cursor from a previous response; omit for the first page.

    sort String

    Sort specification, e.g. name,asc. Default: name,asc. Unrecognized field names fall back to name,asc silently (same behavior as the advisor sibling).

    sourceSystem String

    Filter rows whose sourceSystems list contains the given lineage source system. Match-any across the canonical row and every absorbed party via gold.party_aliases.

    sourceSystems [String!]

    Match-any filter on lineage source system. A row matches when the canonical party or any party it absorbed reports at least one of the given source systems. Empty or omitted applies no source-system filter. Takes precedence over the deprecated singular sourceSystem. At most 50 values; more is rejected as a bad request.

    categories [String!]

    Match-any filter on tech-wheel product family (energy, communications, saas, hardware, managed_services, infrastructure). A row matches when the canonical party or any party it absorbed reports at least one of the given categories. Empty or omitted applies no category filter. Independent of sourceSystems. At most 50 values; more is rejected as a bad request.

    entityType String

    Case-insensitive filter: customer entity type must match.

    search String

    Substring search on name, email, source system, or source id.

    updatedAtFrom DateTime

    Inclusive lower bound on the customer's Last Modified timestamp.

    updatedAtTo DateTime

    Inclusive upper bound on the customer's Last Modified timestamp.

    advisorUuid ID

    Optional advisor UUID filter applied on top of marketplaceTenant; null = no filter.

    Return Fields

    CustomerUnifiedListConnection! PREVIEW

    Async wrapper for the unified customer directory warehouse query.

    Interactive example

    This is an example query. Use the embedded interactive tool below to edit the query.

    Hint: use Ctrl + Space for autocompleting fields.