Class ConnectionLevelFieldMappingsAccessor

client

connectionSelector

list

• list(
      query?: {
          limit?: number;
          cursor?: string;
          includeArchived?: boolean;
          search?: string;
          fieldMappingId?: string;
          universalFieldMappingId?: string;
          externalAppId?: string;
          integrationKey?: string;
          integrationId?: string;
          connectionId?: string;
          connectionKey?: string;
          instanceKey?: string;
          universalParentId?: string;
          tenantId?: string;
          userId?: string;
          isUniversal?: boolean;
          layer?: "connection" | "integration" | "universal";
      },
  ): Promise<
      PaginationResponse<
          {
              integration?: {
                  logoUri: string;
                  connectorId?: string;
                  connectorVersion?: string;
                  oAuthCallbackUri?: string;
                  parameters?: any;
                  archivedAt?: string;
                  hasMissingParameters?: boolean;
                  hasDocumentation?: boolean;
                  hasOperations?: boolean;
                  operationsCount?: number;
                  hasData?: boolean;
                  dataCollectionsCount?: number;
                  hasEvents?: boolean;
                  eventsCount?: number;
                  hasGlobalWebhooks?: boolean;
                  hasUdm?: boolean;
                  isTest?: boolean;
                  externalAppId?: string;
                  appUuid?: string;
                  isDeactivated?: boolean;
                  authType?: | "proxy"
                  | "integration-app-token"
                  | "membrane-token"
                  | "oauth2"
                  | "oauth1"
                  | "client-credentials";
                  optionsConfig?: Record<
                      string,
                      { disabled?: boolean; parameters?: Record<(...), (...)> },
                  >;
                  id: string;
                  uuid?: string;
                  key?: string;
                  description?: string;
                  meta?: Record<string, any>;
                  name: string;
                  state?:
                      | BUILDING
                      | CLIENT_ACTION_REQUIRED
                      | CONFIGURATION_ERROR
                      | SETUP_FAILED
                      | READY
                      | DISCONNECTING;
                  errors?: ErrorDataSchema[];
                  revision?: string;
                  createdAt?: string;
                  updatedAt?: string;
                  isReadOnly?: boolean;
              };
              appliedToIntegrations?: {
                  element: {
                      connectionId?: string;
                      instanceKey?: string;
                      fieldMappingId?: string;
                      universalFieldMappingId?: string;
                      dataSourceId?: string;
                      dataSourceUuid?: string;
                      dataSourceKey?: string;
                      appSchema?: DataSchema;
                      direction?: IMPORT
                      | EXPORT
                      | BOTH;
                      defaultImportValue?: any;
                      defaultExportValue?: any;
                      importValue?: any;
                      exportValue?: any;
                      unifiedImportValue?: any;
                      unifiedExportValue?: any;
                      frozenImportFields?: any;
                      frozenExportFields?: any;
                      frozenUnifiedExportFields?: any;
                      fieldMappingRevision?: string;
                      universalFieldMappingRevision?: string;
                      dataSourceInstanceId?: string;
                      dataSourceSchema?: DataSchema;
                      isCustomized?: boolean;
                      state?:
                          | BUILDING
                          | CLIENT_ACTION_REQUIRED
                          | CONFIGURATION_ERROR
                          | SETUP_FAILED
                          | READY
                          | DISCONNECTING;
                      error?: ErrorDataSchema;
                      id: string;
                      uuid?: string;
                      key?: string;
                      description?: string;
                      meta?: Record<string, any>;
                      name: string;
                      errors?: ErrorDataSchema[];
                      revision?: string;
                      createdAt?: string;
                      updatedAt?: string;
                      archivedAt?: string;
                      isDeactivated?: boolean;
                      isReadOnly?: boolean;
                      integrationId?: string;
                      integrationUuid?: string;
                      integrationKey?: string;
                      parentUuid?: string;
                      parentKey?: string;
                      isUniversal?: boolean;
                      externalAppId?: string;
                      externalAppUuid?: string;
                      externalAppKey?: string;
                      userId?: string;
                      tenantId?: string;
                  };
                  integration: {
                      logoUri: string;
                      connectorId?: string;
                      connectorVersion?: string;
                      oAuthCallbackUri?: string;
                      parameters?: any;
                      archivedAt?: string;
                      hasMissingParameters?: boolean;
                      hasDocumentation?: boolean;
                      hasOperations?: boolean;
                      operationsCount?: number;
                      hasData?: boolean;
                      dataCollectionsCount?: number;
                      hasEvents?: boolean;
                      eventsCount?: number;
                      hasGlobalWebhooks?: boolean;
                      hasUdm?: boolean;
                      isTest?: boolean;
                      externalAppId?: string;
                      appUuid?: string;
                      isDeactivated?: boolean;
                      authType?: | "proxy"
                      | "integration-app-token"
                      | "membrane-token"
                      | "oauth2"
                      | "oauth1"
                      | "client-credentials";
                      optionsConfig?: Record<string, { disabled?: ...; parameters?: ... }>;
                      id: string;
                      uuid?: string;
                      key?: string;
                      description?: string;
                      meta?: Record<string, any>;
                      name: string;
                      state?:
                          | BUILDING
                          | CLIENT_ACTION_REQUIRED
                          | CONFIGURATION_ERROR
                          | SETUP_FAILED
                          | READY
                          | DISCONNECTING;
                      errors?: ErrorDataSchema[];
                      revision?: string;
                      createdAt?: string;
                      updatedAt?: string;
                      isReadOnly?: boolean;
                  };
              }[];
              user?: {
                  id: string;
                  name: string;
                  meta?: Record<string, any>;
                  internalId: string;
                  fields?: Record<string, any>;
                  credentials?: any;
                  lastActiveAt?: string;
                  isTest?: boolean;
                  isBillable?: boolean;
                  isActive?: boolean;
                  aiCreditsRolling30DayLimit?: number | null;
                  createdAt?: string;
                  archivedAt?: string;
              };
              connection?: {
                  type?: "connector"
                  | "mcp";
                  name: string;
                  key?: string;
                  isTest?: boolean;
                  connected?: boolean;
                  disconnected?: boolean;
                  isDefunct?: boolean;
                  state?:
                      | BUILDING
                      | CLIENT_ACTION_REQUIRED
                      | CONFIGURATION_ERROR
                      | SETUP_FAILED
                      | READY
                      | DISCONNECTING;
                  errors?: ErrorDataSchema[];
                  requestError?: ErrorDataSchema;
                  error?: ErrorDataSchema;
                  integrationId?: string;
                  connectorId?: string;
                  externalAppId?: string;
                  connectorVersion?: string;
                  authOptionKey?: string;
                  createdAt: string;
                  updatedAt: string;
                  lastActiveAt?: string;
                  nextCredentialsRefreshAt?: string;
                  nextRetryTimestamp?: string;
                  retryAttempts?: number;
                  canTest?: boolean;
                  canRefreshCredentials?: boolean;
                  archivedAt?: string;
                  isDeactivated?: boolean;
                  meta?: Record<string, any>;
                  buildingAgentSessionId?: string;
                  clientAction?: {
                      type: "connect" | "provide-input";
                      description: string;
                      uiUrl?: string;
                      agentInstructions?: string;
                      handoffAgentInstructions?: string;
                      reason?: "provide-input" | "authenticate" | "reauthenticate";
                  };
                  id: string;
                  userId: string;
                  tenantId?: string;
              };
              fieldMapping?: {
                  connectionId?: string;
                  instanceKey?: string;
                  fieldMappingId?: string;
                  universalFieldMappingId?: string;
                  dataSourceId?: string;
                  dataSourceUuid?: string;
                  dataSourceKey?: string;
                  appSchema?: DataSchema;
                  direction?: IMPORT
                  | EXPORT
                  | BOTH;
                  defaultImportValue?: any;
                  defaultExportValue?: any;
                  importValue?: any;
                  exportValue?: any;
                  unifiedImportValue?: any;
                  unifiedExportValue?: any;
                  frozenImportFields?: any;
                  frozenExportFields?: any;
                  frozenUnifiedExportFields?: any;
                  fieldMappingRevision?: string;
                  universalFieldMappingRevision?: string;
                  dataSourceInstanceId?: string;
                  dataSourceSchema?: DataSchema;
                  isCustomized?: boolean;
                  state?:
                      | BUILDING
                      | CLIENT_ACTION_REQUIRED
                      | CONFIGURATION_ERROR
                      | SETUP_FAILED
                      | READY
                      | DISCONNECTING;
                  error?: ErrorDataSchema;
                  id: string;
                  uuid?: string;
                  key?: string;
                  description?: string;
                  meta?: Record<string, any>;
                  name: string;
                  errors?: ErrorDataSchema[];
                  revision?: string;
                  createdAt?: string;
                  updatedAt?: string;
                  archivedAt?: string;
                  isDeactivated?: boolean;
                  isReadOnly?: boolean;
                  integrationId?: string;
                  integrationUuid?: string;
                  integrationKey?: string;
                  parentUuid?: string;
                  parentKey?: string;
                  isUniversal?: boolean;
                  externalAppId?: string;
                  externalAppUuid?: string;
                  externalAppKey?: string;
                  userId?: string;
                  tenantId?: string;
              };
              connectionId?: string;
              instanceKey?: string;
              fieldMappingId?: string;
              universalFieldMappingId?: string;
              dataSourceId?: string;
              dataSourceUuid?: string;
              dataSourceKey?: string;
              appSchema?: DataSchema;
              direction?: IMPORT
              | EXPORT
              | BOTH;
              defaultImportValue?: any;
              defaultExportValue?: any;
              importValue?: any;
              exportValue?: any;
              unifiedImportValue?: any;
              unifiedExportValue?: any;
              frozenImportFields?: any;
              frozenExportFields?: any;
              frozenUnifiedExportFields?: any;
              fieldMappingRevision?: string;
              universalFieldMappingRevision?: string;
              dataSourceInstanceId?: string;
              dataSourceSchema?: DataSchema;
              isCustomized?: boolean;
              state?:
                  | BUILDING
                  | CLIENT_ACTION_REQUIRED
                  | CONFIGURATION_ERROR
                  | SETUP_FAILED
                  | READY
                  | DISCONNECTING;
              error?: ErrorDataSchema;
              id: string;
              uuid?: string;
              key?: string;
              description?: string;
              meta?: Record<string, any>;
              name: string;
              errors?: ErrorDataSchema[];
              revision?: string;
              createdAt?: string;
              updatedAt?: string;
              archivedAt?: string;
              isDeactivated?: boolean;
              isReadOnly?: boolean;
              integrationId?: string;
              integrationUuid?: string;
              integrationKey?: string;
              parentUuid?: string;
              parentKey?: string;
              isUniversal?: boolean;
              externalAppId?: string;
              externalAppUuid?: string;
              externalAppKey?: string;
              userId?: string;
              tenantId?: string;
          }[],
      >,
  >

  Parameters

  • Optionalquery: {
        limit?: number;
        cursor?: string;
        includeArchived?: boolean;
        search?: string;
        fieldMappingId?: string;
        universalFieldMappingId?: string;
        externalAppId?: string;
        integrationKey?: string;
        integrationId?: string;
        connectionId?: string;
        connectionKey?: string;
        instanceKey?: string;
        universalParentId?: string;
        tenantId?: string;
        userId?: string;
        isUniversal?: boolean;
        layer?: "connection" | "integration" | "universal";
    }

  Returns Promise<
      PaginationResponse<
          {
              integration?: {
                  logoUri: string;
                  connectorId?: string;
                  connectorVersion?: string;
                  oAuthCallbackUri?: string;
                  parameters?: any;
                  archivedAt?: string;
                  hasMissingParameters?: boolean;
                  hasDocumentation?: boolean;
                  hasOperations?: boolean;
                  operationsCount?: number;
                  hasData?: boolean;
                  dataCollectionsCount?: number;
                  hasEvents?: boolean;
                  eventsCount?: number;
                  hasGlobalWebhooks?: boolean;
                  hasUdm?: boolean;
                  isTest?: boolean;
                  externalAppId?: string;
                  appUuid?: string;
                  isDeactivated?: boolean;
                  authType?: | "proxy"
                  | "integration-app-token"
                  | "membrane-token"
                  | "oauth2"
                  | "oauth1"
                  | "client-credentials";
                  optionsConfig?: Record<
                      string,
                      { disabled?: boolean; parameters?: Record<(...), (...)> },
                  >;
                  id: string;
                  uuid?: string;
                  key?: string;
                  description?: string;
                  meta?: Record<string, any>;
                  name: string;
                  state?:
                      | BUILDING
                      | CLIENT_ACTION_REQUIRED
                      | CONFIGURATION_ERROR
                      | SETUP_FAILED
                      | READY
                      | DISCONNECTING;
                  errors?: ErrorDataSchema[];
                  revision?: string;
                  createdAt?: string;
                  updatedAt?: string;
                  isReadOnly?: boolean;
              };
              appliedToIntegrations?: {
                  element: {
                      connectionId?: string;
                      instanceKey?: string;
                      fieldMappingId?: string;
                      universalFieldMappingId?: string;
                      dataSourceId?: string;
                      dataSourceUuid?: string;
                      dataSourceKey?: string;
                      appSchema?: DataSchema;
                      direction?: IMPORT
                      | EXPORT
                      | BOTH;
                      defaultImportValue?: any;
                      defaultExportValue?: any;
                      importValue?: any;
                      exportValue?: any;
                      unifiedImportValue?: any;
                      unifiedExportValue?: any;
                      frozenImportFields?: any;
                      frozenExportFields?: any;
                      frozenUnifiedExportFields?: any;
                      fieldMappingRevision?: string;
                      universalFieldMappingRevision?: string;
                      dataSourceInstanceId?: string;
                      dataSourceSchema?: DataSchema;
                      isCustomized?: boolean;
                      state?:
                          | BUILDING
                          | CLIENT_ACTION_REQUIRED
                          | CONFIGURATION_ERROR
                          | SETUP_FAILED
                          | READY
                          | DISCONNECTING;
                      error?: ErrorDataSchema;
                      id: string;
                      uuid?: string;
                      key?: string;
                      description?: string;
                      meta?: Record<string, any>;
                      name: string;
                      errors?: ErrorDataSchema[];
                      revision?: string;
                      createdAt?: string;
                      updatedAt?: string;
                      archivedAt?: string;
                      isDeactivated?: boolean;
                      isReadOnly?: boolean;
                      integrationId?: string;
                      integrationUuid?: string;
                      integrationKey?: string;
                      parentUuid?: string;
                      parentKey?: string;
                      isUniversal?: boolean;
                      externalAppId?: string;
                      externalAppUuid?: string;
                      externalAppKey?: string;
                      userId?: string;
                      tenantId?: string;
                  };
                  integration: {
                      logoUri: string;
                      connectorId?: string;
                      connectorVersion?: string;
                      oAuthCallbackUri?: string;
                      parameters?: any;
                      archivedAt?: string;
                      hasMissingParameters?: boolean;
                      hasDocumentation?: boolean;
                      hasOperations?: boolean;
                      operationsCount?: number;
                      hasData?: boolean;
                      dataCollectionsCount?: number;
                      hasEvents?: boolean;
                      eventsCount?: number;
                      hasGlobalWebhooks?: boolean;
                      hasUdm?: boolean;
                      isTest?: boolean;
                      externalAppId?: string;
                      appUuid?: string;
                      isDeactivated?: boolean;
                      authType?: | "proxy"
                      | "integration-app-token"
                      | "membrane-token"
                      | "oauth2"
                      | "oauth1"
                      | "client-credentials";
                      optionsConfig?: Record<string, { disabled?: ...; parameters?: ... }>;
                      id: string;
                      uuid?: string;
                      key?: string;
                      description?: string;
                      meta?: Record<string, any>;
                      name: string;
                      state?:
                          | BUILDING
                          | CLIENT_ACTION_REQUIRED
                          | CONFIGURATION_ERROR
                          | SETUP_FAILED
                          | READY
                          | DISCONNECTING;
                      errors?: ErrorDataSchema[];
                      revision?: string;
                      createdAt?: string;
                      updatedAt?: string;
                      isReadOnly?: boolean;
                  };
              }[];
              user?: {
                  id: string;
                  name: string;
                  meta?: Record<string, any>;
                  internalId: string;
                  fields?: Record<string, any>;
                  credentials?: any;
                  lastActiveAt?: string;
                  isTest?: boolean;
                  isBillable?: boolean;
                  isActive?: boolean;
                  aiCreditsRolling30DayLimit?: number | null;
                  createdAt?: string;
                  archivedAt?: string;
              };
              connection?: {
                  type?: "connector"
                  | "mcp";
                  name: string;
                  key?: string;
                  isTest?: boolean;
                  connected?: boolean;
                  disconnected?: boolean;
                  isDefunct?: boolean;
                  state?:
                      | BUILDING
                      | CLIENT_ACTION_REQUIRED
                      | CONFIGURATION_ERROR
                      | SETUP_FAILED
                      | READY
                      | DISCONNECTING;
                  errors?: ErrorDataSchema[];
                  requestError?: ErrorDataSchema;
                  error?: ErrorDataSchema;
                  integrationId?: string;
                  connectorId?: string;
                  externalAppId?: string;
                  connectorVersion?: string;
                  authOptionKey?: string;
                  createdAt: string;
                  updatedAt: string;
                  lastActiveAt?: string;
                  nextCredentialsRefreshAt?: string;
                  nextRetryTimestamp?: string;
                  retryAttempts?: number;
                  canTest?: boolean;
                  canRefreshCredentials?: boolean;
                  archivedAt?: string;
                  isDeactivated?: boolean;
                  meta?: Record<string, any>;
                  buildingAgentSessionId?: string;
                  clientAction?: {
                      type: "connect" | "provide-input";
                      description: string;
                      uiUrl?: string;
                      agentInstructions?: string;
                      handoffAgentInstructions?: string;
                      reason?: "provide-input" | "authenticate" | "reauthenticate";
                  };
                  id: string;
                  userId: string;
                  tenantId?: string;
              };
              fieldMapping?: {
                  connectionId?: string;
                  instanceKey?: string;
                  fieldMappingId?: string;
                  universalFieldMappingId?: string;
                  dataSourceId?: string;
                  dataSourceUuid?: string;
                  dataSourceKey?: string;
                  appSchema?: DataSchema;
                  direction?: IMPORT
                  | EXPORT
                  | BOTH;
                  defaultImportValue?: any;
                  defaultExportValue?: any;
                  importValue?: any;
                  exportValue?: any;
                  unifiedImportValue?: any;
                  unifiedExportValue?: any;
                  frozenImportFields?: any;
                  frozenExportFields?: any;
                  frozenUnifiedExportFields?: any;
                  fieldMappingRevision?: string;
                  universalFieldMappingRevision?: string;
                  dataSourceInstanceId?: string;
                  dataSourceSchema?: DataSchema;
                  isCustomized?: boolean;
                  state?:
                      | BUILDING
                      | CLIENT_ACTION_REQUIRED
                      | CONFIGURATION_ERROR
                      | SETUP_FAILED
                      | READY
                      | DISCONNECTING;
                  error?: ErrorDataSchema;
                  id: string;
                  uuid?: string;
                  key?: string;
                  description?: string;
                  meta?: Record<string, any>;
                  name: string;
                  errors?: ErrorDataSchema[];
                  revision?: string;
                  createdAt?: string;
                  updatedAt?: string;
                  archivedAt?: string;
                  isDeactivated?: boolean;
                  isReadOnly?: boolean;
                  integrationId?: string;
                  integrationUuid?: string;
                  integrationKey?: string;
                  parentUuid?: string;
                  parentKey?: string;
                  isUniversal?: boolean;
                  externalAppId?: string;
                  externalAppUuid?: string;
                  externalAppKey?: string;
                  userId?: string;
                  tenantId?: string;
              };
              connectionId?: string;
              instanceKey?: string;
              fieldMappingId?: string;
              universalFieldMappingId?: string;
              dataSourceId?: string;
              dataSourceUuid?: string;
              dataSourceKey?: string;
              appSchema?: DataSchema;
              direction?: IMPORT
              | EXPORT
              | BOTH;
              defaultImportValue?: any;
              defaultExportValue?: any;
              importValue?: any;
              exportValue?: any;
              unifiedImportValue?: any;
              unifiedExportValue?: any;
              frozenImportFields?: any;
              frozenExportFields?: any;
              frozenUnifiedExportFields?: any;
              fieldMappingRevision?: string;
              universalFieldMappingRevision?: string;
              dataSourceInstanceId?: string;
              dataSourceSchema?: DataSchema;
              isCustomized?: boolean;
              state?:
                  | BUILDING
                  | CLIENT_ACTION_REQUIRED
                  | CONFIGURATION_ERROR
                  | SETUP_FAILED
                  | READY
                  | DISCONNECTING;
              error?: ErrorDataSchema;
              id: string;
              uuid?: string;
              key?: string;
              description?: string;
              meta?: Record<string, any>;
              name: string;
              errors?: ErrorDataSchema[];
              revision?: string;
              createdAt?: string;
              updatedAt?: string;
              archivedAt?: string;
              isDeactivated?: boolean;
              isReadOnly?: boolean;
              integrationId?: string;
              integrationUuid?: string;
              integrationKey?: string;
              parentUuid?: string;
              parentKey?: string;
              isUniversal?: boolean;
              externalAppId?: string;
              externalAppUuid?: string;
              externalAppKey?: string;
              userId?: string;
              tenantId?: string;
          }[],
      >,
  >