app-metadata git:20260801.d400e34A

Immutable. This exact content is served forever at /api/v1/blob/ed667de79acc224e.

---
name: "app-metadata"
description: "Endpoints for managing app screenshots, product pages, and localizations."
---

# App Metadata
Endpoints for managing app screenshots, product pages, and localizations.

## Endpoints

### `POST /v1/appCustomProductPages`
**Summary**: No summary provided.

### `GET /v1/appCustomProductPages/{id}`
**Summary**: No summary provided.

**Parameters**:
- `fields[appCustomProductPages]` (query, optional): the fields to include for returned resources of type appCustomProductPages
- `fields[apps]` (query, optional): the fields to include for returned resources of type apps
- `fields[appCustomProductPageVersions]` (query, optional): the fields to include for returned resources of type appCustomProductPageVersions
- `include` (query, optional): comma-separated list of relationships to include
- `limit[appCustomProductPageVersions]` (query, optional): maximum number of related appCustomProductPageVersions returned (when they are included)

### `PATCH /v1/appCustomProductPages/{id}`
**Summary**: No summary provided.

### `DELETE /v1/appCustomProductPages/{id}`
**Summary**: No summary provided.

### `POST /v1/appEventLocalizations`
**Summary**: No summary provided.

### `GET /v1/appEventLocalizations/{id}`
**Summary**: No summary provided.

**Parameters**:
- `fields[appEventLocalizations]` (query, optional): the fields to include for returned resources of type appEventLocalizations
- `fields[appEvents]` (query, optional): the fields to include for returned resources of type appEvents
- `fields[appEventScreenshots]` (query, optional): the fields to include for returned resources of type appEventScreenshots
- `fields[appEventVideoClips]` (query, optional): the fields to include for returned resources of type appEventVideoClips
- `include` (query, optional): comma-separated list of relationships to include
- `limit[appEventScreenshots]` (query, optional): maximum number of related appEventScreenshots returned (when they are included)
- `limit[appEventVideoClips]` (query, optional): maximum number of related appEventVideoClips returned (when they are included)

### `PATCH /v1/appEventLocalizations/{id}`
**Summary**: No summary provided.

### `DELETE /v1/appEventLocalizations/{id}`
**Summary**: No summary provided.

### `POST /v1/appInfoLocalizations`
**Summary**: No summary provided.

### `GET /v1/appInfoLocalizations/{id}`
**Summary**: No summary provided.

**Parameters**:
- `fields[appInfoLocalizations]` (query, optional): the fields to include for returned resources of type appInfoLocalizations
- `fields[appInfos]` (query, optional): the fields to include for returned resources of type appInfos
- `include` (query, optional): comma-separated list of relationships to include

### `PATCH /v1/appInfoLocalizations/{id}`
**Summary**: No summary provided.

### `DELETE /v1/appInfoLocalizations/{id}`
**Summary**: No summary provided.

### `POST /v1/appScreenshots`
**Summary**: No summary provided.

### `GET /v1/appScreenshots/{id}`
**Summary**: No summary provided.

**Parameters**:
- `fields[appScreenshots]` (query, optional): the fields to include for returned resources of type appScreenshots
- `fields[appScreenshotSets]` (query, optional): the fields to include for returned resources of type appScreenshotSets
- `include` (query, optional): comma-separated list of relationships to include

### `PATCH /v1/appScreenshots/{id}`
**Summary**: No summary provided.

### `DELETE /v1/appScreenshots/{id}`
**Summary**: No summary provided.

### `GET /v1/appCustomProductPages/{id}/relationships/appCustomProductPageVersions`
**Summary**: No summary provided.

**Parameters**:
- `limit` (query, optional): maximum resources per page

### `GET /v1/appCustomProductPages/{id}/appCustomProductPageVersions`
**Summary**: No summary provided.

**Parameters**:
- `filter[state]` (query, optional): filter by attribute 'state'
- `fields[appCustomProductPageVersions]` (query, optional): the fields to include for returned resources of type appCustomProductPageVersions
- `fields[appCustomProductPages]` (query, optional): the fields to include for returned resources of type appCustomProductPages
- `fields[appCustomProductPageLocalizations]` (query, optional): the fields to include for returned resources of type appCustomProductPageLocalizations
- `limit` (query, optional): maximum resources per page
- `include` (query, optional): comma-separated list of relationships to include
- `limit[appCustomProductPageLocalizations]` (query, optional): maximum number of related appCustomProductPageLocalizations returned (when they are included)

### `GET /v1/appEventLocalizations/{id}/relationships/appEventScreenshots`
**Summary**: No summary provided.

**Parameters**:
- `limit` (query, optional): maximum resources per page

### `GET /v1/appEventLocalizations/{id}/appEventScreenshots`
**Summary**: No summary provided.

**Parameters**:
- `fields[appEventScreenshots]` (query, optional): the fields to include for returned resources of type appEventScreenshots
- `fields[appEventLocalizations]` (query, optional): the fields to include for returned resources of type appEventLocalizations
- `limit` (query, optional): maximum resources per page
- `include` (query, optional): comma-separated list of relationships to include

### `GET /v1/appEventLocalizations/{id}/relationships/appEventVideoClips`
**Summary**: No summary provided.

**Parameters**:
- `limit` (query, optional): maximum resources per page

### `GET /v1/appEventLocalizations/{id}/appEventVideoClips`
**Summary**: No summary provided.

**Parameters**:
- `fields[appEventVideoClips]` (query, optional): the fields to include for returned resources of type appEventVideoClips
- `fields[appEventLocalizations]` (query, optional): the fields to include for returned resources of type appEventLocalizations
- `limit` (query, optional): maximum resources per page
- `include` (query, optional): comma-separated list of relationships to include

## Typical Workflows
Use these endpoints to automate app metadata tasks within Apple Store Connect.

## Best Practices
- Always authenticate requests using your Apple Store Connect API key (JWT token).
- Handle rate limiting gracefully, as the Apple Store Connect API enforces quotas.
- When writing integrations, refer back to the exact schemas for precise payload construction.