Photos

Add photos to a project

Add photos to a project from public https image URLs (image_urls) or from files the user attached in ChatGPT (files). Up to 25 photos per call; a project holds at most 100. Each file must be JPEG, PNG, WebP, HEIC or HEIF and at most 25 MB. Dropbox and Google Drive share links work if they are shared publicly. HEIC is converted to JPEG and large photos are downscaled to a 2048px long edge, like the web app. Returns the new photos (use their IDs with enhance_photos, stage_photos or create_video) and a failed list with a reason per source; report failures to the user rather than retrying blindly. If the user has photos on their phone or computer and no links, call create_upload_link instead.

Requires a connection with edit access.

post/projects/{project_id}/photos

Request

  • Base URL: https://api.propertypixel.app/v1
  • URL: https://api.propertypixel.app/v1/projects/{project_id}/photos
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://llflgtovnkrsjqydycyu.supabase.co/auth/v1/oauth/authorize, token URL https://llflgtovnkrsjqydycyu.supabase.co/auth/v1/oauth/token)

Path parameters

project_idstring uuid required

The project to add photos to.

Headers

Idempotency-Keystring

A unique key (for example a UUID) that makes retries safe. A retry with the same key and body returns the stored response; the same key with a different body returns 422. Keys last 24 hours.

Request body

image_urlsstring[]

Public https image URLs (max 25).

Response

Add photos to a project

object'photo_list' required
project_photo_countinteger required

Photos now in the project (max 100).

Changes

No recorded changes to this operation across all 1 revision of this API.