list_app_store_versions
Retrieve all App Store versions for a specific application, with options to filter by platform, version string, or release status.
Instructions
Get all app store versions for a specific app
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| appId | Yes | The ID of the app | |
| limit | No | Maximum number of versions to return (default: 100) | |
| filter | No | Optional filters for app store versions |
Implementation Reference
- src/handlers/localizations.ts:16-50 (handler)The handler function that executes the tool logic: validates inputs, constructs API parameters with filters, and calls the AppStoreConnectClient to fetch app store versions.
async listAppStoreVersions(args: { appId: string; limit?: number; filter?: { platform?: string; versionString?: string; appStoreState?: string; }; }): Promise<ListAppStoreVersionsResponse> { const { appId, limit = 100, filter } = args; validateRequired(args, ['appId']); const params: Record<string, any> = { limit: sanitizeLimit(limit), 'filter[app]': appId }; if (filter?.platform) { params['filter[platform]'] = filter.platform; } if (filter?.versionString) { params['filter[versionString]'] = filter.versionString; } if (filter?.appStoreState) { params['filter[appStoreState]'] = filter.appStoreState; } return this.client.get<ListAppStoreVersionsResponse>( '/appStoreVersions', params ); } - src/types/localizations.ts:99-111 (schema)The TypeScript interface defining the expected response structure for ListAppStoreVersionsResponse.
export interface ListAppStoreVersionsResponse { data: AppStoreVersion[]; links?: { self: string; next?: string; }; meta?: { paging: { total: number; limit: number; }; }; }