Registry

Write cached lens output into a photo's EXIF/IPTC/XMP metadata

Embeds cached lens output (from a prior /v2/analyze call) into the photo's EXIF/IPTC/XMP metadata blocks so the analysis travels with the file. The enriched bytes carry their structured intelligence in standard metadata fields any downstream tool can read, with no further Phototology call required to access the analysis.

Source-of-truth gate

Requires a cached registry entry for the (userId, sha256). If the photo has not been analyzed before, returns 404 PHOTO_NOT_IN_REGISTRY. The endpoint does NOT trigger analysis; call POST /v2/analyze first.

Cost

5 credits per call. Matches the bespoke schema extraction tier. Bills regardless of cache state; the write-back work is its own billable operation.

C2PA signing

Deferred. c2pa in the formats array is rejected at validation time with a structured deferred-feature message. Provenance signing requires the Railway c2patool binary, a CA-chained cert, and a KMS-backed key (see packages/phototology/CLAUDE.md Sprint 3 follow-ups). Use ["exif", "iptc", "xmp"] for now.

post/v2/enrich

Request

  • Base URL: https://api.phototology.com
  • URL: https://api.phototology.com/v2/enrich
  • Auth: HTTP bearer

Request body

imageUrlstring uri
imageBase64string
formatsstring[] required
preserveCredentialsboolean

Response

Enriched photo returned as base64 in the response body. The caller decodes and saves to disk.

object'enrichment' required
mode'file' | 'sidecar' required
imageBase64string
formatsWrittenstring[] required
reasonstring
warningsstring[]
lensVersionsobject required
sha256string required
registryIdstring

Changes

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