Properties

Add photos to a property by URL

Adds photos to a property by URL — the server fetches each URL and stores it (any public https image, or a small data: URI), then returns the stored img.pedra.ai URLs. Up to 20 per call. With type "360", adds 360° photos for a virtual tour (max 10 per call). Images stored from URLs count toward the daily upload limit (30/day free, 500/day paid); over it, 429 upload_limit and nothing is stored.

post/api/add_images_to_property

Request

  • Base URL: https://app.pedra.ai
  • URL: https://app.pedra.ai/api/add_images_to_property
  • Auth: none required

Request body

apiKeystring required

Account API key, sent in the request body. Get one at https://app.pedra.ai under Settings → API.

propertyIdstring required
imageUrlsstring[] required

Image URLs (or data: URIs) to fetch and add — up to 20 per call, or 10 with type "360".

namesstring[]

Optional names, one per image in the same order as imageUrls (e.g. the original file names). Returned as name by list_property_images and as source.name when the photo is edited. Never drawn on the image. Defaults to "Image 1", "Image 2"...

type'photo' | '360'

"360" adds 360° photos for a virtual tour: each is checked to be equirectangular (2:1), stored like the app stores them (JPEG, 4096 px wide; 6144 px above 20 MB), max 80 MB each and max 10 per call. data: URIs are accepted, so local files can be sent base64-encoded (a few per call, under the 50 MB body limit).

Response

Photos added.

messagestring
propertyIdstring
appUrlstring
type'360'

Present ("360") when 360° photos were added.

Changes

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