{"components":{"schemas":{"ErrorResponse":{"additionalProperties":false,"description":"Structured machine-readable error payload returned for 4xx and 5xx responses.","properties":{"error":{"additionalProperties":false,"properties":{"code":{"description":"Stable uppercase machine-readable error code.","example":"INVALID_QUERY","type":"string"},"hint":{"description":"Actionable guidance for resolving the error.","type":"string"},"message":{"description":"Human-readable explanation of the error.","type":"string"},"request_id":{"description":"Unique identifier for tracing this request.","type":"string"}},"required":["code","message"],"type":"object"}},"required":["error"],"type":"object"},"MediaValidationRequest":{"additionalProperties":false,"description":"Photo, video, and optional keepsake note parameters to check against Photo96 limits.","properties":{"keepsake_message":{"description":"Optional keepsake note shown below the scanned photo (max 120 characters).","maxLength":120,"type":"string"},"photo_format":{"description":"Photo extension or MIME type (jpg, jpeg, png, heic, heif, webp).","example":"jpg","type":"string"},"photo_size_mb":{"description":"Photo size in megabytes (maximum 100 MB).","example":8.5,"minimum":0,"type":"number"},"sandbox":{"description":"Optional test-mode flag. All /v1/* endpoints are already stateless and never touch production orders.","type":"boolean"},"video_codec":{"description":"Optional video codec such as h264, hevc, or vp9.","example":"h264","type":"string"},"video_format":{"description":"Video extension or MIME type (mp4, mov, webm).","example":"mp4","type":"string"},"video_size_mb":{"description":"Video size in megabytes (maximum 500 MB).","example":42,"minimum":0,"type":"number"}},"required":["photo_format","video_format"],"type":"object"},"MediaValidationResponse":{"additionalProperties":false,"properties":{"compatible":{"type":"boolean"},"errors":{"items":{"type":"string"},"type":"array"},"message_ok":{"type":"boolean"},"next_step_url":{"format":"uri","type":"string"},"photo_ok":{"type":"boolean"},"sandbox":{"type":"boolean"},"video_ok":{"type":"boolean"},"warnings":{"items":{"type":"string"},"type":"array"}},"required":["compatible","photo_ok","video_ok","message_ok","errors","warnings","next_step_url","sandbox"],"type":"object"},"NlwebAskRequest":{"additionalProperties":false,"properties":{"prefer":{"additionalProperties":false,"properties":{"limit":{"description":"Maximum passages to return (1-15, default 5).","maximum":15,"minimum":1,"type":"integer"},"streaming":{"description":"Set true to receive Server-Sent Events (text/event-stream).","type":"boolean"}},"type":"object"},"query":{"additionalProperties":false,"properties":{"text":{"description":"Natural-language question about Photo96.","maxLength":2000,"minLength":1,"type":"string"}},"required":["text"],"type":"object"}},"required":["query"],"type":"object"},"NlwebAskResponse":{"additionalProperties":false,"properties":{"_meta":{"additionalProperties":false,"properties":{"request_id":{"type":"string"},"response_format":{"type":"string"},"response_type":{"type":"string"},"version":{"type":"string"}},"required":["response_type","version","request_id"],"type":"object"},"results":{"items":{"additionalProperties":false,"properties":{"@type":{"type":"string"},"description":{"type":"string"},"name":{"type":"string"},"score":{"type":"number"},"site":{"type":"string"},"url":{"format":"uri","type":"string"}},"required":["@type","url","name","site","score","description"],"type":"object"},"type":"array"}},"required":["_meta","results"],"type":"object"},"OccasionListResponse":{"additionalProperties":false,"properties":{"category":{"type":"string"},"occasions":{"items":{"additionalProperties":false,"properties":{"category":{"type":"string"},"kind":{"enum":["occasion","gift_guide"],"type":"string"},"slug":{"type":"string"},"summary":{"type":"string"},"title":{"type":"string"},"url":{"format":"uri","type":"string"}},"required":["slug","title","kind","category","url","summary"],"type":"object"},"type":"array"},"total":{"type":"integer"}},"required":["category","total","occasions"],"type":"object"},"PageListResponse":{"additionalProperties":false,"properties":{"items":{"items":{"additionalProperties":false,"properties":{"canonical":{"format":"uri","type":"string"},"description":{"type":"string"},"markdown_url":{"format":"uri","type":"string"},"slug":{"type":"string"},"title":{"type":"string"}},"required":["slug","title","description","canonical","markdown_url"],"type":"object"},"type":"array"},"pagination":{"additionalProperties":false,"properties":{"cursor":{"nullable":true,"type":"string"},"has_more":{"type":"boolean"},"limit":{"type":"integer"},"next_cursor":{"nullable":true,"type":"string"},"total":{"type":"integer"}},"required":["limit","total","has_more","next_cursor"],"type":"object"}},"required":["items","pagination"],"type":"object"},"PricingResponse":{"additionalProperties":false,"properties":{"ai_video_generation":{"type":"boolean"},"billing_model":{"type":"string"},"checkout_url":{"format":"uri","type":"string"},"currency":{"type":"string"},"demo_scanner_url":{"format":"uri","type":"string"},"includes":{"items":{"type":"string"},"type":"array"},"photo_formats":{"items":{"type":"string"},"type":"array"},"photo_max_mb":{"type":"integer"},"price_display":{"type":"string"},"price_usd":{"type":"number"},"printing_included":{"type":"boolean"},"recommended_video_codec":{"type":"string"},"refund_policy_url":{"format":"uri","type":"string"},"video_formats":{"items":{"type":"string"},"type":"array"},"video_max_mb":{"type":"integer"}},"required":["price_usd","price_display","currency","billing_model","includes","photo_formats","photo_max_mb","video_formats","video_max_mb","recommended_video_codec","printing_included","ai_video_generation","checkout_url","demo_scanner_url","refund_policy_url"],"type":"object"}}},"externalDocs":{"description":"Photo96 Developer & Agent Documentation","url":"https://photo96.com/docs"},"info":{"contact":{"email":"support@photo96.com","name":"Photo96 Support","url":"https://photo96.com/contact"},"description":"Public, keyless, read-only and stateless sandbox endpoints for AI agents and integrations interacting with Photo96 (pricing, page catalog, occasion guides, media spec validation, and NLWeb v0.55 search). No API key or signup is required. Versioned via URL path (/v1/...) and X-API-Version response headers; breaking changes follow a minimum 90-day deprecation window announced with RFC 8594 Deprecation and Sunset headers. Rate-limit metadata is returned via RateLimit, RateLimit-Limit, RateLimit-Remaining, and RateLimit-Reset headers (plus Retry-After on 429). Orders and payment happen exclusively in the user's browser at https://photo96.com/#create.","title":"Photo96 Public Agent & Catalog API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/ask":{"get":{"description":"Search Photo96's published product pages, pricing, policies, and gift guides using NLWeb v0.55 over GET. Keyless and safe to call directly.","operationId":"askPhoto96Get","parameters":[{"description":"Natural-language question about Photo96.","in":"query","name":"query","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Maximum results to return (1-15, default 5).","in":"query","name":"limit","required":false,"schema":{"default":5,"maximum":15,"minimum":1,"type":"integer"}},{"description":"Set true to stream results as SSE events.","in":"query","name":"streaming","required":false,"schema":{"default":false,"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NlwebAskResponse"}}},"description":"Ranked website passages matching the query.","headers":{"Deprecation":{"description":"RFC 8594 deprecation date header emitted if a public endpoint version is ever scheduled for retirement.","schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit structured header showing request quota, remaining calls, and reset window in seconds.","schema":{"example":"limit=120, remaining=119, reset=60","type":"string"}},"RateLimit-Limit":{"description":"Maximum public read requests per 60-second window per IP.","schema":{"example":120,"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current 60-second window.","schema":{"example":119,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current rate-limit window resets.","schema":{"example":60,"type":"integer"}},"Sunset":{"description":"RFC 8594 Sunset HTTP-date indicating at least 90 days notice before a deprecated major version is removed.","schema":{"type":"string"}},"X-API-Version":{"description":"Dated revision of Photo96's public read-only agent interface.","schema":{"example":"2026-11-01","type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Invalid query parameter or JSON request payload.","headers":{"Deprecation":{"description":"RFC 8594 deprecation date header emitted if a public endpoint version is ever scheduled for retirement.","schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit structured header showing request quota, remaining calls, and reset window in seconds.","schema":{"example":"limit=120, remaining=119, reset=60","type":"string"}},"RateLimit-Limit":{"description":"Maximum public read requests per 60-second window per IP.","schema":{"example":120,"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current 60-second window.","schema":{"example":119,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current rate-limit window resets.","schema":{"example":60,"type":"integer"}},"Sunset":{"description":"RFC 8594 Sunset HTTP-date indicating at least 90 days notice before a deprecated major version is removed.","schema":{"type":"string"}},"X-API-Version":{"description":"Dated revision of Photo96's public read-only agent interface.","schema":{"example":"2026-11-01","type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Requested public resource or page slug was not found.","headers":{"Deprecation":{"description":"RFC 8594 deprecation date header emitted if a public endpoint version is ever scheduled for retirement.","schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit structured header showing request quota, remaining calls, and reset window in seconds.","schema":{"example":"limit=120, remaining=119, reset=60","type":"string"}},"RateLimit-Limit":{"description":"Maximum public read requests per 60-second window per IP.","schema":{"example":120,"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current 60-second window.","schema":{"example":119,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current rate-limit window resets.","schema":{"example":60,"type":"integer"}},"Sunset":{"description":"RFC 8594 Sunset HTTP-date indicating at least 90 days notice before a deprecated major version is removed.","schema":{"type":"string"}},"X-API-Version":{"description":"Dated revision of Photo96's public read-only agent interface.","schema":{"example":"2026-11-01","type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Rate limit exceeded. Wait Retry-After seconds before retrying.","headers":{"Deprecation":{"description":"RFC 8594 deprecation date header emitted if a public endpoint version is ever scheduled for retirement.","schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit structured header showing request quota, remaining calls, and reset window in seconds.","schema":{"example":"limit=120, remaining=119, reset=60","type":"string"}},"RateLimit-Limit":{"description":"Maximum public read requests per 60-second window per IP.","schema":{"example":120,"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current 60-second window.","schema":{"example":119,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current rate-limit window resets.","schema":{"example":60,"type":"integer"}},"Sunset":{"description":"RFC 8594 Sunset HTTP-date indicating at least 90 days notice before a deprecated major version is removed.","schema":{"type":"string"}},"X-API-Version":{"description":"Dated revision of Photo96's public read-only agent interface.","schema":{"example":"2026-11-01","type":"string"}},"Retry-After":{"description":"Number of seconds to wait before retrying the request.","schema":{"example":60,"type":"integer"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unexpected server error.","headers":{"Deprecation":{"description":"RFC 8594 deprecation date header emitted if a public endpoint version is ever scheduled for retirement.","schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit structured header showing request quota, remaining calls, and reset window in seconds.","schema":{"example":"limit=120, remaining=119, reset=60","type":"string"}},"RateLimit-Limit":{"description":"Maximum public read requests per 60-second window per IP.","schema":{"example":120,"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current 60-second window.","schema":{"example":119,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current rate-limit window resets.","schema":{"example":60,"type":"integer"}},"Sunset":{"description":"RFC 8594 Sunset HTTP-date indicating at least 90 days notice before a deprecated major version is removed.","schema":{"type":"string"}},"X-API-Version":{"description":"Dated revision of Photo96's public read-only agent interface.","schema":{"example":"2026-11-01","type":"string"}}}}},"summary":"Search Photo96 content with NLWeb v0.55 (GET)"},"post":{"description":"Search Photo96's published product pages, pricing, policies, and gift guides using NLWeb v0.55 over POST JSON or SSE streaming.","operationId":"askPhoto96Post","parameters":[{"description":"Optional client-generated idempotency key (UUID or opaque token up to 128 chars) echoed back for safe agent retries.","in":"header","name":"Idempotency-Key","required":false,"schema":{"maxLength":128,"minLength":1,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NlwebAskRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NlwebAskResponse"}}},"description":"Ranked website passages matching the query.","headers":{"Deprecation":{"description":"RFC 8594 deprecation date header emitted if a public endpoint version is ever scheduled for retirement.","schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit structured header showing request quota, remaining calls, and reset window in seconds.","schema":{"example":"limit=120, remaining=119, reset=60","type":"string"}},"RateLimit-Limit":{"description":"Maximum public read requests per 60-second window per IP.","schema":{"example":120,"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current 60-second window.","schema":{"example":119,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current rate-limit window resets.","schema":{"example":60,"type":"integer"}},"Sunset":{"description":"RFC 8594 Sunset HTTP-date indicating at least 90 days notice before a deprecated major version is removed.","schema":{"type":"string"}},"X-API-Version":{"description":"Dated revision of Photo96's public read-only agent interface.","schema":{"example":"2026-11-01","type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Invalid query parameter or JSON request payload.","headers":{"Deprecation":{"description":"RFC 8594 deprecation date header emitted if a public endpoint version is ever scheduled for retirement.","schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit structured header showing request quota, remaining calls, and reset window in seconds.","schema":{"example":"limit=120, remaining=119, reset=60","type":"string"}},"RateLimit-Limit":{"description":"Maximum public read requests per 60-second window per IP.","schema":{"example":120,"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current 60-second window.","schema":{"example":119,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current rate-limit window resets.","schema":{"example":60,"type":"integer"}},"Sunset":{"description":"RFC 8594 Sunset HTTP-date indicating at least 90 days notice before a deprecated major version is removed.","schema":{"type":"string"}},"X-API-Version":{"description":"Dated revision of Photo96's public read-only agent interface.","schema":{"example":"2026-11-01","type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Requested public resource or page slug was not found.","headers":{"Deprecation":{"description":"RFC 8594 deprecation date header emitted if a public endpoint version is ever scheduled for retirement.","schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit structured header showing request quota, remaining calls, and reset window in seconds.","schema":{"example":"limit=120, remaining=119, reset=60","type":"string"}},"RateLimit-Limit":{"description":"Maximum public read requests per 60-second window per IP.","schema":{"example":120,"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current 60-second window.","schema":{"example":119,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current rate-limit window resets.","schema":{"example":60,"type":"integer"}},"Sunset":{"description":"RFC 8594 Sunset HTTP-date indicating at least 90 days notice before a deprecated major version is removed.","schema":{"type":"string"}},"X-API-Version":{"description":"Dated revision of Photo96's public read-only agent interface.","schema":{"example":"2026-11-01","type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Rate limit exceeded. Wait Retry-After seconds before retrying.","headers":{"Deprecation":{"description":"RFC 8594 deprecation date header emitted if a public endpoint version is ever scheduled for retirement.","schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit structured header showing request quota, remaining calls, and reset window in seconds.","schema":{"example":"limit=120, remaining=119, reset=60","type":"string"}},"RateLimit-Limit":{"description":"Maximum public read requests per 60-second window per IP.","schema":{"example":120,"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current 60-second window.","schema":{"example":119,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current rate-limit window resets.","schema":{"example":60,"type":"integer"}},"Sunset":{"description":"RFC 8594 Sunset HTTP-date indicating at least 90 days notice before a deprecated major version is removed.","schema":{"type":"string"}},"X-API-Version":{"description":"Dated revision of Photo96's public read-only agent interface.","schema":{"example":"2026-11-01","type":"string"}},"Retry-After":{"description":"Number of seconds to wait before retrying the request.","schema":{"example":60,"type":"integer"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unexpected server error.","headers":{"Deprecation":{"description":"RFC 8594 deprecation date header emitted if a public endpoint version is ever scheduled for retirement.","schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit structured header showing request quota, remaining calls, and reset window in seconds.","schema":{"example":"limit=120, remaining=119, reset=60","type":"string"}},"RateLimit-Limit":{"description":"Maximum public read requests per 60-second window per IP.","schema":{"example":120,"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current 60-second window.","schema":{"example":119,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current rate-limit window resets.","schema":{"example":60,"type":"integer"}},"Sunset":{"description":"RFC 8594 Sunset HTTP-date indicating at least 90 days notice before a deprecated major version is removed.","schema":{"type":"string"}},"X-API-Version":{"description":"Dated revision of Photo96's public read-only agent interface.","schema":{"example":"2026-11-01","type":"string"}}}}},"summary":"Search Photo96 content with NLWeb v0.55 (POST)"}},"/v1/ask":{"get":{"description":"Versioned v1 alias for NLWeb v0.55 GET search across Photo96's public website catalog.","operationId":"askPhoto96V1Get","parameters":[{"description":"Natural-language question about Photo96.","in":"query","name":"query","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Maximum results to return (1-15, default 5).","in":"query","name":"limit","required":false,"schema":{"default":5,"maximum":15,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NlwebAskResponse"}}},"description":"Ranked website passages matching the query.","headers":{"Deprecation":{"description":"RFC 8594 deprecation date header emitted if a public endpoint version is ever scheduled for retirement.","schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit structured header showing request quota, remaining calls, and reset window in seconds.","schema":{"example":"limit=120, remaining=119, reset=60","type":"string"}},"RateLimit-Limit":{"description":"Maximum public read requests per 60-second window per IP.","schema":{"example":120,"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current 60-second window.","schema":{"example":119,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current rate-limit window resets.","schema":{"example":60,"type":"integer"}},"Sunset":{"description":"RFC 8594 Sunset HTTP-date indicating at least 90 days notice before a deprecated major version is removed.","schema":{"type":"string"}},"X-API-Version":{"description":"Dated revision of Photo96's public read-only agent interface.","schema":{"example":"2026-11-01","type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Invalid query parameter or JSON request payload.","headers":{"Deprecation":{"description":"RFC 8594 deprecation date header emitted if a public endpoint version is ever scheduled for retirement.","schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit structured header showing request quota, remaining calls, and reset window in seconds.","schema":{"example":"limit=120, remaining=119, reset=60","type":"string"}},"RateLimit-Limit":{"description":"Maximum public read requests per 60-second window per IP.","schema":{"example":120,"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current 60-second window.","schema":{"example":119,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current rate-limit window resets.","schema":{"example":60,"type":"integer"}},"Sunset":{"description":"RFC 8594 Sunset HTTP-date indicating at least 90 days notice before a deprecated major version is removed.","schema":{"type":"string"}},"X-API-Version":{"description":"Dated revision of Photo96's public read-only agent interface.","schema":{"example":"2026-11-01","type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Requested public resource or page slug was not found.","headers":{"Deprecation":{"description":"RFC 8594 deprecation date header emitted if a public endpoint version is ever scheduled for retirement.","schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit structured header showing request quota, remaining calls, and reset window in seconds.","schema":{"example":"limit=120, remaining=119, reset=60","type":"string"}},"RateLimit-Limit":{"description":"Maximum public read requests per 60-second window per IP.","schema":{"example":120,"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current 60-second window.","schema":{"example":119,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current rate-limit window resets.","schema":{"example":60,"type":"integer"}},"Sunset":{"description":"RFC 8594 Sunset HTTP-date indicating at least 90 days notice before a deprecated major version is removed.","schema":{"type":"string"}},"X-API-Version":{"description":"Dated revision of Photo96's public read-only agent interface.","schema":{"example":"2026-11-01","type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Rate limit exceeded. Wait Retry-After seconds before retrying.","headers":{"Deprecation":{"description":"RFC 8594 deprecation date header emitted if a public endpoint version is ever scheduled for retirement.","schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit structured header showing request quota, remaining calls, and reset window in seconds.","schema":{"example":"limit=120, remaining=119, reset=60","type":"string"}},"RateLimit-Limit":{"description":"Maximum public read requests per 60-second window per IP.","schema":{"example":120,"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current 60-second window.","schema":{"example":119,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current rate-limit window resets.","schema":{"example":60,"type":"integer"}},"Sunset":{"description":"RFC 8594 Sunset HTTP-date indicating at least 90 days notice before a deprecated major version is removed.","schema":{"type":"string"}},"X-API-Version":{"description":"Dated revision of Photo96's public read-only agent interface.","schema":{"example":"2026-11-01","type":"string"}},"Retry-After":{"description":"Number of seconds to wait before retrying the request.","schema":{"example":60,"type":"integer"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unexpected server error.","headers":{"Deprecation":{"description":"RFC 8594 deprecation date header emitted if a public endpoint version is ever scheduled for retirement.","schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit structured header showing request quota, remaining calls, and reset window in seconds.","schema":{"example":"limit=120, remaining=119, reset=60","type":"string"}},"RateLimit-Limit":{"description":"Maximum public read requests per 60-second window per IP.","schema":{"example":120,"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current 60-second window.","schema":{"example":119,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current rate-limit window resets.","schema":{"example":60,"type":"integer"}},"Sunset":{"description":"RFC 8594 Sunset HTTP-date indicating at least 90 days notice before a deprecated major version is removed.","schema":{"type":"string"}},"X-API-Version":{"description":"Dated revision of Photo96's public read-only agent interface.","schema":{"example":"2026-11-01","type":"string"}}}}},"summary":"Search Photo96 content (v1 GET)"},"post":{"description":"Versioned v1 alias for NLWeb v0.55 POST search with optional Idempotency-Key header support.","operationId":"askPhoto96V1Post","parameters":[{"description":"Optional client-generated idempotency key (UUID or opaque token up to 128 chars) echoed back for safe agent retries.","in":"header","name":"Idempotency-Key","required":false,"schema":{"maxLength":128,"minLength":1,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NlwebAskRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NlwebAskResponse"}}},"description":"Ranked website passages matching the query.","headers":{"Deprecation":{"description":"RFC 8594 deprecation date header emitted if a public endpoint version is ever scheduled for retirement.","schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit structured header showing request quota, remaining calls, and reset window in seconds.","schema":{"example":"limit=120, remaining=119, reset=60","type":"string"}},"RateLimit-Limit":{"description":"Maximum public read requests per 60-second window per IP.","schema":{"example":120,"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current 60-second window.","schema":{"example":119,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current rate-limit window resets.","schema":{"example":60,"type":"integer"}},"Sunset":{"description":"RFC 8594 Sunset HTTP-date indicating at least 90 days notice before a deprecated major version is removed.","schema":{"type":"string"}},"X-API-Version":{"description":"Dated revision of Photo96's public read-only agent interface.","schema":{"example":"2026-11-01","type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Invalid query parameter or JSON request payload.","headers":{"Deprecation":{"description":"RFC 8594 deprecation date header emitted if a public endpoint version is ever scheduled for retirement.","schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit structured header showing request quota, remaining calls, and reset window in seconds.","schema":{"example":"limit=120, remaining=119, reset=60","type":"string"}},"RateLimit-Limit":{"description":"Maximum public read requests per 60-second window per IP.","schema":{"example":120,"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current 60-second window.","schema":{"example":119,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current rate-limit window resets.","schema":{"example":60,"type":"integer"}},"Sunset":{"description":"RFC 8594 Sunset HTTP-date indicating at least 90 days notice before a deprecated major version is removed.","schema":{"type":"string"}},"X-API-Version":{"description":"Dated revision of Photo96's public read-only agent interface.","schema":{"example":"2026-11-01","type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Requested public resource or page slug was not found.","headers":{"Deprecation":{"description":"RFC 8594 deprecation date header emitted if a public endpoint version is ever scheduled for retirement.","schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit structured header showing request quota, remaining calls, and reset window in seconds.","schema":{"example":"limit=120, remaining=119, reset=60","type":"string"}},"RateLimit-Limit":{"description":"Maximum public read requests per 60-second window per IP.","schema":{"example":120,"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current 60-second window.","schema":{"example":119,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current rate-limit window resets.","schema":{"example":60,"type":"integer"}},"Sunset":{"description":"RFC 8594 Sunset HTTP-date indicating at least 90 days notice before a deprecated major version is removed.","schema":{"type":"string"}},"X-API-Version":{"description":"Dated revision of Photo96's public read-only agent interface.","schema":{"example":"2026-11-01","type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Rate limit exceeded. Wait Retry-After seconds before retrying.","headers":{"Deprecation":{"description":"RFC 8594 deprecation date header emitted if a public endpoint version is ever scheduled for retirement.","schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit structured header showing request quota, remaining calls, and reset window in seconds.","schema":{"example":"limit=120, remaining=119, reset=60","type":"string"}},"RateLimit-Limit":{"description":"Maximum public read requests per 60-second window per IP.","schema":{"example":120,"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current 60-second window.","schema":{"example":119,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current rate-limit window resets.","schema":{"example":60,"type":"integer"}},"Sunset":{"description":"RFC 8594 Sunset HTTP-date indicating at least 90 days notice before a deprecated major version is removed.","schema":{"type":"string"}},"X-API-Version":{"description":"Dated revision of Photo96's public read-only agent interface.","schema":{"example":"2026-11-01","type":"string"}},"Retry-After":{"description":"Number of seconds to wait before retrying the request.","schema":{"example":60,"type":"integer"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unexpected server error.","headers":{"Deprecation":{"description":"RFC 8594 deprecation date header emitted if a public endpoint version is ever scheduled for retirement.","schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit structured header showing request quota, remaining calls, and reset window in seconds.","schema":{"example":"limit=120, remaining=119, reset=60","type":"string"}},"RateLimit-Limit":{"description":"Maximum public read requests per 60-second window per IP.","schema":{"example":120,"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current 60-second window.","schema":{"example":119,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current rate-limit window resets.","schema":{"example":60,"type":"integer"}},"Sunset":{"description":"RFC 8594 Sunset HTTP-date indicating at least 90 days notice before a deprecated major version is removed.","schema":{"type":"string"}},"X-API-Version":{"description":"Dated revision of Photo96's public read-only agent interface.","schema":{"example":"2026-11-01","type":"string"}}}}},"summary":"Search Photo96 content (v1 POST)"}},"/v1/occasions":{"get":{"description":"List Photo96 occasion pages and gift guides (wedding, family, baby, friend, memorial) with optional category filter.","operationId":"listPhoto96Occasions","parameters":[{"description":"Optional category filter: all, wedding, family, baby, friend, or memorial.","in":"query","name":"category","required":false,"schema":{"default":"all","enum":["all","wedding","family","baby","friend","memorial"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OccasionListResponse"}}},"description":"Matching occasion pages and gift guides.","headers":{"Deprecation":{"description":"RFC 8594 deprecation date header emitted if a public endpoint version is ever scheduled for retirement.","schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit structured header showing request quota, remaining calls, and reset window in seconds.","schema":{"example":"limit=120, remaining=119, reset=60","type":"string"}},"RateLimit-Limit":{"description":"Maximum public read requests per 60-second window per IP.","schema":{"example":120,"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current 60-second window.","schema":{"example":119,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current rate-limit window resets.","schema":{"example":60,"type":"integer"}},"Sunset":{"description":"RFC 8594 Sunset HTTP-date indicating at least 90 days notice before a deprecated major version is removed.","schema":{"type":"string"}},"X-API-Version":{"description":"Dated revision of Photo96's public read-only agent interface.","schema":{"example":"2026-11-01","type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Invalid query parameter or JSON request payload.","headers":{"Deprecation":{"description":"RFC 8594 deprecation date header emitted if a public endpoint version is ever scheduled for retirement.","schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit structured header showing request quota, remaining calls, and reset window in seconds.","schema":{"example":"limit=120, remaining=119, reset=60","type":"string"}},"RateLimit-Limit":{"description":"Maximum public read requests per 60-second window per IP.","schema":{"example":120,"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current 60-second window.","schema":{"example":119,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current rate-limit window resets.","schema":{"example":60,"type":"integer"}},"Sunset":{"description":"RFC 8594 Sunset HTTP-date indicating at least 90 days notice before a deprecated major version is removed.","schema":{"type":"string"}},"X-API-Version":{"description":"Dated revision of Photo96's public read-only agent interface.","schema":{"example":"2026-11-01","type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Requested public resource or page slug was not found.","headers":{"Deprecation":{"description":"RFC 8594 deprecation date header emitted if a public endpoint version is ever scheduled for retirement.","schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit structured header showing request quota, remaining calls, and reset window in seconds.","schema":{"example":"limit=120, remaining=119, reset=60","type":"string"}},"RateLimit-Limit":{"description":"Maximum public read requests per 60-second window per IP.","schema":{"example":120,"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current 60-second window.","schema":{"example":119,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current rate-limit window resets.","schema":{"example":60,"type":"integer"}},"Sunset":{"description":"RFC 8594 Sunset HTTP-date indicating at least 90 days notice before a deprecated major version is removed.","schema":{"type":"string"}},"X-API-Version":{"description":"Dated revision of Photo96's public read-only agent interface.","schema":{"example":"2026-11-01","type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Rate limit exceeded. Wait Retry-After seconds before retrying.","headers":{"Deprecation":{"description":"RFC 8594 deprecation date header emitted if a public endpoint version is ever scheduled for retirement.","schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit structured header showing request quota, remaining calls, and reset window in seconds.","schema":{"example":"limit=120, remaining=119, reset=60","type":"string"}},"RateLimit-Limit":{"description":"Maximum public read requests per 60-second window per IP.","schema":{"example":120,"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current 60-second window.","schema":{"example":119,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current rate-limit window resets.","schema":{"example":60,"type":"integer"}},"Sunset":{"description":"RFC 8594 Sunset HTTP-date indicating at least 90 days notice before a deprecated major version is removed.","schema":{"type":"string"}},"X-API-Version":{"description":"Dated revision of Photo96's public read-only agent interface.","schema":{"example":"2026-11-01","type":"string"}},"Retry-After":{"description":"Number of seconds to wait before retrying the request.","schema":{"example":60,"type":"integer"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unexpected server error.","headers":{"Deprecation":{"description":"RFC 8594 deprecation date header emitted if a public endpoint version is ever scheduled for retirement.","schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit structured header showing request quota, remaining calls, and reset window in seconds.","schema":{"example":"limit=120, remaining=119, reset=60","type":"string"}},"RateLimit-Limit":{"description":"Maximum public read requests per 60-second window per IP.","schema":{"example":120,"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current 60-second window.","schema":{"example":119,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current rate-limit window resets.","schema":{"example":60,"type":"integer"}},"Sunset":{"description":"RFC 8594 Sunset HTTP-date indicating at least 90 days notice before a deprecated major version is removed.","schema":{"type":"string"}},"X-API-Version":{"description":"Dated revision of Photo96's public read-only agent interface.","schema":{"example":"2026-11-01","type":"string"}}}}},"summary":"List Photo96 gift occasions and guides"}},"/v1/pages":{"get":{"description":"List published Photo96 documentation, pricing, policy, and gift guide pages using cursor-based pagination.","operationId":"listPhoto96Pages","parameters":[{"description":"Opaque pagination cursor returned by a previous page's pagination.next_cursor field.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"Page size (1-25, default 10).","in":"query","name":"limit","required":false,"schema":{"default":10,"maximum":25,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageListResponse"}}},"description":"Cursor-paginated list of public Photo96 pages.","headers":{"Deprecation":{"description":"RFC 8594 deprecation date header emitted if a public endpoint version is ever scheduled for retirement.","schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit structured header showing request quota, remaining calls, and reset window in seconds.","schema":{"example":"limit=120, remaining=119, reset=60","type":"string"}},"RateLimit-Limit":{"description":"Maximum public read requests per 60-second window per IP.","schema":{"example":120,"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current 60-second window.","schema":{"example":119,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current rate-limit window resets.","schema":{"example":60,"type":"integer"}},"Sunset":{"description":"RFC 8594 Sunset HTTP-date indicating at least 90 days notice before a deprecated major version is removed.","schema":{"type":"string"}},"X-API-Version":{"description":"Dated revision of Photo96's public read-only agent interface.","schema":{"example":"2026-11-01","type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Invalid query parameter or JSON request payload.","headers":{"Deprecation":{"description":"RFC 8594 deprecation date header emitted if a public endpoint version is ever scheduled for retirement.","schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit structured header showing request quota, remaining calls, and reset window in seconds.","schema":{"example":"limit=120, remaining=119, reset=60","type":"string"}},"RateLimit-Limit":{"description":"Maximum public read requests per 60-second window per IP.","schema":{"example":120,"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current 60-second window.","schema":{"example":119,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current rate-limit window resets.","schema":{"example":60,"type":"integer"}},"Sunset":{"description":"RFC 8594 Sunset HTTP-date indicating at least 90 days notice before a deprecated major version is removed.","schema":{"type":"string"}},"X-API-Version":{"description":"Dated revision of Photo96's public read-only agent interface.","schema":{"example":"2026-11-01","type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Requested public resource or page slug was not found.","headers":{"Deprecation":{"description":"RFC 8594 deprecation date header emitted if a public endpoint version is ever scheduled for retirement.","schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit structured header showing request quota, remaining calls, and reset window in seconds.","schema":{"example":"limit=120, remaining=119, reset=60","type":"string"}},"RateLimit-Limit":{"description":"Maximum public read requests per 60-second window per IP.","schema":{"example":120,"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current 60-second window.","schema":{"example":119,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current rate-limit window resets.","schema":{"example":60,"type":"integer"}},"Sunset":{"description":"RFC 8594 Sunset HTTP-date indicating at least 90 days notice before a deprecated major version is removed.","schema":{"type":"string"}},"X-API-Version":{"description":"Dated revision of Photo96's public read-only agent interface.","schema":{"example":"2026-11-01","type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Rate limit exceeded. Wait Retry-After seconds before retrying.","headers":{"Deprecation":{"description":"RFC 8594 deprecation date header emitted if a public endpoint version is ever scheduled for retirement.","schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit structured header showing request quota, remaining calls, and reset window in seconds.","schema":{"example":"limit=120, remaining=119, reset=60","type":"string"}},"RateLimit-Limit":{"description":"Maximum public read requests per 60-second window per IP.","schema":{"example":120,"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current 60-second window.","schema":{"example":119,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current rate-limit window resets.","schema":{"example":60,"type":"integer"}},"Sunset":{"description":"RFC 8594 Sunset HTTP-date indicating at least 90 days notice before a deprecated major version is removed.","schema":{"type":"string"}},"X-API-Version":{"description":"Dated revision of Photo96's public read-only agent interface.","schema":{"example":"2026-11-01","type":"string"}},"Retry-After":{"description":"Number of seconds to wait before retrying the request.","schema":{"example":60,"type":"integer"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unexpected server error.","headers":{"Deprecation":{"description":"RFC 8594 deprecation date header emitted if a public endpoint version is ever scheduled for retirement.","schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit structured header showing request quota, remaining calls, and reset window in seconds.","schema":{"example":"limit=120, remaining=119, reset=60","type":"string"}},"RateLimit-Limit":{"description":"Maximum public read requests per 60-second window per IP.","schema":{"example":120,"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current 60-second window.","schema":{"example":119,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current rate-limit window resets.","schema":{"example":60,"type":"integer"}},"Sunset":{"description":"RFC 8594 Sunset HTTP-date indicating at least 90 days notice before a deprecated major version is removed.","schema":{"type":"string"}},"X-API-Version":{"description":"Dated revision of Photo96's public read-only agent interface.","schema":{"example":"2026-11-01","type":"string"}}}}},"summary":"List public Photo96 pages (cursor-paginated)"}},"/v1/pricing":{"get":{"description":"Return Photo96's one-time USD price, included features, supported photo/video formats, file size caps, live demo scanner URL, and digital-only scope.","operationId":"getPhoto96Pricing","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PricingResponse"}}},"description":"Current Photo96 pricing and media specifications.","headers":{"Deprecation":{"description":"RFC 8594 deprecation date header emitted if a public endpoint version is ever scheduled for retirement.","schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit structured header showing request quota, remaining calls, and reset window in seconds.","schema":{"example":"limit=120, remaining=119, reset=60","type":"string"}},"RateLimit-Limit":{"description":"Maximum public read requests per 60-second window per IP.","schema":{"example":120,"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current 60-second window.","schema":{"example":119,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current rate-limit window resets.","schema":{"example":60,"type":"integer"}},"Sunset":{"description":"RFC 8594 Sunset HTTP-date indicating at least 90 days notice before a deprecated major version is removed.","schema":{"type":"string"}},"X-API-Version":{"description":"Dated revision of Photo96's public read-only agent interface.","schema":{"example":"2026-11-01","type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Invalid query parameter or JSON request payload.","headers":{"Deprecation":{"description":"RFC 8594 deprecation date header emitted if a public endpoint version is ever scheduled for retirement.","schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit structured header showing request quota, remaining calls, and reset window in seconds.","schema":{"example":"limit=120, remaining=119, reset=60","type":"string"}},"RateLimit-Limit":{"description":"Maximum public read requests per 60-second window per IP.","schema":{"example":120,"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current 60-second window.","schema":{"example":119,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current rate-limit window resets.","schema":{"example":60,"type":"integer"}},"Sunset":{"description":"RFC 8594 Sunset HTTP-date indicating at least 90 days notice before a deprecated major version is removed.","schema":{"type":"string"}},"X-API-Version":{"description":"Dated revision of Photo96's public read-only agent interface.","schema":{"example":"2026-11-01","type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Requested public resource or page slug was not found.","headers":{"Deprecation":{"description":"RFC 8594 deprecation date header emitted if a public endpoint version is ever scheduled for retirement.","schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit structured header showing request quota, remaining calls, and reset window in seconds.","schema":{"example":"limit=120, remaining=119, reset=60","type":"string"}},"RateLimit-Limit":{"description":"Maximum public read requests per 60-second window per IP.","schema":{"example":120,"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current 60-second window.","schema":{"example":119,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current rate-limit window resets.","schema":{"example":60,"type":"integer"}},"Sunset":{"description":"RFC 8594 Sunset HTTP-date indicating at least 90 days notice before a deprecated major version is removed.","schema":{"type":"string"}},"X-API-Version":{"description":"Dated revision of Photo96's public read-only agent interface.","schema":{"example":"2026-11-01","type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Rate limit exceeded. Wait Retry-After seconds before retrying.","headers":{"Deprecation":{"description":"RFC 8594 deprecation date header emitted if a public endpoint version is ever scheduled for retirement.","schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit structured header showing request quota, remaining calls, and reset window in seconds.","schema":{"example":"limit=120, remaining=119, reset=60","type":"string"}},"RateLimit-Limit":{"description":"Maximum public read requests per 60-second window per IP.","schema":{"example":120,"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current 60-second window.","schema":{"example":119,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current rate-limit window resets.","schema":{"example":60,"type":"integer"}},"Sunset":{"description":"RFC 8594 Sunset HTTP-date indicating at least 90 days notice before a deprecated major version is removed.","schema":{"type":"string"}},"X-API-Version":{"description":"Dated revision of Photo96's public read-only agent interface.","schema":{"example":"2026-11-01","type":"string"}},"Retry-After":{"description":"Number of seconds to wait before retrying the request.","schema":{"example":60,"type":"integer"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unexpected server error.","headers":{"Deprecation":{"description":"RFC 8594 deprecation date header emitted if a public endpoint version is ever scheduled for retirement.","schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit structured header showing request quota, remaining calls, and reset window in seconds.","schema":{"example":"limit=120, remaining=119, reset=60","type":"string"}},"RateLimit-Limit":{"description":"Maximum public read requests per 60-second window per IP.","schema":{"example":120,"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current 60-second window.","schema":{"example":119,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current rate-limit window resets.","schema":{"example":60,"type":"integer"}},"Sunset":{"description":"RFC 8594 Sunset HTTP-date indicating at least 90 days notice before a deprecated major version is removed.","schema":{"type":"string"}},"X-API-Version":{"description":"Dated revision of Photo96's public read-only agent interface.","schema":{"example":"2026-11-01","type":"string"}}}}},"summary":"Get Photo96 one-time pricing and upload limits"}},"/v1/validate-media":{"post":{"description":"Stateless sandbox endpoint to verify whether a photo format, video format, file sizes, optional codec, and keepsake note meet Photo96's upload limits and browser playback guidance. Accepts optional Idempotency-Key header and never creates a paid order.","operationId":"validatePhoto96Media","parameters":[{"description":"Optional client-generated idempotency key (UUID or opaque token up to 128 chars) echoed back for safe agent retries.","in":"header","name":"Idempotency-Key","required":false,"schema":{"maxLength":128,"minLength":1,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaValidationRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaValidationResponse"}}},"description":"Compatibility check result with errors, warnings, and next-step browser link.","headers":{"Deprecation":{"description":"RFC 8594 deprecation date header emitted if a public endpoint version is ever scheduled for retirement.","schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit structured header showing request quota, remaining calls, and reset window in seconds.","schema":{"example":"limit=120, remaining=119, reset=60","type":"string"}},"RateLimit-Limit":{"description":"Maximum public read requests per 60-second window per IP.","schema":{"example":120,"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current 60-second window.","schema":{"example":119,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current rate-limit window resets.","schema":{"example":60,"type":"integer"}},"Sunset":{"description":"RFC 8594 Sunset HTTP-date indicating at least 90 days notice before a deprecated major version is removed.","schema":{"type":"string"}},"X-API-Version":{"description":"Dated revision of Photo96's public read-only agent interface.","schema":{"example":"2026-11-01","type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Invalid query parameter or JSON request payload.","headers":{"Deprecation":{"description":"RFC 8594 deprecation date header emitted if a public endpoint version is ever scheduled for retirement.","schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit structured header showing request quota, remaining calls, and reset window in seconds.","schema":{"example":"limit=120, remaining=119, reset=60","type":"string"}},"RateLimit-Limit":{"description":"Maximum public read requests per 60-second window per IP.","schema":{"example":120,"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current 60-second window.","schema":{"example":119,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current rate-limit window resets.","schema":{"example":60,"type":"integer"}},"Sunset":{"description":"RFC 8594 Sunset HTTP-date indicating at least 90 days notice before a deprecated major version is removed.","schema":{"type":"string"}},"X-API-Version":{"description":"Dated revision of Photo96's public read-only agent interface.","schema":{"example":"2026-11-01","type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Requested public resource or page slug was not found.","headers":{"Deprecation":{"description":"RFC 8594 deprecation date header emitted if a public endpoint version is ever scheduled for retirement.","schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit structured header showing request quota, remaining calls, and reset window in seconds.","schema":{"example":"limit=120, remaining=119, reset=60","type":"string"}},"RateLimit-Limit":{"description":"Maximum public read requests per 60-second window per IP.","schema":{"example":120,"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current 60-second window.","schema":{"example":119,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current rate-limit window resets.","schema":{"example":60,"type":"integer"}},"Sunset":{"description":"RFC 8594 Sunset HTTP-date indicating at least 90 days notice before a deprecated major version is removed.","schema":{"type":"string"}},"X-API-Version":{"description":"Dated revision of Photo96's public read-only agent interface.","schema":{"example":"2026-11-01","type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Rate limit exceeded. Wait Retry-After seconds before retrying.","headers":{"Deprecation":{"description":"RFC 8594 deprecation date header emitted if a public endpoint version is ever scheduled for retirement.","schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit structured header showing request quota, remaining calls, and reset window in seconds.","schema":{"example":"limit=120, remaining=119, reset=60","type":"string"}},"RateLimit-Limit":{"description":"Maximum public read requests per 60-second window per IP.","schema":{"example":120,"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current 60-second window.","schema":{"example":119,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current rate-limit window resets.","schema":{"example":60,"type":"integer"}},"Sunset":{"description":"RFC 8594 Sunset HTTP-date indicating at least 90 days notice before a deprecated major version is removed.","schema":{"type":"string"}},"X-API-Version":{"description":"Dated revision of Photo96's public read-only agent interface.","schema":{"example":"2026-11-01","type":"string"}},"Retry-After":{"description":"Number of seconds to wait before retrying the request.","schema":{"example":60,"type":"integer"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unexpected server error.","headers":{"Deprecation":{"description":"RFC 8594 deprecation date header emitted if a public endpoint version is ever scheduled for retirement.","schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit structured header showing request quota, remaining calls, and reset window in seconds.","schema":{"example":"limit=120, remaining=119, reset=60","type":"string"}},"RateLimit-Limit":{"description":"Maximum public read requests per 60-second window per IP.","schema":{"example":120,"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current 60-second window.","schema":{"example":119,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current rate-limit window resets.","schema":{"example":60,"type":"integer"}},"Sunset":{"description":"RFC 8594 Sunset HTTP-date indicating at least 90 days notice before a deprecated major version is removed.","schema":{"type":"string"}},"X-API-Version":{"description":"Dated revision of Photo96's public read-only agent interface.","schema":{"example":"2026-11-01","type":"string"}}}}},"summary":"Validate photo and video specs (stateless sandbox)"}}},"servers":[{"description":"Production public keyless endpoints (read-only & stateless sandbox)","url":"https://photo96.com"}]}