Screenshots

List and delete project screenshots; browse templates; manage Studio sessions.

Updated 2026-05-24
3 min read

Read access to a project's app screenshots, delete operations for cleanup, plus access to the SS Studio V2 template library and saved compositions.

List project screenshots

bash
GET /api/v1/projects/:projectId/screenshots?store_type=appstore&device_type=iphone&locale=en-US&sync_status=synced

# Scope: screenshots:read

Delete a screenshot

bash
DELETE /api/v1/screenshots/:screenshotId

# Scope: screenshots:write
# Returns 204. Does NOT remove from the App Store / Play Store if already synced — use publish flow for that.

Browse Studio templates

bash
GET /api/v1/screenshot-templates?device_type=iphone&category=minimal&app_slug=anydistance&limit=30

# Scope: screenshots:read
# Returns curated SS Studio V2 templates (Any Distance, Headspace, etc.)

Studio sessions

bash
GET /api/v1/projects/:projectId/screenshots/studio-sessions?limit=25
GET /api/v1/studio-sessions/:sessionId
POST /api/v1/projects/:projectId/screenshots/studio-sessions
  { "name": "My Session" }   // creates an empty session

# Read scope: screenshots:read | write scope: screenshots:write

Localization jobs

bash
GET /api/v1/projects/:projectId/screenshots/localization-jobs?limit=25

# Inspect background AI-translation jobs over screenshot overlays.
# Scope: screenshots:read