Objects

Tool results hold these objects as JSON. Every field is always present. A field with no value is null. Times are ISO 8601 strings in UTC.

The REST API returns the same Image and Album objects. The REST schemas show them with a field browser.

Image

A picture synced by Auto Photos. Returned when source is auto_photos.

Field	Type	Notes
id	string
url	string | null	Signed URL of the best display size. Works for 15 minutes.
mimeType	string | null	MIME type of url.
renditions	object	Each size by name, as { url, mimeType, size, pixelWidth, pixelHeight }. Empty in lists and searches. Filled by get_image.
capturedAt	string | null	When the picture was taken.
latitude	number | null
longitude	number | null
placeLabel	string | null	A readable place name.
isScreenshot	boolean | null
pixelWidth	integer | null
pixelHeight	integer | null
description	string | null	What the picture shows, written by Auto.
details	string[]	Short facts, such as text read from the picture.
distanceMeters	number | null	Distance from the circle center. Set on circle searches.
score	number | null	Match strength. Set on searches with a query.
matchedText	string | null	The text that matched on the text channel.
albumIds	string[]	Albums the picture is in.

Rendition names: webp-full, webp-medium (longest side 1200 px) and webp-thumb (512 px). The original is never served.

{
  "id": "img_123",
  "url": "https://app.auto.inc/api/ext/v2/images/img_123/renditions/webp-medium?exp=1792000000000&sig=...",
  "mimeType": "image/webp",
  "renditions": {},
  "capturedAt": "2026-04-12T18:22:05.000Z",
  "latitude": 38.7139,
  "longitude": -9.1334,
  "placeLabel": "Alfama, Lisbon",
  "isScreenshot": false,
  "pixelWidth": 4032,
  "pixelHeight": 3024,
  "description": "A yellow tram climbing a narrow street at sunset.",
  "details": ["Tram 28"],
  "distanceMeters": null,
  "score": 0.41,
  "matchedText": null,
  "albumIds": ["alb_9"]
}

Photo

A picture taken in the original Auto app. Returned when source is auto.

Field	Type	Notes
id	string
owner	object	{ id, name, username, imageUrl }
url	string	Signed URL of the original file. Works for 7 days.
size	integer	Bytes.
mimeType	string
capturedAt	string | null
latitude	number | null
longitude	number | null
title	string | null
description	string | null
descriptions	string[]	Details Auto noted about the photo, newest first.

Album

Field	Type	Notes
id	string
title	string
imageCount	integer	Pictures in the album the user can see.
coverImageId	string | null	The chosen cover. null means the newest picture.
coverScreening	object | null	{ score, modelVersion }. Content screening of the cover, with score from 0 to 1.
coverCloudIdentifier	string | null	The cover's identifier on the user's device.
createdAt	string
updatedAt	string

{
  "id": "alb_9",
  "title": "Lisbon 2026",
  "imageCount": 42,
  "coverImageId": null,
  "coverScreening": null,
  "coverCloudIdentifier": null,
  "createdAt": "2026-04-20T09:00:00.000Z",
  "updatedAt": "2026-04-21T10:15:00.000Z"
}