list_beta_feedback_screenshots

Instructions

Implementation Reference

• src/handlers/beta.ts:98-170 (handler)

  The handler function that executes the tool: fetches beta feedback screenshot submissions from App Store Connect API with filtering, sorting, and optional includes.

  async listBetaFeedbackScreenshots(args: ListBetaFeedbackScreenshotSubmissionsRequest): Promise<ListBetaFeedbackScreenshotSubmissionsResponse> {
    const { 
      appId, 
      bundleId,
      buildId,
      devicePlatform,
      appPlatform,
      deviceModel,
      osVersion,
      testerId,
      limit = 50,
      sort = "-createdDate",
      includeBuilds = false,
      includeTesters = false
    } = args;
    
    // Require either appId or bundleId
    if (!appId && !bundleId) {
      throw new Error('Either appId or bundleId must be provided');
    }
    
    // If bundleId is provided but not appId, look up the app
    let finalAppId = appId;
    if (!appId && bundleId) {
      const app = await this.appHandlers.findAppByBundleId(bundleId);
      if (!app) {
        throw new Error(`No app found with bundle ID: ${bundleId}`);
      }
      finalAppId = app.id;
    }
  
    // Build query parameters
    const params: Record<string, any> = {
      limit: sanitizeLimit(limit),
      sort
    };
  
    // Add filters if provided
    if (buildId) {
      params['filter[build]'] = buildId;
    }
    if (devicePlatform) {
      params['filter[devicePlatform]'] = devicePlatform;
    }
    if (appPlatform) {
      params['filter[appPlatform]'] = appPlatform;
    }
    if (deviceModel) {
      params['filter[deviceModel]'] = deviceModel;
    }
    if (osVersion) {
      params['filter[osVersion]'] = osVersion;
    }
    if (testerId) {
      params['filter[tester]'] = testerId;
    }
  
    // Add includes if requested
    const includes: string[] = [];
    if (includeBuilds) includes.push('build');
    if (includeTesters) includes.push('tester');
    if (includes.length > 0) {
      params.include = includes.join(',');
    }
  
    // Add field selections for better performance
    params['fields[betaFeedbackScreenshotSubmissions]'] = 'createdDate,comment,email,deviceModel,osVersion,locale,timeZone,architecture,connectionType,pairedAppleWatch,appUptimeInMilliseconds,diskBytesAvailable,diskBytesTotal,batteryPercentage,screenWidthInPoints,screenHeightInPoints,appPlatform,devicePlatform,deviceFamily,buildBundleId,screenshots,build,tester';
  
    return this.client.get<ListBetaFeedbackScreenshotSubmissionsResponse>(
      `/apps/${finalAppId}/betaFeedbackScreenshotSubmissions`, 
      params
    );
  }

• src/types/beta.ts:109-122 (schema)

  TypeScript interface defining the input parameters for the handler.

  export interface ListBetaFeedbackScreenshotSubmissionsRequest {
    appId?: string;
    bundleId?: string;
    buildId?: string;
    devicePlatform?: "IOS" | "MAC_OS" | "TV_OS" | "VISION_OS";
    appPlatform?: "IOS" | "MAC_OS" | "TV_OS" | "VISION_OS";
    deviceModel?: string;
    osVersion?: string;
    testerId?: string;
    limit?: number;
    sort?: "createdDate" | "-createdDate";
    includeBuilds?: boolean;
    includeTesters?: boolean;
  }