Virtual tours

Create a no-login upload link for photos and 360° photos

Returns a no-login upload page (valid 24 h) that can only add photos to one property. Works on a phone or computer: drag & drop or pick files, up to 100 files, JPEG/PNG/WebP up to 80 MB each (iPhone HEIC photos work when uploaded from the iPhone). type: "any" (default) takes regular photos and 360° photos — 2:1 images are detected and stored as 360° photos automatically; type: "360" takes 360° photos only (use it for virtual tours). Photos are stored like the web app stores them (long side 2048 px, 3072 px over 20 MB; 360° photos 4096/6144 px wide). Files are sorted by file name (= shooting order). When the upload is done, call /api/list_property_images (type "photo" or "360") for URLs to edit, use in create_video, or call /api/create_virtual_tour with the propertyId and no scenes. This is how chat assistants get photos from a user's phone. Free; 5 links/day on the free plan, 50/day on paid plans (429 upload_link_limit). Each uploaded file counts toward the daily upload limit.

post/api/create_upload_link

Request

  • Base URL: https://app.pedra.ai
  • URL: https://app.pedra.ai/api/create_upload_link
  • 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

Property to upload into. Omit to create a new property named after name.

namestring
type'any' | '360'

"any": photos and 360° photos (2:1 images stored as 360° automatically). "360": 360° photos only — use it for a virtual tour.

language'en' | 'es' | 'fr' | 'de' | 'it' | 'pt'

Tour page UI language and the language of AI room names. Non-English tours get a /{lang}/virtual-tour/... URL.

Response

Upload link created.

uploadUrlstring
propertyIdstring
propertyNamestring nullable
type'any' | '360'
expiresAtstring date-time
maxFilesinteger

Max files per link (100).

appUrlstring
messagestring

Changes

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