Connect AI assistants to Orbix360

whoami · Who am I

Returns the Orbix360 account this connection acts for: user id, display name, email, plan, and the permissions the token carries. Call it to check the connection works.

No inputs.

Example: whoami {}

get_account · Account and plan limits

Returns the plan this account is on, whether it may make tours private and use its own branding (no watermark, embedding), how many multi-image and single-image tours it has and may still create (including any bonus and its cap), the photo-count and file-size caps for one tour (null = no cap), and the Pricing and Billing page addresses. Call it before creating a tour or adding photos.

No inputs.

Example: get_account {}

list_tours · List my tours

Lists this account's tours, newest created first, a page at a time. Each tour has its id, name, kind (single- or multi-image), scene count, visibility, last-changed time and a thumbnail. Pass nameContains to search by name (case-insensitive) and the previous answer's nextCursor as cursor for the next page; nextCursor is null on the last page. A filtered search reads a bounded number of tours per call: when scanLimited is true, continue with nextCursor.

limit · integer · optional

Tours per page, 1–50 (default 20). (at least 1, at most 50)

cursor · string · optional

nextCursor from the previous answer of the same search. (at least 1 character, up to 2048 characters)

nameContains · string · optional

Only tours whose name contains this text (case-insensitive). (up to 200 characters)

Example: list_tours { "nameContains": "lake house" }

get_tour · Read a tour

Returns one of your tours as the viewer shows it: name, visibility, autorotate, the premium state, stateRevision (quote it when you edit the tour), the scenes in order (title, whether the title is only a "Photo N" placeholder, photo type, thumbnail, processing status ready / processing / missing / unknown, heading = the yaw the scene opens on, and generated = sent as AI-generated), and every navigation hotspot, info hotspot and flat image with its position as yaw / pitch in degrees on the scene's panorama: yaw 0 = the photo's centre column, positive to the right, in (-180, 180]; pitch 0 = the horizon, +90 = straight up.

tourId · string · required

The tour id, as list_tours returns it. (up to 32 characters, a fixed format)

Example: get_tour { "tourId": "…" }

create_tour · Create tour

Creates a new 360° virtual tour in the account. kind "multi" holds several photos linked by navigation hotspots; "single" holds one photo. Visibility defaults to public; private needs a Pro plan. Free accounts can create a limited number of tours. Returns the tour id, links to view and edit it, and what to do next.

Counts toward the plan's tour allowance.

name · string · required

The tour name, up to 200 characters. (at least 1 character, up to 200 characters)

kind · one of: multi, single · required

"multi" for a multi-image tour, "single" for a single-image tour.

visibility · one of: public, private · optional

Defaults to "public". "private" needs a Pro plan.

Example: create_tour { "name": "Lake House", "kind": "multi" }

update_tour · Update tour

Changes a tour's name, visibility and/or auto-rotation. Give at least one of them. All the given settings change together, or none do when one is refused. Making a tour private needs a Pro plan or a Premium Tour on that tour. Settings the tour already has are left as they are, so repeating a call changes nothing.

Private tours need a Pro account or a Premium Tour.

tourId · string · required

The tour id. (a fixed format)

name · string · optional

A new name, up to 200 characters. (at least 1 character, up to 200 characters)

visibility · one of: public, private · optional

"private" needs a Pro plan or a Premium Tour on this tour.

autorotate · boolean · optional

Whether the tour turns slowly on its own when opened.

Example: update_tour { "tourId": "…", "visibility": "private" }

delete_tour · Delete tour

Permanently deletes a tour and its photos. This cannot be undone. confirmName must be the tour's exact current name, as the owner confirmed it. A Premium Tour subscription on the tour stops renewing; the answer says so.

Cannot be undone. Needs the tour's exact current name as confirmName, so confirm with the owner first.

tourId · string · required

The tour id. (a fixed format)

confirmName · string · required

The tour's exact current name, confirmed with the owner.

Example: delete_tour { "tourId": "…", "confirmName": "Lake House" }

get_share_links · Share links for a tour

Returns the addresses to share one of your tours: the public page, the short link (null when the tour has none), the share link the Orbix360 share box copies, the viewer link, your editor link and, when this tour may be embedded (Pro plan or a Premium Tour for the tour), an embed snippet; otherwise embedUnavailable says what unlocks it. These links are not tracked, so sharing them does not earn shared-tour credit.

The embed snippet is offered only to a Pro account or a Premium Tour.

tourId · string · required

The tour id, as list_tours returns it. (up to 32 characters, a fixed format)

Example: get_share_links { "tourId": "…" }

add_photo_from_url · Add a photo from a URL

Add a 360° photo to one of the user's tours from a public https URL. The server downloads the image (JPEG, PNG or WebP), checks it, and adds it as the last scene of the tour. 360_mono photos must be equirectangular: twice as wide as tall (2:1). Use 360_pano for a wider panorama. For an image made by an AI image generator (yours or the user's), set generated: true: a 360_mono image from 1.74:1 to 2.40:1 (16:9 to 2.4:1) is then stretched to 2:1 and its left and right edges blended so no seam shows. Returns status "processing": call get_photo_status with the photo id until it is "ready" before placing hotspots on it. For a file on this computer, use create_photo_upload instead.

With generated: true, an AI-generated image from 1.74:1 to 2.40:1 is stretched to 2:1 and its seam blended.

tourId · string · required

The tour id, as list_tours returns it. (up to 32 characters, a fixed format)

url · string · required

A public https URL of the image itself (not a web page showing it). (up to 2048 characters)

title · string · optional

The scene title, e.g. "Kitchen". (at least 1 character, up to 200 characters)

photoType · one of: 360_mono, 360_pano · required

360_mono for an equirectangular 2:1 photo; 360_pano for a wider panorama.

generated · boolean · optional

Set true for an image made by an AI image generator. A 360_mono image from 1.74:1 to 2.40:1 is then stretched to 2:1 and its seam blended; without it, a 360_mono image must already be 2:1.

Example: add_photo_from_url { "tourId": "…", "url": "https://example.com/living-room.jpg", "photoType": "360_mono" }

create_photo_upload · Upload a photo from this computer or the browser

Prepare an upload of a photo file into one of the user's tours. It works in every client, including web and chat apps that cannot run commands. In a chat or web app, and whenever the user attached the photos to the conversation: you cannot send the file yourself and do not need to. Call this tool once per photo, give the user each uploadPage.url, and ask them to open it in a browser signed in to Orbix360 and drop that photo there (each link takes one file, once, within 2 hours). Do not ask the user to run commands. Agents that can run shell commands on the computer holding the file: run the returned command exactly as given, from the folder the filename is relative to. Either way, then call get_photo_status with the photo id until it is "ready". The file must be a JPEG; a 360_mono photo must be equirectangular (2:1). Size, format and shape are checked after the upload: a file that fails is removed and get_photo_status says why. The upload address and the page link work for this one photo only. If they expire before the file is sent, call create_photo_upload again with the same photoId for new ones (nothing new is added to the tour). For an image on the web, use add_photo_from_url instead. For an image made by an AI image generator, set generated: true: the file may then also be a PNG or WebP, and a 360_mono image from 1.74:1 to 2.40:1 (16:9 to 2.4:1) is stretched to 2:1 with its left and right edges blended.

Works in every client: answers an uploadPage link (signed-in owner, 2 hours, one file) that chat and web apps hand to the user, and an upload command for agents that can run shell commands.

With generated: true the file may also be a PNG or WebP; pass photoId to get a new command and link for a photo still waiting for its file.

tourId · string · required

The tour id, as list_tours returns it. (up to 32 characters, a fixed format)

filename · string · required

The .jpg / .jpeg file (or .png / .webp with generated: true). In a chat or web app, its name as the user attached it or will drop it, e.g. R0010027.jpg. For an agent with a shell, its local path, as the upload command should name it. (at least 1 character, up to 255 characters)

photoType · one of: 360_mono, 360_pano · optional

360_mono for an equirectangular 2:1 photo; 360_pano for a wider panorama. Required unless photoId is given.

title · string · optional

The scene title, e.g. "Living room". (at least 1 character, up to 200 characters)

generated · boolean · optional

Set true for an image made by an AI image generator: PNG / WebP are accepted, and a 360_mono image from 1.74:1 to 2.40:1 is stretched to 2:1 and its seam blended.

photoId · string · optional

To get a new command and page link for a photo that is still waiting for its file (e.g. after the link expired). Returns the same photo id; nothing new is added to the tour. (a fixed format)

Example: create_photo_upload { "tourId": "…", "filename": "kitchen.jpg", "photoType": "360_mono" }

get_photo_status · Check photo status

Check whether photos added with add_photo_from_url or create_photo_upload are ready. Each photo is pending_upload (run its upload command), processing (call again in a few seconds), ready, failed (with a reason; the photo has been removed from the tour), or not_found. generated says whether the photo was sent as AI-generated. One call waits up to about 10 seconds for photos that are still processing. Keep calling until every photo is ready or failed (allSettled is true).

tourId · string · required

The tour id, as list_tours returns it. (up to 32 characters, a fixed format)

photoIds · list of string · required

Up to 20 photo ids returned by add_photo_from_url or create_photo_upload. (at least 1 item, up to 20 items)

Example: get_photo_status { "tourId": "…", "photoIds": ["…"] }

update_scene · Rename a scene

Sets the title of one photo (scene) in a tour, as Organize Photos does in the Orbix360 web editor. Get the tour id and scene ids from get_tour. The title is trimmed and may be up to 200 characters. Returns the tour's scenes in order afterwards.

tourId · string · required

The tour id, as list_tours and get_tour list it. (at least 1 character)

sceneId · string or integer · required

The scene (photo) id, as get_tour lists it.

title · string · required

The new scene title.

Example: update_scene { "tourId": "…", "sceneId": "…", "title": "Kitchen" }

reorder_scenes · Reorder scenes

Sets the order of a multi-image tour's photos (scenes), as Organize Photos does in the Orbix360 web editor. `order` must list every scene id from get_tour exactly once, first scene first. A photo still shown under a position placeholder such as "Photo 3" keeps that title. Returns the scenes in the new order.

Every scene id exactly once.

tourId · string · required

The tour id, as list_tours and get_tour list it. (at least 1 character)

order · list of string or integer · required

Every scene id of the tour exactly once, in the new order. (at least 1 item, up to 500 items)

Example: reorder_scenes { "tourId": "…", "order": ["…", "…", "…"] }

set_scene_heading · Set the direction a scene opens on

Sets the direction a visitor first faces when a scene opens, as Change Orientation does in the Orbix360 web editor, and regenerates the scene's thumbnail from the photo looking that way. yaw is in degrees on the scene's photo (0 = the photo's centre column, positive to the right; any value is wrapped into (-180, 180]), the same coordinates render_view draws: find the place with render_view and pass its yaw. pitch (default 0) only tilts the thumbnail; every scene opens level with the horizon. The tour's first scene's thumbnail is the tour's card image and share image. The photo must be ready (see get_photo_status). Look at the result with render_view centred on the heading if needed.

Also regenerates the scene's thumbnail; the first scene's is the tour's card.

tourId · string · required

The tour id, as list_tours returns it. (up to 32 characters, a fixed format)

sceneId · string or integer · required

The scene (photo) id, as get_tour lists it.

yaw · number · required

The direction to open on, degrees; 0 = the photo's centre column, positive to the right. Wrapped into (-180, 180].

pitch · number · optional

Tilts the thumbnail only, degrees; 0 = horizon, +90 = straight up. Not stored. Default 0. (at least -90, at most 90)

Example: set_scene_heading { "tourId": "…", "sceneId": "…", "yaw": 40 }

delete_scene · Delete a scene

Permanently deletes one photo (scene) from a multi-image tour, with its image files and every navigation hotspot that leads to it. This cannot be undone. A tour always keeps at least one photo. Get the tour id and scene ids from get_tour. Returns the remaining scenes in order.

Cannot be undone; a tour always keeps one photo.

tourId · string · required

The tour id, as list_tours and get_tour list it. (at least 1 character)

sceneId · string or integer · required

The scene (photo) id, as get_tour lists it.

Example: delete_scene { "tourId": "…", "sceneId": "…" }

render_panorama · See a whole scene

Renders one of your scenes' whole 360° photo, flattened into a 2048 × 1024 picture (equirectangular: x is yaw from -180 at the left through 0 at the centre to 180 at the right, where yaw 0 = the photo's centre column, not the scene's opening direction; y is pitch from +90 at the top to -90 at the bottom), with a yaw scale every 30° along the top, pitch marks on the left, and the existing navigation hotspots (N1…), info hotspots (I1…) and flat-image outlines (F1…) labelled and listed with their full ids and coordinates. A cheap first look to see the room layout; then use render_view to look closer before placing anything, since the panorama is distorted near the top and bottom. Clients that limit picture size may shrink it. Works on your private tours; the photo must be ready (see get_photo_status).

tourId · string · required

The tour id, as list_tours returns it. (up to 32 characters, a fixed format)

sceneId · string or integer · required

The scene (photo) id, as get_tour lists it.

Example: render_panorama { "tourId": "…", "sceneId": "…" }

render_view · Look at a scene

Renders what a visitor sees in one of your scenes looking in a direction, as a JPEG picture you can look at, so you can find things (a door, a fireplace) and read their position before placing a hotspot. The picture is an undistorted 4:3 view centred on yaw / pitch (degrees on the scene's panorama: yaw 0 = the photo's centre column, not the scene's opening direction, positive to the right; pitch 0 = the horizon, +90 = straight up), fov degrees wide (horizontal, 30-120, default 90). Gridlines every 30° are labelled with their yaw (meridians) and pitch (parallels) values, so a point between two lines can be interpolated; existing navigation hotspots (N1…), info hotspots (I1…) and flat-image outlines (F1…) are drawn and listed with their full ids and coordinates in the answer. To check a position, render again centred on it: the point is then at the centre of the picture. Use render_panorama first for a cheap look at the whole scene. Works on your private tours; the photo must be ready (see get_photo_status).

Renders have their own per-minute and per-hour limit.

tourId · string · required

The tour id, as list_tours returns it. (up to 32 characters, a fixed format)

sceneId · string or integer · required

The scene (photo) id, as get_tour lists it.

yaw · number · optional

Direction to look, degrees; 0 = the photo's centre column, positive to the right. Any value is wrapped into (-180, 180]. Default 0.

pitch · number · optional

Up / down, degrees; 0 = horizon, +90 = straight up. Default 0. (at least -90, at most 90)

fov · number · optional

Horizontal field of view in degrees (30-120); smaller zooms in. Default 90. (at least 30, at most 120)

width · integer · optional

Picture width in pixels (256-1568); the height is three quarters of it. Default 1024. (at least 256, at most 1568)

showHotspots · boolean · optional

Draw existing hotspots and flat-image outlines with their labels. Default true.

grid · boolean · optional

Draw the 30° yaw / pitch gridlines. Default true.

Example: render_view { "tourId": "…", "sceneId": "…", "yaw": 40, "pitch": -5, "fov": 60 }

add_nav_hotspot · Link two scenes

Adds a navigation hotspot in one scene of a multi-image tour that takes visitors to another scene, as the web editor's Navigation Hotspots panel does. Get scene ids from get_tour and read the place (a doorway, a path) off render_view first. A pair of scenes has at most one link each way: calling again for the same pair moves the existing link. Give returnYaw and returnPitch to also place the link back from toSceneId to fromSceneId in the same call. Returns the hotspot(s) and a link that opens the tour on the scene.

tourId · string · required

The tour id, as list_tours and get_tour list it. (at least 1 character)

fromSceneId · string or integer · required

The scene the hotspot is placed in.

toSceneId · string or integer · required

The scene the hotspot leads to (another scene of the same tour).

yaw · number · required

Where the hotspot sits in fromSceneId: degrees on the scene's photo: 0 = the photo's centre column, positive to the right; any value is wrapped into (-180, 180].

pitch · number · required

Where the hotspot sits in fromSceneId: degrees: 0 = the horizon, +90 = straight up, -90 = straight down. (at least -90, at most 90)

returnYaw · number · optional

Optional: where the way back sits in toSceneId (give with returnPitch): degrees on the scene's photo: 0 = the photo's centre column, positive to the right; any value is wrapped into (-180, 180].

returnPitch · number · optional

Optional: where the way back sits in toSceneId (give with returnYaw): degrees: 0 = the horizon, +90 = straight up, -90 = straight down. (at least -90, at most 90)

Example: add_nav_hotspot { "tourId": "…", "fromSceneId": "…", "toSceneId": "…", "yaw": 40, "pitch": -5, "returnYaw": -150, "returnPitch": -3 }

add_info_hotspot · Add an info hotspot

Adds an info hotspot to a scene: an icon visitors open to read a title and a description, as the web editor's Info Hotspots panel does. Get scene ids from get_tour and read the place off render_view first. Title: up to 50 characters; description: up to 2,000 characters, newlines kept. Text is plain: any HTML markup is removed. iconStyle "dark" draws a dark icon for bright backgrounds (default "light"). Works on single-image tours too. Returns the stored hotspot.

tourId · string · required

The tour id, as list_tours and get_tour list it. (at least 1 character)

sceneId · string or integer · required

A scene (photo) id, as get_tour lists it.

yaw · number · required

Where the hotspot sits: degrees on the scene's photo: 0 = the photo's centre column, positive to the right; any value is wrapped into (-180, 180].

pitch · number · required

Where the hotspot sits: degrees: 0 = the horizon, +90 = straight up, -90 = straight down. (at least -90, at most 90)

title · string · required

Up to 50 characters of plain text. (up to 1000 characters)

description · string · optional

Up to 2,000 characters of plain text; newlines are kept. (up to 20000 characters)

iconStyle · one of: light, dark · optional

"light" (default) or "dark".

Example: add_info_hotspot { "tourId": "…", "sceneId": "…", "yaw": 10, "pitch": -20, "title": "Wood stove" }

update_info_hotspot · Change an info hotspot

Changes an existing info hotspot: any of title (up to 50 characters), description (up to 2,000), iconStyle, and its place (yaw with pitch). Only the fields you give change. Get hotspot ids from get_tour (infoHotspots). An info hotspot stays in its scene: to put it in another scene, remove it and add a new one. Returns the hotspot as stored.

tourId · string · required

The tour id, as list_tours and get_tour list it. (at least 1 character)

hotspotId · string · required

The info hotspot id, as get_tour lists it. (at least 1 character, up to 200 characters)

sceneId · string or integer · optional

Optional: the hotspot's own scene (refused if it is another scene).

title · string · optional

Up to 50 characters of plain text. (up to 1000 characters)

description · string · optional

Up to 2,000 characters of plain text. (up to 20000 characters)

iconStyle · one of: light, dark · optional

"light" or "dark".

yaw · number · optional

The new place (give with pitch): degrees on the scene's photo: 0 = the photo's centre column, positive to the right; any value is wrapped into (-180, 180].

pitch · number · optional

The new place (give with yaw): degrees: 0 = the horizon, +90 = straight up, -90 = straight down. (at least -90, at most 90)

Example: update_info_hotspot { "tourId": "…", "hotspotId": "…", "description": "Installed 2024." }

remove_hotspot · Remove a hotspot

Removes one navigation or info hotspot from a tour. Get hotspot ids from get_tour (navHotspots, infoHotspots). Removing a navigation link leaves the link back from the other scene in place; remove it too if you want both gone. Flat images are removed with remove_flat_image.

tourId · string · required

The tour id, as list_tours and get_tour list it. (at least 1 character)

hotspotId · string · required

The navigation or info hotspot id, as get_tour lists it. (at least 1 character, up to 200 characters)

Example: remove_hotspot { "tourId": "…", "hotspotId": "…" }

add_flat_image · Place a flat image

Places a flat picture (a logo, a sign, a floor plan) in a scene, as the web editor's Flat Images panel does. url must be a public https address of a JPEG, PNG or WebP image of at most 20 MB; it is stored with the tour (shrunk to at most 4096 px; PNG and WebP keep their transparency). Get scene ids from get_tour and choose the place with render_view; render_view then shows the picture's outline. scale 0.5 – 2 (default 1) sets its size, rotation (degrees) turns it in its own plane. Returns the stored flat image.

tourId · string · required

The tour id, as list_tours and get_tour list it. (at least 1 character)

sceneId · string or integer · required

A scene (photo) id, as get_tour lists it.

url · string · required

A public https address of a JPEG, PNG or WebP image (at most 20 MB). (at least 1 character, up to 2048 characters)

yaw · number · required

Where the picture's centre sits: degrees on the scene's photo: 0 = the photo's centre column, positive to the right; any value is wrapped into (-180, 180].

pitch · number · required

Where the picture's centre sits: degrees: 0 = the horizon, +90 = straight up, -90 = straight down. (at least -90, at most 90)

scale · number · optional

Size: 0.5 – 2, default 1. (at least 0.5, at most 2)

rotation · number · optional

Turn in the picture's own plane, degrees (stored in [0, 360)); default 0.

Example: add_flat_image { "tourId": "…", "sceneId": "…", "url": "https://example.com/floor-plan.png", "yaw": 0, "pitch": 0 }

update_flat_image · Change a flat image

Changes an existing flat image: scale (0.5 – 2), rotation (degrees, absolute) and its place (yaw with pitch). Only the fields you give change. Get flat image ids from get_tour (flatImages). To use another picture, remove this one and add a new one.

tourId · string · required

The tour id, as list_tours and get_tour list it. (at least 1 character)

flatImageId · string · required

The flat image id, as get_tour lists it. (at least 1 character, up to 200 characters)

scale · number · optional

Size: 0.5 – 2. (at least 0.5, at most 2)

rotation · number · optional

Turn in the picture's own plane, degrees (absolute, stored in [0, 360)).

yaw · number · optional

The new place (give with pitch): degrees on the scene's photo: 0 = the photo's centre column, positive to the right; any value is wrapped into (-180, 180].

pitch · number · optional

The new place (give with yaw): degrees: 0 = the horizon, +90 = straight up, -90 = straight down. (at least -90, at most 90)

Example: update_flat_image { "tourId": "…", "flatImageId": "…", "scale": 1.5 }

remove_flat_image · Remove a flat image

Removes one flat image from its scene. Get flat image ids from get_tour (flatImages).

tourId · string · required

The tour id, as list_tours and get_tour list it. (at least 1 character)

flatImageId · string · required

The flat image id, as get_tour lists it. (at least 1 character, up to 200 characters)

Example: remove_flat_image { "tourId": "…", "flatImageId": "…" }