{"openapi":"3.0.3","info":{"title":"Picsha AI API","description":"Serverless media backend for AI Agents","version":"1.0.120"},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Enter your API Key (sk_...) or Microsoft Entra ID JWT Bearer token."}},"schemas":{}},"paths":{"/v1/assets/debug/s3":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/v1/assets/":{"post":{"summary":"Upload or fetch an asset","tags":["Assets"],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"nullable":true,"type":"object","properties":{"url":{"description":"Direct URL of the external asset to fetch, store, and process.","type":"string","format":"uri"},"s3Key":{"description":"S3 Key of a file already uploaded directly via presigned URL or resumable TUS.","type":"string"},"originalName":{"description":"Original filename for S3 pre-uploaded assets.","type":"string"},"tags":{"description":"Initial tags to attach to the asset.","type":"array","items":{"type":"string"}},"metadata":{"description":"Initial metadata dictionary to attach to the asset.","type":"object","additionalProperties":{}},"config":{"description":"Ingestion pipeline options to customize processing.","type":"object","properties":{"auto_tag":{"description":"Whether to run AWS Rekognition Vision AI for face and object detection. Defaults to true.","type":"boolean"},"auto_summarize":{"description":"Whether to run AI summaries (Claude 3 Haiku for images, Titan/Claude for documents, Amazon Transcribe for audio/video). Defaults to true.","type":"boolean"},"vectorize":{"description":"Whether to generate a Titan multimodal embedding vector for similarity search. Defaults to true.","type":"boolean"},"location_lookup":{"description":"Whether to reverse-geocode EXIF GPS coordinates via Google Maps API. Defaults to true.","type":"boolean"},"adaptive_stream":{"description":"Whether to transcode video to adaptive HLS stream using AWS MediaConvert. Defaults to false.","type":"boolean"},"content_moderation":{"description":"Whether to run AWS Rekognition Content Moderation. Defaults to false (the worker runs it only when explicitly true).","type":"boolean"},"antivirus_scan":{"description":"Whether to run the ClamAV malware scan at ingest. Defaults to true; set false to opt out.","type":"boolean"},"quality_metrics":{"description":"Whether to compute deterministic image quality metrics (sharpness, brightness, contrast, clipping) and face attributes. Defaults to true; set false to opt out.","type":"boolean"},"remove_background":{"description":"Whether to generate a background-removed alpha cutout at ingest for instant background compositing at render time. Defaults to false.","type":"boolean"},"render_on_upload":{"description":"Semicolon-separated delivery parameters to pre-warm the CDN cache (e.g. \"w=300&q=80; w=800\").","type":"string"},"expires_at":{"description":"ISO-8601 timestamp for automatic asset deletion.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}}}}}},"application/json":{"schema":{"nullable":true,"type":"object","properties":{"url":{"description":"Direct URL of the external asset to fetch, store, and process.","type":"string","format":"uri"},"s3Key":{"description":"S3 Key of a file already uploaded directly via presigned URL or resumable TUS.","type":"string"},"originalName":{"description":"Original filename for S3 pre-uploaded assets.","type":"string"},"tags":{"description":"Initial tags to attach to the asset.","type":"array","items":{"type":"string"}},"metadata":{"description":"Initial metadata dictionary to attach to the asset.","type":"object","additionalProperties":{}},"config":{"description":"Ingestion pipeline options to customize processing.","type":"object","properties":{"auto_tag":{"description":"Whether to run AWS Rekognition Vision AI for face and object detection. Defaults to true.","type":"boolean"},"auto_summarize":{"description":"Whether to run AI summaries (Claude 3 Haiku for images, Titan/Claude for documents, Amazon Transcribe for audio/video). Defaults to true.","type":"boolean"},"vectorize":{"description":"Whether to generate a Titan multimodal embedding vector for similarity search. Defaults to true.","type":"boolean"},"location_lookup":{"description":"Whether to reverse-geocode EXIF GPS coordinates via Google Maps API. Defaults to true.","type":"boolean"},"adaptive_stream":{"description":"Whether to transcode video to adaptive HLS stream using AWS MediaConvert. Defaults to false.","type":"boolean"},"content_moderation":{"description":"Whether to run AWS Rekognition Content Moderation. Defaults to false (the worker runs it only when explicitly true).","type":"boolean"},"antivirus_scan":{"description":"Whether to run the ClamAV malware scan at ingest. Defaults to true; set false to opt out.","type":"boolean"},"quality_metrics":{"description":"Whether to compute deterministic image quality metrics (sharpness, brightness, contrast, clipping) and face attributes. Defaults to true; set false to opt out.","type":"boolean"},"remove_background":{"description":"Whether to generate a background-removed alpha cutout at ingest for instant background compositing at render time. Defaults to false.","type":"boolean"},"render_on_upload":{"description":"Semicolon-separated delivery parameters to pre-warm the CDN cache (e.g. \"w=300&q=80; w=800\").","type":"string"},"expires_at":{"description":"ISO-8601 timestamp for automatic asset deletion.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}}}}}}}},"parameters":[{"schema":{"type":"string"},"in":"query","name":"ephemeral","required":false,"description":"If true, asset will be deleted after 24 hours"},{"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"in":"query","name":"expires_at","required":false,"description":"ISO-8601 timestamp for when the asset should be automatically deleted."},{"schema":{"type":"string"},"in":"header","name":"x-org-id","required":false,"description":"Organization ID"},{"schema":{"type":"string"},"in":"header","name":"x-external-user-id","required":false,"description":"External User ID"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"url":{"nullable":true,"type":"string"},"message":{"type":"string"}},"required":["id","message"],"additionalProperties":false}}}},"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"url":{"nullable":true,"type":"string"},"message":{"type":"string"}},"required":["id","message"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}}}},"get":{"summary":"List assets","tags":["Assets"],"parameters":[{"schema":{"default":1,"type":"number"},"in":"query","name":"page","required":false},{"schema":{"default":20,"type":"number","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"tag","required":false},{"schema":{"type":"string"},"in":"query","name":"type","required":false},{"schema":{"type":"string"},"in":"query","name":"search","required":false},{"schema":{"type":"string"},"in":"query","name":"sort","required":false},{"schema":{"type":"string"},"in":"query","name":"albumId","required":false},{"schema":{"type":"string"},"in":"query","name":"status","required":false,"description":"Filter by status; 'trashed' lists the recycle bin"},{"schema":{"type":"string"},"in":"query","name":"ingestKeyId","required":false,"description":"Only assets ingested by this API key (ApiKey.id); \"none\" for session-ingested/legacy assets"},{"schema":{"type":"string"},"in":"query","name":"metadataField","required":false,"description":"Metadata key to filter on (e.g. apiKeyName, uploadSource)"},{"schema":{"type":"string"},"in":"query","name":"metadataValue","required":false,"description":"Required value for metadataField"},{"schema":{"type":"string"},"in":"query","name":"metadata","required":false,"description":"JSON object of exact matches on metadata keys, e.g. {\"asset_status\":\"Retired\"} or {\"asset_visibility\":[\"@all\",\"@sales\"]}; all keys must match, a list of values matches any of them"},{"schema":{"type":"string"},"in":"query","name":"anyOf","required":false,"description":"JSON array of {\"metadata\": {...}} blocks; an asset matches when it satisfies at least one block, combined with the other filters"}],"responses":{"200":{"description":"Default Response"}}}},"/v1/assets/{id}":{"get":{"summary":"Get asset details","tags":["Assets"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}},"patch":{"summary":"Update asset metadata","tags":["Assets"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"type":"object","properties":{"title":{"type":"string"}}},"metadata":{"type":"object","additionalProperties":{}},"tags":{"type":"array","items":{"type":"string"}},"requiresSignature":{"type":"boolean"},"expires_at":{"description":"ISO-8601 timestamp to update the automatic deletion time. Pass null to make permanent.","nullable":true,"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"message":{"type":"string"}},"required":["id","message"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}}}},"delete":{"summary":"Move an asset to the trash (or delete permanently with force=true)","tags":["Assets"],"parameters":[{"schema":{"type":"boolean"},"in":"query","name":"force","required":false,"description":"Skip the trash and permanently delete immediately"},{"schema":{"type":"string"},"in":"path","name":"id","required":true},{"schema":{"type":"string"},"in":"header","name":"x-org-id","required":false,"description":"Organization ID"},{"schema":{"type":"string"},"in":"header","name":"x-external-user-id","required":false,"description":"External User ID"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"message":{"type":"string"},"trashed":{"type":"boolean"},"purgeAt":{"nullable":true,"type":"string"}},"required":["id","message","trashed","purgeAt"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}}}}},"/v1/assets/bulk-delete":{"post":{"summary":"Bulk delete assets","tags":["Assets"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"array","items":{"type":"string"}},"force":{"description":"Skip the trash and permanently delete immediately","type":"boolean"}},"required":["ids"]}}}},"parameters":[{"schema":{"type":"string"},"in":"header","name":"x-org-id","required":false,"description":"Organization ID"},{"schema":{"type":"string"},"in":"header","name":"x-external-user-id","required":false,"description":"External User ID"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"deletedCount":{"type":"number"},"message":{"type":"string"},"trashed":{"type":"boolean"},"purgeAt":{"nullable":true,"type":"string"}},"required":["deletedCount","message","trashed","purgeAt"],"additionalProperties":false}}}}}}},"/v1/assets/{id}/restore":{"post":{"summary":"Restore a trashed asset to its pre-trash state","tags":["Assets"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true},{"schema":{"type":"string"},"in":"header","name":"x-org-id","required":false,"description":"Organization ID"},{"schema":{"type":"string"},"in":"header","name":"x-external-user-id","required":false,"description":"External User ID"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string"},"message":{"type":"string"}},"required":["id","status","message"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}}}}},"/v1/assets/bulk-restore":{"post":{"summary":"Restore multiple trashed assets","tags":["Assets"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"array","items":{"type":"string"}}},"required":["ids"]}}}},"parameters":[{"schema":{"type":"string"},"in":"header","name":"x-org-id","required":false,"description":"Organization ID"},{"schema":{"type":"string"},"in":"header","name":"x-external-user-id","required":false,"description":"External User ID"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"restoredCount":{"type":"number"},"message":{"type":"string"}},"required":["restoredCount","message"],"additionalProperties":false}}}}}}},"/v1/assets/{id}/analyze":{"post":{"summary":"Re-run AI analysis on an asset","tags":["Intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"nullable":true,"type":"object","properties":{"config":{"description":"Processing pipeline options, mirroring ingest config.","type":"object","properties":{"auto_tag":{"description":"Whether to run AWS Rekognition Vision AI for face and object detection. Defaults to true.","type":"boolean"},"auto_summarize":{"description":"Whether to run AI summaries (Claude 3 Haiku for images, Titan/Claude for documents, Amazon Transcribe for audio/video). Defaults to true.","type":"boolean"},"vectorize":{"description":"Whether to generate a multimodal embedding vector for similarity search. Defaults to true.","type":"boolean"},"location_lookup":{"description":"Whether to reverse-geocode EXIF GPS coordinates via Google Maps API. Defaults to true.","type":"boolean"},"quality_metrics":{"description":"Whether to compute image quality metrics during processing.","type":"boolean"}}}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"202":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"message":{"type":"string"}},"required":["id","message"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}}}}},"/v1/assets/analysis":{"post":{"summary":"Batch-fetch full AI analysis for a set of assets","tags":["Assets"],"description":"Returns the complete ingest analysis (EXIF, location, labels, faces, summaries, quality metrics, optional embeddings) for up to 200 assets. Assets the caller is not authorized to read are silently omitted.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"minItems":1,"maxItems":200,"type":"array","items":{"type":"string"}},"includeEmbeddings":{"default":false,"type":"boolean"}},"required":["ids"]}}}},"responses":{"200":{"description":"Default Response"}}}},"/v1/assets/{id}/summarize":{"post":{"summary":"Get the AI summary for an asset (re-queues analysis if none exists)","tags":["Intelligence"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"summary":{"type":"string"},"message":{"type":"string"}},"required":["id","summary","message"],"additionalProperties":false}}}},"202":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"message":{"type":"string"}},"required":["id","message"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}}}}},"/v1/assets/moderation/pending":{"get":{"summary":"List assets pending manual moderation review","tags":["Moderation"],"parameters":[{"schema":{"default":20,"type":"number","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"default":0,"type":"number","minimum":0},"in":"query","name":"offset","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"assets":{"type":"array","items":{}},"total":{"type":"number"}},"required":["assets"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/assets/{id}/moderation":{"post":{"summary":"Approve or Reject an asset pending moderation","tags":["Moderation"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"action":{"type":"string","enum":["approve","reject"]}},"required":["action"]}}}},"parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"asset":{}},"required":["asset"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/assets/{id}/download":{"get":{"summary":"Download an asset or stream it inline to the browser","tags":["Assets"],"parameters":[{"schema":{"default":"false","type":"string","enum":["true","false"]},"in":"query","name":"inline","required":false},{"schema":{"default":"original","type":"string","enum":["original","pdf"]},"in":"query","name":"variant","required":false},{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/assets/presigned":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/v1/assets/{id}/render":{"get":{"parameters":[{"schema":{"type":"number"},"in":"query","name":"w","required":false},{"schema":{"type":"number"},"in":"query","name":"h","required":false},{"schema":{"type":"number"},"in":"query","name":"wd","required":false},{"schema":{"type":"number"},"in":"query","name":"ht","required":false},{"schema":{"type":"string"},"in":"query","name":"ar","required":false},{"schema":{"type":"number","minimum":0.3,"maximum":1000},"in":"query","name":"blur","required":false},{"schema":{"anyOf":[{"type":"number"},{"type":"string","enum":["max"]}]},"in":"query","name":"r","required":false},{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"query","name":"wm","required":false},{"schema":{"type":"number"},"in":"query","name":"wm_w","required":false},{"schema":{"type":"number"},"in":"query","name":"wm_h","required":false},{"schema":{"default":"southeast","type":"string","enum":["top","right","bottom","left","center","northeast","southeast","southwest","northwest"]},"in":"query","name":"wm_pos","required":false},{"schema":{"type":"string","enum":["single","tiled"]},"in":"query","name":"wm_mode","required":false},{"schema":{"type":"string"},"in":"query","name":"wm_text","required":false},{"schema":{"type":"number","minimum":0,"maximum":1},"in":"query","name":"wm_opacity","required":false},{"schema":{"type":"number","minimum":0,"maximum":1},"in":"query","name":"wm_scale","required":false},{"schema":{"type":"number","minimum":1,"maximum":12},"in":"query","name":"wm_density","required":false},{"schema":{"type":"number"},"in":"query","name":"wm_rot","required":false},{"schema":{"type":"string"},"in":"query","name":"wm_color","required":false},{"schema":{"type":"string"},"in":"query","name":"txt","required":false},{"schema":{"type":"string"},"in":"query","name":"txt_font","required":false},{"schema":{"type":"number"},"in":"query","name":"txt_size","required":false},{"schema":{"type":"string"},"in":"query","name":"txt_color","required":false},{"schema":{"type":"string","enum":["top","right","bottom","left","center","northeast","southeast","southwest","northwest"]},"in":"query","name":"txt_pos","required":false},{"schema":{"type":"number"},"in":"query","name":"txt_x","required":false},{"schema":{"type":"number"},"in":"query","name":"txt_y","required":false},{"schema":{"type":"string","enum":["webp","jpeg","jpg","png","avif","auto"]},"in":"query","name":"fmt","required":false},{"schema":{"type":"string","enum":["cover","contain","fill","inside","outside"]},"in":"query","name":"fit","required":false},{"schema":{"type":"string"},"in":"query","name":"crop","required":false},{"schema":{"type":"string","enum":["auto"]},"in":"query","name":"trim","required":false},{"schema":{"type":"string","enum":["top","right","bottom","left","center","northeast","southeast","southwest","northwest","entropy","attention","face"]},"in":"query","name":"pos","required":false},{"schema":{"type":"string"},"in":"query","name":"bg","required":false},{"schema":{"type":"string","enum":["true","false"]},"in":"query","name":"bg_rem","required":false},{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"query","name":"bg_asset","required":false},{"schema":{"type":"string"},"in":"query","name":"gen_rem","required":false},{"schema":{"type":"string"},"in":"query","name":"gen_fill","required":false},{"schema":{"type":"string"},"in":"query","name":"gen_mask","required":false},{"schema":{"type":"string"},"in":"query","name":"mimi","required":false},{"schema":{"type":"string","enum":["lite","standard","4k"]},"in":"query","name":"mimi_mode","required":false},{"schema":{"type":"string","enum":["2k","4k"]},"in":"query","name":"upscale","required":false},{"schema":{"type":"string"},"in":"query","name":"mimi_bg","required":false},{"schema":{"type":"string","enum":["nearest","cubic","mitchell","lanczos2","lanczos3"]},"in":"query","name":"k","required":false},{"schema":{"type":"string","enum":["true","false"]},"in":"query","name":"no_enlarge","required":false},{"schema":{"type":"string","enum":["true","false"]},"in":"query","name":"no_reduce","required":false},{"schema":{"type":"number","minimum":1,"maximum":100},"in":"query","name":"q","required":false},{"schema":{"type":"string","enum":["true","false"]},"in":"query","name":"force","required":false},{"schema":{"type":"string"},"in":"query","name":"t","required":false},{"schema":{"type":"string"},"in":"query","name":"o","required":false},{"schema":{"type":"number"},"in":"query","name":"bri","required":false},{"schema":{"type":"number"},"in":"query","name":"con","required":false},{"schema":{"type":"number"},"in":"query","name":"sat","required":false},{"schema":{"type":"number"},"in":"query","name":"hue","required":false},{"schema":{"type":"string","enum":["true","false"]},"in":"query","name":"gray","required":false},{"schema":{"type":"string"},"in":"query","name":"tint","required":false},{"schema":{"type":"number"},"in":"query","name":"rot","required":false},{"schema":{"type":"string","enum":["true","false"]},"in":"query","name":"flip","required":false},{"schema":{"type":"string","enum":["true","false"]},"in":"query","name":"flop","required":false},{"schema":{"type":"string"},"in":"query","name":"sig","required":false},{"schema":{"type":"number"},"in":"query","name":"exp","required":false},{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/assets/{id}/sign-delivery":{"post":{"summary":"Generate a signed delivery URL for an asset","tags":["Assets","Delivery"],"description":"Returns a signed URL that authorizes delivery of a protected asset with specific transformation parameters.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"urlPath":{"type":"string","description":"The delivery route path, e.g. /v1/assets/as_123/render or /v1/seo/as_123/image.webp"},"queryParams":{"type":"object","additionalProperties":{},"description":"The transformation parameters to sign"}},"required":["urlPath","queryParams"]}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"signedUrl":{"type":"string"},"signature":{"type":"string"}},"required":["signedUrl","signature"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}}}}},"/v1/assets/generate":{"post":{"summary":"Generate a new asset from a text prompt","tags":["Assets"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","minLength":1,"maxLength":4000,"description":"Text description of the image to generate."},"aspect_ratio":{"default":"1:1","description":"Output aspect ratio.","type":"string","enum":["1:1","3:4","4:3","9:16","16:9","2:3","3:2","4:5","5:4"]},"quality":{"default":"standard","description":"Quality tier — same ladder and pricing as MIMI edits.","type":"string","enum":["lite","standard","4k"]},"tags":{"description":"Initial tags to attach to the generated asset.","type":"array","items":{"type":"string"}}},"required":["prompt"]}}}},"parameters":[{"schema":{"type":"string"},"in":"header","name":"x-org-id","required":false,"description":"Organization ID"},{"schema":{"type":"string"},"in":"header","name":"x-external-user-id","required":false,"description":"External User ID"}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"assetId":{"type":"string"},"url":{"type":"string"}},"required":["assetId","url"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}},"402":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}}}}},"/v1/assets/{id}/similar":{"get":{"summary":"Find visually similar assets","tags":["Intelligence"],"description":"The nearest neighbours of the asset's embedding within the caller's tenant, most similar first. The asset itself and trashed assets are never returned.","parameters":[{"schema":{"default":12,"type":"integer","minimum":1,"maximum":50},"in":"query","name":"limit","required":false},{"schema":{"type":"number","minimum":0,"maximum":1},"in":"query","name":"minScore","required":false,"description":"Drop matches scoring below this (0..1). Omitted = keep the nearest `limit` whatever they score"},{"schema":{"type":"string","minLength":1},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"assetId":{"type":"string"},"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"matchScore":{"type":"number"}},"required":["id","matchScore"],"additionalProperties":{}}},"total":{"type":"number"},"reason":{"type":"string"}},"required":["assetId","results","total"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}}}},"post":{"summary":"Find visually similar assets within a filtered scope","tags":["Intelligence"],"description":"As GET, with the same `advancedFilters` and `excludeAssetIds` that POST /v1/search accepts, so the matches can be limited to what the caller's own user may see.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":50},"minScore":{"type":"number","minimum":0,"maximum":1},"advancedFilters":{"type":"object","properties":{"timezone":{"type":"string"},"addedAfter":{"type":"string"},"addedBefore":{"type":"string"},"capturedAfter":{"type":"string"},"capturedBefore":{"type":"string"},"face":{"type":"string"},"object":{"type":"string"},"place":{"type":"string"},"ocr":{"type":"string"},"type":{"description":"MIME type prefix (\"image\", \"image/png\") or a list of prefixes, any of which may match","anyOf":[{"type":"string"},{"maxItems":50,"type":"array","items":{"type":"string"}}]},"style":{"type":"string"},"metadataField":{"type":"string"},"metadataValue":{"type":"string"},"minRating":{"description":"Only assets whose metadata.rating is at least this many stars (1-5)","type":"integer","minimum":1,"maximum":5},"metadata":{"description":"Exact matches on custom metadata keys, e.g. {\"asset_status\": \"Retired\"}; all keys must match. A list of values for a key matches any of them","type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"maxItems":200,"type":"array","items":{"type":"string"}}]}},"anyOf":{"description":"Alternative filter blocks: an asset matches when it satisfies at least one block (max 10); combined with the other filters","maxItems":10,"type":"array","items":{"type":"object","properties":{"timezone":{"type":"string"},"addedAfter":{"type":"string"},"addedBefore":{"type":"string"},"capturedAfter":{"type":"string"},"capturedBefore":{"type":"string"},"face":{"type":"string"},"object":{"type":"string"},"place":{"type":"string"},"ocr":{"type":"string"},"type":{"description":"MIME type prefix (\"image\", \"image/png\") or a list of prefixes, any of which may match","anyOf":[{"type":"string"},{"maxItems":50,"type":"array","items":{"type":"string"}}]},"style":{"type":"string"},"metadataField":{"type":"string"},"metadataValue":{"type":"string"},"minRating":{"description":"Only assets whose metadata.rating is at least this many stars (1-5)","type":"integer","minimum":1,"maximum":5},"metadata":{"description":"Exact matches on custom metadata keys, e.g. {\"asset_status\": \"Retired\"}; all keys must match. A list of values for a key matches any of them","type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"maxItems":200,"type":"array","items":{"type":"string"}}]}}}}}}},"filters":{"type":"object","properties":{"timezone":{"type":"string"},"addedAfter":{"type":"string"},"addedBefore":{"type":"string"},"capturedAfter":{"type":"string"},"capturedBefore":{"type":"string"},"face":{"type":"string"},"object":{"type":"string"},"place":{"type":"string"},"ocr":{"type":"string"},"type":{"description":"MIME type prefix (\"image\", \"image/png\") or a list of prefixes, any of which may match","anyOf":[{"type":"string"},{"maxItems":50,"type":"array","items":{"type":"string"}}]},"style":{"type":"string"},"metadataField":{"type":"string"},"metadataValue":{"type":"string"},"minRating":{"description":"Only assets whose metadata.rating is at least this many stars (1-5)","type":"integer","minimum":1,"maximum":5},"metadata":{"description":"Exact matches on custom metadata keys, e.g. {\"asset_status\": \"Retired\"}; all keys must match. A list of values for a key matches any of them","type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"maxItems":200,"type":"array","items":{"type":"string"}}]}},"anyOf":{"description":"Alternative filter blocks: an asset matches when it satisfies at least one block (max 10); combined with the other filters","maxItems":10,"type":"array","items":{"type":"object","properties":{"timezone":{"type":"string"},"addedAfter":{"type":"string"},"addedBefore":{"type":"string"},"capturedAfter":{"type":"string"},"capturedBefore":{"type":"string"},"face":{"type":"string"},"object":{"type":"string"},"place":{"type":"string"},"ocr":{"type":"string"},"type":{"description":"MIME type prefix (\"image\", \"image/png\") or a list of prefixes, any of which may match","anyOf":[{"type":"string"},{"maxItems":50,"type":"array","items":{"type":"string"}}]},"style":{"type":"string"},"metadataField":{"type":"string"},"metadataValue":{"type":"string"},"minRating":{"description":"Only assets whose metadata.rating is at least this many stars (1-5)","type":"integer","minimum":1,"maximum":5},"metadata":{"description":"Exact matches on custom metadata keys, e.g. {\"asset_status\": \"Retired\"}; all keys must match. A list of values for a key matches any of them","type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"maxItems":200,"type":"array","items":{"type":"string"}}]}}}}}}},"excludeAssetIds":{"description":"Asset ids never returned as matches (max 10000)","maxItems":10000,"type":"array","items":{"type":"string","minLength":1}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"assetId":{"type":"string"},"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"matchScore":{"type":"number"}},"required":["id","matchScore"],"additionalProperties":{}}},"total":{"type":"number"},"reason":{"type":"string"}},"required":["assetId","results","total"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}}}}},"/v1/assets/{id}/stream/{file}":{"get":{"summary":"Get an adaptive (HLS) stream playlist for a video","tags":["Assets"],"description":"Serves the HLS playlists made for a video uploaded with `config.adaptive_stream: true`. Start at `playlist.m3u8`; variant playlists resolve to this route, and media segments are presigned URLs valid for 4 hours. 404 until the transcode has finished.","parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true},{"schema":{"type":"string"},"in":"path","name":"file","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/assets/{id}/adaptive-stream":{"post":{"summary":"Make an adaptive (HLS) stream for an existing video","tags":["Assets"],"description":"Submits the same AWS MediaConvert job an upload with `config.adaptive_stream: true` runs, for a video that was uploaded without it. Only the transcode runs; no other processing is repeated. When the job finishes, GET /v1/assets/:id/stream/playlist.m3u8 serves the stream and `metadata.hls_status` becomes `ready`. A video that already has a stream (recorded, or found in storage, which also records it), or whose job is still running, is left alone unless `force` is true.","requestBody":{"required":true,"content":{"application/json":{"schema":{"nullable":true,"type":"object","properties":{"force":{"description":"Submit a new job even when a stream exists or a job is running.","type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string","enum":["ready"]},"message":{"type":"string"}},"required":["id","status","message"],"additionalProperties":false}}}},"202":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"jobId":{"nullable":true,"type":"string"},"message":{"type":"string"}},"required":["id","status","jobId","message"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}}}}},"/v1/seo/{id}/{seoString}":{"get":{"summary":"SEO friendly image delivery","tags":["Delivery"],"parameters":[{"schema":{"type":"number"},"in":"query","name":"w","required":false},{"schema":{"type":"number"},"in":"query","name":"h","required":false},{"schema":{"type":"number"},"in":"query","name":"wd","required":false},{"schema":{"type":"number"},"in":"query","name":"ht","required":false},{"schema":{"type":"string"},"in":"query","name":"ar","required":false},{"schema":{"type":"number","minimum":0.3,"maximum":1000},"in":"query","name":"blur","required":false},{"schema":{"anyOf":[{"type":"number"},{"type":"string","enum":["max"]}]},"in":"query","name":"r","required":false},{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"query","name":"wm","required":false},{"schema":{"type":"number"},"in":"query","name":"wm_w","required":false},{"schema":{"type":"number"},"in":"query","name":"wm_h","required":false},{"schema":{"default":"southeast","type":"string","enum":["top","right","bottom","left","center","northeast","southeast","southwest","northwest"]},"in":"query","name":"wm_pos","required":false},{"schema":{"type":"string","enum":["single","tiled"]},"in":"query","name":"wm_mode","required":false},{"schema":{"type":"string"},"in":"query","name":"wm_text","required":false},{"schema":{"type":"number","minimum":0,"maximum":1},"in":"query","name":"wm_opacity","required":false},{"schema":{"type":"number","minimum":0,"maximum":1},"in":"query","name":"wm_scale","required":false},{"schema":{"type":"number","minimum":1,"maximum":12},"in":"query","name":"wm_density","required":false},{"schema":{"type":"number"},"in":"query","name":"wm_rot","required":false},{"schema":{"type":"string"},"in":"query","name":"wm_color","required":false},{"schema":{"type":"string"},"in":"query","name":"txt","required":false},{"schema":{"type":"string"},"in":"query","name":"txt_font","required":false},{"schema":{"type":"number"},"in":"query","name":"txt_size","required":false},{"schema":{"type":"string"},"in":"query","name":"txt_color","required":false},{"schema":{"type":"string","enum":["top","right","bottom","left","center","northeast","southeast","southwest","northwest"]},"in":"query","name":"txt_pos","required":false},{"schema":{"type":"number"},"in":"query","name":"txt_x","required":false},{"schema":{"type":"number"},"in":"query","name":"txt_y","required":false},{"schema":{"type":"string","enum":["webp","jpeg","jpg","png","avif","auto"]},"in":"query","name":"fmt","required":false},{"schema":{"type":"string","enum":["cover","contain","fill","inside","outside"]},"in":"query","name":"fit","required":false},{"schema":{"type":"string"},"in":"query","name":"crop","required":false},{"schema":{"type":"string","enum":["auto"]},"in":"query","name":"trim","required":false},{"schema":{"type":"string","enum":["top","right","bottom","left","center","northeast","southeast","southwest","northwest","entropy","attention","face"]},"in":"query","name":"pos","required":false},{"schema":{"type":"string"},"in":"query","name":"bg","required":false},{"schema":{"type":"string","enum":["true","false"]},"in":"query","name":"bg_rem","required":false},{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"query","name":"bg_asset","required":false},{"schema":{"type":"string"},"in":"query","name":"gen_rem","required":false},{"schema":{"type":"string"},"in":"query","name":"gen_fill","required":false},{"schema":{"type":"string"},"in":"query","name":"gen_mask","required":false},{"schema":{"type":"string"},"in":"query","name":"mimi","required":false},{"schema":{"type":"string","enum":["lite","standard","4k"]},"in":"query","name":"mimi_mode","required":false},{"schema":{"type":"string","enum":["2k","4k"]},"in":"query","name":"upscale","required":false},{"schema":{"type":"string"},"in":"query","name":"mimi_bg","required":false},{"schema":{"type":"string","enum":["nearest","cubic","mitchell","lanczos2","lanczos3"]},"in":"query","name":"k","required":false},{"schema":{"type":"string","enum":["true","false"]},"in":"query","name":"no_enlarge","required":false},{"schema":{"type":"string","enum":["true","false"]},"in":"query","name":"no_reduce","required":false},{"schema":{"type":"number","minimum":1,"maximum":100},"in":"query","name":"q","required":false},{"schema":{"type":"string","enum":["true","false"]},"in":"query","name":"force","required":false},{"schema":{"type":"string"},"in":"query","name":"t","required":false},{"schema":{"type":"string"},"in":"query","name":"o","required":false},{"schema":{"type":"number"},"in":"query","name":"bri","required":false},{"schema":{"type":"number"},"in":"query","name":"con","required":false},{"schema":{"type":"number"},"in":"query","name":"sat","required":false},{"schema":{"type":"number"},"in":"query","name":"hue","required":false},{"schema":{"type":"string","enum":["true","false"]},"in":"query","name":"gray","required":false},{"schema":{"type":"string"},"in":"query","name":"tint","required":false},{"schema":{"type":"number"},"in":"query","name":"rot","required":false},{"schema":{"type":"string","enum":["true","false"]},"in":"query","name":"flip","required":false},{"schema":{"type":"string","enum":["true","false"]},"in":"query","name":"flop","required":false},{"schema":{"type":"string"},"in":"query","name":"sig","required":false},{"schema":{"type":"number"},"in":"query","name":"exp","required":false},{"schema":{"type":"string"},"in":"path","name":"id","required":true},{"schema":{"type":"string"},"in":"path","name":"seoString","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/search/":{"post":{"summary":"Search Assets","tags":["Intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"mode":{"default":"standard","type":"string","enum":["standard","ai"]},"threshold":{"type":"number"},"sort":{"default":"relevance","type":"string","enum":["relevance","added-desc","added-asc","created-desc","created-asc","name-asc","name-desc"]},"timezone":{"type":"string"},"advancedFilters":{"type":"object","properties":{"timezone":{"type":"string"},"addedAfter":{"type":"string"},"addedBefore":{"type":"string"},"capturedAfter":{"type":"string"},"capturedBefore":{"type":"string"},"face":{"type":"string"},"object":{"type":"string"},"place":{"type":"string"},"ocr":{"type":"string"},"type":{"description":"MIME type prefix (\"image\", \"image/png\") or a list of prefixes, any of which may match","anyOf":[{"type":"string"},{"maxItems":50,"type":"array","items":{"type":"string"}}]},"style":{"type":"string"},"metadataField":{"type":"string"},"metadataValue":{"type":"string"},"minRating":{"description":"Only assets whose metadata.rating is at least this many stars (1-5)","type":"integer","minimum":1,"maximum":5},"metadata":{"description":"Exact matches on custom metadata keys, e.g. {\"asset_status\": \"Retired\"}; all keys must match. A list of values for a key matches any of them","type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"maxItems":200,"type":"array","items":{"type":"string"}}]}},"anyOf":{"description":"Alternative filter blocks: an asset matches when it satisfies at least one block (max 10); combined with the other filters","maxItems":10,"type":"array","items":{"type":"object","properties":{"timezone":{"type":"string"},"addedAfter":{"type":"string"},"addedBefore":{"type":"string"},"capturedAfter":{"type":"string"},"capturedBefore":{"type":"string"},"face":{"type":"string"},"object":{"type":"string"},"place":{"type":"string"},"ocr":{"type":"string"},"type":{"description":"MIME type prefix (\"image\", \"image/png\") or a list of prefixes, any of which may match","anyOf":[{"type":"string"},{"maxItems":50,"type":"array","items":{"type":"string"}}]},"style":{"type":"string"},"metadataField":{"type":"string"},"metadataValue":{"type":"string"},"minRating":{"description":"Only assets whose metadata.rating is at least this many stars (1-5)","type":"integer","minimum":1,"maximum":5},"metadata":{"description":"Exact matches on custom metadata keys, e.g. {\"asset_status\": \"Retired\"}; all keys must match. A list of values for a key matches any of them","type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"maxItems":200,"type":"array","items":{"type":"string"}}]}}}}}}},"filters":{"type":"object","properties":{"timezone":{"type":"string"},"addedAfter":{"type":"string"},"addedBefore":{"type":"string"},"capturedAfter":{"type":"string"},"capturedBefore":{"type":"string"},"face":{"type":"string"},"object":{"type":"string"},"place":{"type":"string"},"ocr":{"type":"string"},"type":{"description":"MIME type prefix (\"image\", \"image/png\") or a list of prefixes, any of which may match","anyOf":[{"type":"string"},{"maxItems":50,"type":"array","items":{"type":"string"}}]},"style":{"type":"string"},"metadataField":{"type":"string"},"metadataValue":{"type":"string"},"minRating":{"description":"Only assets whose metadata.rating is at least this many stars (1-5)","type":"integer","minimum":1,"maximum":5},"metadata":{"description":"Exact matches on custom metadata keys, e.g. {\"asset_status\": \"Retired\"}; all keys must match. A list of values for a key matches any of them","type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"maxItems":200,"type":"array","items":{"type":"string"}}]}},"anyOf":{"description":"Alternative filter blocks: an asset matches when it satisfies at least one block (max 10); combined with the other filters","maxItems":10,"type":"array","items":{"type":"object","properties":{"timezone":{"type":"string"},"addedAfter":{"type":"string"},"addedBefore":{"type":"string"},"capturedAfter":{"type":"string"},"capturedBefore":{"type":"string"},"face":{"type":"string"},"object":{"type":"string"},"place":{"type":"string"},"ocr":{"type":"string"},"type":{"description":"MIME type prefix (\"image\", \"image/png\") or a list of prefixes, any of which may match","anyOf":[{"type":"string"},{"maxItems":50,"type":"array","items":{"type":"string"}}]},"style":{"type":"string"},"metadataField":{"type":"string"},"metadataValue":{"type":"string"},"minRating":{"description":"Only assets whose metadata.rating is at least this many stars (1-5)","type":"integer","minimum":1,"maximum":5},"metadata":{"description":"Exact matches on custom metadata keys, e.g. {\"asset_status\": \"Retired\"}; all keys must match. A list of values for a key matches any of them","type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"maxItems":200,"type":"array","items":{"type":"string"}}]}}}}}}},"facets":{"description":"Distinct-value counts to compute over the result scope","maxItems":10,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","enum":["faces","labels","places","tags","mimeType","cameraMake","cameraModel"],"description":"Facet source: one of faces, labels, places, tags, mimeType, cameraMake, cameraModel"},"size":{"description":"Max buckets to return (1..1000, default 50)","default":50,"type":"integer","minimum":1,"maximum":1000},"order":{"description":"'count' = most frequent first (default), 'key' = alphabetical","default":"count","type":"string","enum":["count","key"]}},"required":["field"]}},"assetIds":{"description":"Restrict hits, total and facets to these asset ids (max 10000)","maxItems":10000,"type":"array","items":{"type":"string","minLength":1}},"excludeAssetIds":{"description":"Asset ids removed from hits, total and facets (max 10000)","maxItems":10000,"type":"array","items":{"type":"string","minLength":1}}},"required":["query"]}}}},"parameters":[{"schema":{"default":1,"type":"number"},"in":"query","name":"page","required":false},{"schema":{"default":40,"type":"number","minimum":0},"in":"query","name":"limit","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"matchScore":{"type":"number"}},"required":["id"],"additionalProperties":{}}},"pagination":{"type":"object","properties":{"page":{"type":"number"},"limit":{"type":"number"},"total":{"type":"number"}},"required":["page","limit","total"],"additionalProperties":false},"facets":{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"count":{"type":"number"}},"required":["value","count"],"additionalProperties":false}}}},"required":["results"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}}}}},"/v1/sign/":{"post":{"summary":"Generate a signed URL","tags":["Delivery"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"asset_id":{"type":"string"},"transform":{"type":"object","additionalProperties":{}},"expires":{"default":3600,"type":"number"}},"required":["asset_id"]}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"expiresAt":{"type":"string"}},"required":["url","expiresAt"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}}}}},"/v1/jobs/{id}":{"get":{"summary":"Get job status","tags":["Processing"],"parameters":[{"schema":{"type":"number"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"type":{"type":"string"},"status":{"type":"string"},"result":{}},"required":["id","type","status","result"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}}}}},"/v1/rekognition/faces/{faceId}":{"put":{"summary":"Name a face","tags":["Rekognition"],"description":"Names a face and propagates the name to highly similar faces (>= 98% similarity) in the same organization. The face must belong to an asset of the caller's organization; otherwise 404. Every asset showing the face — including deduplicated copies of the same file — is re-synced.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1}},"required":["name"]}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"faceId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"faceId":{"type":"string"},"name":{"type":"string"},"confidence":{"nullable":true,"type":"string"}},"required":["id","faceId","name"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}}}}},"/v1/rekognition/faces/{faceId}/name":{"delete":{"summary":"Clear a face name","tags":["Rekognition"],"description":"Removes the name from this face only — similar faces keep their names. Every asset showing the face is re-synced. 404 when the face does not belong to the caller's organization.","parameters":[{"schema":{"type":"string"},"in":"path","name":"faceId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"faceId":{"type":"string"},"name":{"type":"string","nullable":true,"enum":[null]}},"required":["id","faceId","name"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}}}}},"/v1/fetch/":{"get":{"summary":"Auto-Fetch and Render a remote URL","tags":["Delivery"],"parameters":[{"schema":{"type":"string","format":"uri"},"in":"query","name":"url","required":true},{"schema":{"type":"number"},"in":"query","name":"w","required":false},{"schema":{"type":"number"},"in":"query","name":"h","required":false},{"schema":{"type":"number"},"in":"query","name":"wd","required":false},{"schema":{"type":"number"},"in":"query","name":"ht","required":false},{"schema":{"type":"string"},"in":"query","name":"ar","required":false},{"schema":{"type":"number","minimum":0.3,"maximum":1000},"in":"query","name":"blur","required":false},{"schema":{"anyOf":[{"type":"number"},{"type":"string","enum":["max"]}]},"in":"query","name":"r","required":false},{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"query","name":"wm","required":false},{"schema":{"type":"number"},"in":"query","name":"wm_w","required":false},{"schema":{"type":"number"},"in":"query","name":"wm_h","required":false},{"schema":{"default":"southeast","type":"string","enum":["top","right","bottom","left","center","northeast","southeast","southwest","northwest"]},"in":"query","name":"wm_pos","required":false},{"schema":{"type":"string"},"in":"query","name":"txt","required":false},{"schema":{"type":"string"},"in":"query","name":"txt_font","required":false},{"schema":{"type":"number"},"in":"query","name":"txt_size","required":false},{"schema":{"type":"string"},"in":"query","name":"txt_color","required":false},{"schema":{"type":"string","enum":["top","right","bottom","left","center","northeast","southeast","southwest","northwest"]},"in":"query","name":"txt_pos","required":false},{"schema":{"type":"number"},"in":"query","name":"txt_x","required":false},{"schema":{"type":"number"},"in":"query","name":"txt_y","required":false},{"schema":{"type":"string","enum":["webp","jpeg","png","avif","mp4","webm","gif","auto"]},"in":"query","name":"fmt","required":false},{"schema":{"type":"string","enum":["cover","contain","fill","inside","outside"]},"in":"query","name":"fit","required":false},{"schema":{"type":"string"},"in":"query","name":"crop","required":false},{"schema":{"type":"string","enum":["top","right","bottom","left","center","northeast","southeast","southwest","northwest","entropy","attention","face"]},"in":"query","name":"pos","required":false},{"schema":{"type":"string"},"in":"query","name":"bg","required":false},{"schema":{"type":"string","enum":["true","false"]},"in":"query","name":"bg_rem","required":false},{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"query","name":"bg_asset","required":false},{"schema":{"type":"string"},"in":"query","name":"gen_rem","required":false},{"schema":{"type":"string"},"in":"query","name":"gen_fill","required":false},{"schema":{"type":"string"},"in":"query","name":"mimi","required":false},{"schema":{"type":"string","enum":["lite","standard","4k"]},"in":"query","name":"mimi_mode","required":false},{"schema":{"type":"string","enum":["2k","4k"]},"in":"query","name":"upscale","required":false},{"schema":{"type":"string"},"in":"query","name":"mimi_bg","required":false},{"schema":{"type":"string","enum":["titan","stability"]},"in":"query","name":"ai_model","required":false},{"schema":{"type":"string","enum":["nearest","cubic","mitchell","lanczos2","lanczos3"]},"in":"query","name":"k","required":false},{"schema":{"type":"string","enum":["true","false"]},"in":"query","name":"no_enlarge","required":false},{"schema":{"type":"string","enum":["true","false"]},"in":"query","name":"no_reduce","required":false},{"schema":{"type":"number","minimum":1,"maximum":100},"in":"query","name":"q","required":false},{"schema":{"type":"string","enum":["true","false"]},"in":"query","name":"force","required":false},{"schema":{"type":"string"},"in":"query","name":"o","required":false},{"schema":{"type":"number"},"in":"query","name":"bri","required":false},{"schema":{"type":"number"},"in":"query","name":"con","required":false},{"schema":{"type":"number"},"in":"query","name":"sat","required":false},{"schema":{"type":"number"},"in":"query","name":"hue","required":false},{"schema":{"type":"string","enum":["true","false"]},"in":"query","name":"gray","required":false},{"schema":{"type":"string"},"in":"query","name":"tint","required":false},{"schema":{"type":"number"},"in":"query","name":"rot","required":false},{"schema":{"type":"string","enum":["true","false"]},"in":"query","name":"flip","required":false},{"schema":{"type":"string","enum":["true","false"]},"in":"query","name":"flop","required":false},{"schema":{"type":"string"},"in":"query","name":"download","required":false},{"schema":{"type":"string"},"in":"query","name":"dl","required":false}],"responses":{"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/webhooks/clerk":{"post":{"summary":"Receive Clerk AI User Webhooks","tags":["Webhooks"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/webhooks/":{"get":{"summary":"List webhooks","tags":["Webhooks"],"parameters":[{"schema":{"default":"default-org","type":"string"},"in":"header","name":"x-org-id","required":false},{"schema":{"default":"system","type":"string"},"in":"header","name":"x-external-user-id","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"url":{"type":"string"},"events":{"nullable":true,"type":"array","items":{"type":"string"}},"config":{"nullable":true},"createdAt":{"nullable":true,"type":"string","format":"date-time"}},"required":["id","url","events","config","createdAt"],"additionalProperties":false}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}}}},"post":{"summary":"Register a webhook","tags":["Webhooks"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"events":{"type":"array","items":{"type":"string"}},"secret":{"type":"string"},"config":{"type":"object","properties":{"include_embeddings":{"default":false,"type":"boolean"},"include_text":{"default":false,"type":"boolean"}}}},"required":["url","events"]}}}},"parameters":[{"schema":{"default":"default-org","type":"string"},"in":"header","name":"x-org-id","required":false},{"schema":{"default":"system","type":"string"},"in":"header","name":"x-external-user-id","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"url":{"type":"string"},"events":{"nullable":true,"type":"array","items":{"type":"string"}},"secret":{"nullable":true,"type":"string"},"config":{"nullable":true}},"required":["id","url","events","secret","config"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}}}}},"/v1/webhooks/{id}":{"patch":{"summary":"Update a webhook","tags":["Webhooks"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"events":{"type":"array","items":{"type":"string"}},"config":{"type":"object","properties":{"include_embeddings":{"type":"boolean"},"include_text":{"type":"boolean"}}}}}}}},"parameters":[{"schema":{"type":"number"},"in":"path","name":"id","required":true},{"schema":{"default":"default-org","type":"string"},"in":"header","name":"x-org-id","required":false},{"schema":{"default":"system","type":"string"},"in":"header","name":"x-external-user-id","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"url":{"type":"string"},"events":{"nullable":true,"type":"array","items":{"type":"string"}},"config":{"nullable":true}},"required":["id","url","events","config"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}}}},"delete":{"summary":"Delete a webhook","tags":["Webhooks"],"parameters":[{"schema":{"type":"number"},"in":"path","name":"id","required":true},{"schema":{"default":"default-org","type":"string"},"in":"header","name":"x-org-id","required":false},{"schema":{"default":"system","type":"string"},"in":"header","name":"x-external-user-id","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}}}}},"/v1/webhooks/aws-mediaconvert":{"post":{"summary":"Receive AWS EventBridge webhook for MediaConvert Job State Changes","tags":["Webhooks"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}}}}},"/v1/notifications/stream":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/notifications/stream":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/v1/limits":{"get":{"summary":"Get account limits","tags":["Account"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"storage_gb":{"type":"number"},"ai_requests":{"type":"number"}},"required":["storage_gb","ai_requests"],"additionalProperties":false}}}}}}},"/v1/account/stats":{"get":{"summary":"Get account usage stats and retail costs","tags":["Account"],"responses":{"200":{"description":"Default Response"}}}},"/v1/account/api-keys":{"get":{"summary":"List the caller's API keys (masked) for attribution and management UIs","tags":["Account"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"keys":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"keyPreview":{"type":"string"},"orgId":{"nullable":true,"type":"string"},"createdAt":{"type":"string"},"lastUsed":{"nullable":true,"type":"string"},"revokedAt":{"nullable":true,"type":"string"}},"required":["id","name","keyPreview","orgId","createdAt","lastUsed","revokedAt"],"additionalProperties":false}}},"required":["keys"],"additionalProperties":false}}}}}}},"/v1/upload/resumable":{"get":{"responses":{"200":{"description":"Default Response"}}},"head":{"responses":{"200":{"description":"Default Response"}}},"trace":{"responses":{"200":{"description":"Default Response"}}},"delete":{"responses":{"200":{"description":"Default Response"}}},"options":{"responses":{"200":{"description":"Default Response"}}},"patch":{"responses":{"200":{"description":"Default Response"}}},"put":{"responses":{"200":{"description":"Default Response"}}},"post":{"responses":{"200":{"description":"Default Response"}}}},"/v1/upload/resumable/{*}":{"get":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"*","required":true}],"responses":{"200":{"description":"Default Response"}}},"head":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"*","required":true}],"responses":{"200":{"description":"Default Response"}}},"trace":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"*","required":true}],"responses":{"200":{"description":"Default Response"}}},"delete":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"*","required":true}],"responses":{"200":{"description":"Default Response"}}},"options":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"*","required":true}],"responses":{"200":{"description":"Default Response"}}},"patch":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"*","required":true}],"responses":{"200":{"description":"Default Response"}}},"put":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"*","required":true}],"responses":{"200":{"description":"Default Response"}}},"post":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"*","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/upload/sign":{"post":{"summary":"Get a signed URL for direct S3 upload","tags":["Upload"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"contentType":{"type":"string","description":"MIME type of the file"},"filename":{"description":"Original filename","type":"string"}},"required":["contentType"]}}}},"parameters":[{"schema":{"type":"string"},"in":"header","name":"x-org-id","required":false,"description":"Organization ID"},{"schema":{"type":"string"},"in":"header","name":"x-external-user-id","required":false,"description":"External User ID"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"uploadUrl":{"type":"string"},"assetId":{"type":"string"},"key":{"type":"string"},"method":{"default":"PUT","type":"string"}},"required":["uploadUrl","assetId","key","method"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}}}}},"/v1/upload/multipart":{"post":{"summary":"Start a browser-driven S3 multipart upload","tags":["Upload"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":1024,"description":"Original filename (kept for the caller; the key is random)"},"contentType":{"type":"string","minLength":1,"maxLength":255,"description":"MIME type of the file"},"size":{"description":"Total size in bytes, informational","type":"integer","minimum":0,"maximum":9007199254740991}},"required":["filename","contentType"]}}}},"parameters":[{"schema":{"type":"string"},"in":"header","name":"x-org-id","required":false},{"schema":{"type":"string"},"in":"header","name":"x-external-user-id","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"key":{"type":"string"},"uploadId":{"type":"string"}},"required":["key","uploadId"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}}}},"delete":{"summary":"Abort a multipart upload and discard its parts","tags":["Upload"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"key","required":true},{"schema":{"type":"string","minLength":1,"maxLength":1024},"in":"query","name":"uploadId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"aborted":{"type":"boolean"}},"required":["aborted"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}}}}},"/v1/upload/multipart/sign":{"get":{"summary":"Presign the PUT of one part of a multipart upload","tags":["Upload"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"key","required":true},{"schema":{"type":"string","minLength":1,"maxLength":1024},"in":"query","name":"uploadId","required":true},{"schema":{"type":"integer","minimum":1,"maximum":10000},"in":"query","name":"partNumber","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"expires":{"type":"number"}},"required":["url","expires"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}}}}},"/v1/upload/multipart/parts":{"get":{"summary":"List the parts already uploaded for a multipart upload","tags":["Upload"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"key","required":true},{"schema":{"type":"string","minLength":1,"maxLength":1024},"in":"query","name":"uploadId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"parts":{"type":"array","items":{"type":"object","properties":{"PartNumber":{"type":"number"},"Size":{"type":"number"},"ETag":{"type":"string"}},"required":["PartNumber","Size","ETag"],"additionalProperties":false}}},"required":["parts"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}}}}},"/v1/upload/multipart/complete":{"post":{"summary":"Complete a multipart upload; register the result with POST /v1/assets","tags":["Upload"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"key":{"type":"string"},"uploadId":{"type":"string","minLength":1,"maxLength":1024},"parts":{"minItems":1,"maxItems":10000,"type":"array","items":{"type":"object","properties":{"PartNumber":{"type":"integer","minimum":1,"maximum":10000},"ETag":{"type":"string","minLength":1}},"required":["PartNumber","ETag"]}}},"required":["key","uploadId","parts"]}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"key":{"type":"string"},"location":{"type":"string"}},"required":["key","location"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}}}}},"/v1/usage/":{"get":{"summary":"Get usage statistics","tags":["Usage"],"parameters":[{"schema":{"type":"string","enum":["userId"]},"in":"query","name":"groupBy","required":false,"description":"Group by User ID"},{"schema":{"type":"string"},"in":"header","name":"x-org-id","required":false,"description":"Organization ID (must match your credentials)"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"usage":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"userId":{"nullable":true,"type":"string"},"totalQuantity":{"type":"number"},"count":{"type":"number"}},"required":["type","totalQuantity","count"],"additionalProperties":false}}},"required":["usage"],"additionalProperties":false}}}}}}},"/v1/rekognition/analyze":{"post":{"summary":"Analyze an asset with Rekognition and Titan","tags":["Rekognition"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"assetId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["assetId"]}}}},"parameters":[{"schema":{"type":"string"},"in":"header","name":"x-external-user-id","required":false,"description":"External User ID for collection context"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"labels":{"type":"array","items":{"type":"object","properties":{"Name":{"type":"string"},"Confidence":{"type":"number"}},"additionalProperties":false}},"faces":{"type":"array","items":{}},"embedding":{"type":"array","items":{"type":"number"}}},"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/rekognition/faces/name":{"post":{"summary":"Name a face and propagate to similar faces","tags":["Rekognition"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"faceId":{"type":"string"},"name":{"type":"string","minLength":1}},"required":["faceId","name"]}}}},"parameters":[{"schema":{"type":"string"},"in":"header","name":"x-external-user-id","required":false,"description":"External User ID for collection context"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"faceId":{"type":"string"},"name":{"nullable":true,"type":"string"}},"required":["id","faceId","name"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/transformations/":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"alias":{"type":"string"},"commands":{"type":"object","additionalProperties":{}}},"required":["name","alias","commands"]}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"alias":{"type":"string"},"commands":{"type":"object","additionalProperties":{}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","name","alias","commands","createdAt","updatedAt"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}},"get":{"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"alias":{"type":"string"},"commands":{"type":"object","additionalProperties":{}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","name","alias","commands","createdAt","updatedAt"],"additionalProperties":false}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/transformations/{id}":{"get":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"alias":{"type":"string"},"commands":{"type":"object","additionalProperties":{}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","name","alias","commands","createdAt","updatedAt"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}},"put":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"alias":{"type":"string"},"commands":{"type":"object","additionalProperties":{}}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"alias":{"type":"string"},"commands":{"type":"object","additionalProperties":{}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","name","alias","commands","createdAt","updatedAt"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}},"delete":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"204":{"description":"Default Response","content":{"application/json":{"schema":{"type":"string","nullable":true,"enum":[null]}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/backgrounds/":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"assetId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"An existing image asset (uploaded via /v1/assets) to register as a compositing background."},"metadata":{"type":"object","additionalProperties":{}}},"required":["name","assetId"]}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"s3Key":{"type":"string"},"mimeType":{"type":"string"},"width":{"nullable":true,"type":"number"},"height":{"nullable":true,"type":"number"},"metadata":{"nullable":true,"type":"object","additionalProperties":{}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","name","s3Key","mimeType","width","height","metadata","createdAt","updatedAt"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}},"get":{"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"s3Key":{"type":"string"},"mimeType":{"type":"string"},"width":{"nullable":true,"type":"number"},"height":{"nullable":true,"type":"number"},"metadata":{"nullable":true,"type":"object","additionalProperties":{}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","name","s3Key","mimeType","width","height","metadata","createdAt","updatedAt"],"additionalProperties":false}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/backgrounds/{id}":{"get":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"s3Key":{"type":"string"},"mimeType":{"type":"string"},"width":{"nullable":true,"type":"number"},"height":{"nullable":true,"type":"number"},"metadata":{"nullable":true,"type":"object","additionalProperties":{}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","name","s3Key","mimeType","width","height","metadata","createdAt","updatedAt"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}},"patch":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"s3Key":{"type":"string"},"mimeType":{"type":"string"},"width":{"nullable":true,"type":"number"},"height":{"nullable":true,"type":"number"},"metadata":{"nullable":true,"type":"object","additionalProperties":{}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","name","s3Key","mimeType","width","height","metadata","createdAt","updatedAt"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}},"delete":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"204":{"description":"Default Response","content":{"application/json":{"schema":{"type":"string","nullable":true,"enum":[null]}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/dam/groups":{"post":{"summary":"Create an asset group (collection)","tags":["DAM"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1},"metadata":{"type":"object","additionalProperties":{}}},"required":["name"]}}}},"responses":{"200":{"description":"Default Response"}}}},"/v1/dam/groups/{id}":{"get":{"summary":"Get an asset group","tags":["DAM"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/dam/relationships":{"post":{"summary":"Relate two assets","tags":["DAM"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sourceAssetId":{"type":"string"},"targetAssetId":{"type":"string"},"relationshipType":{"type":"string","minLength":1}},"required":["sourceAssetId","targetAssetId","relationshipType"]}}}},"responses":{"200":{"description":"Default Response"}}}},"/v1/dam/events":{"post":{"summary":"Record an asset event or comment","tags":["DAM"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"assetId":{"type":"string"},"eventType":{"type":"string","minLength":1},"eventData":{"type":"object","additionalProperties":{}}},"required":["assetId","eventType"]}}}},"responses":{"200":{"description":"Default Response"}}}},"/v1/dam/{assetId}/events":{"get":{"summary":"List events for an asset","tags":["DAM"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"assetId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/internal/v1/billing/checkout":{"post":{"summary":"Initialize a Stripe checkout session to bind an Org to Metered Billing.","tags":["Billing"],"responses":{"200":{"description":"Default Response"}}}},"/internal/v1/billing/webhooks":{"post":{"summary":"Stripe webhooks for payment resolutions.","tags":["Billing"],"responses":{"200":{"description":"Default Response"}}}},"/internal/v1/billing/aws/resolve":{"post":{"tags":["Billing"],"description":"Resolve AWS Marketplace registration token to customer ID","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string","minLength":1}},"required":["token"]}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"awsCustomerId":{"type":"string"},"awsProductCode":{"type":"string"}},"required":["success","awsCustomerId","awsProductCode"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/internal/v1/billing/aws/webhook":{"post":{"tags":["Billing"],"description":"AWS Marketplace SNS webhook for subscription/entitlement notifications","responses":{"200":{"description":"Default Response"}}}},"/v1/mcp/":{"post":{"responses":{"200":{"description":"Default Response"}}},"get":{"responses":{"200":{"description":"Default Response"}}},"delete":{"responses":{"200":{"description":"Default Response"}}}},"/v1/mcp/sse":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/v1/mcp/messages":{"post":{"responses":{"200":{"description":"Default Response"}}}},"/.well-known/oauth-protected-resource/v1/mcp":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/.well-known/oauth-protected-resource":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/v1/a2a/card":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/v1/a2a/":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/v1/a2a/jsonrpc":{"post":{"responses":{"200":{"description":"Default Response"}}}},"/v1/support/escalate":{"post":{"summary":"Escalate an issue, feedback, or report to support","tags":["Support"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subject":{"type":"string","description":"Subject of the support email"},"headline":{"type":"string","description":"Short headline for the support notification"},"message":{"type":"string","description":"Detailed support/escalation message"}},"required":["subject","headline","message"]}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"message":{"type":"string"}},"required":["success","message"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/v1/render/{id}":{"get":{"summary":"Image Delivery Proxy Alias (/render/:id)","tags":["Delivery"],"parameters":[{"schema":{"type":"number"},"in":"query","name":"w","required":false},{"schema":{"type":"number"},"in":"query","name":"h","required":false},{"schema":{"type":"number"},"in":"query","name":"wd","required":false},{"schema":{"type":"number"},"in":"query","name":"ht","required":false},{"schema":{"type":"string"},"in":"query","name":"ar","required":false},{"schema":{"type":"number","minimum":0.3,"maximum":1000},"in":"query","name":"blur","required":false},{"schema":{"anyOf":[{"type":"number"},{"type":"string","enum":["max"]}]},"in":"query","name":"r","required":false},{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"query","name":"wm","required":false},{"schema":{"type":"number"},"in":"query","name":"wm_w","required":false},{"schema":{"type":"number"},"in":"query","name":"wm_h","required":false},{"schema":{"default":"southeast","type":"string","enum":["top","right","bottom","left","center","northeast","southeast","southwest","northwest"]},"in":"query","name":"wm_pos","required":false},{"schema":{"type":"string","enum":["single","tiled"]},"in":"query","name":"wm_mode","required":false},{"schema":{"type":"string"},"in":"query","name":"wm_text","required":false},{"schema":{"type":"number","minimum":0,"maximum":1},"in":"query","name":"wm_opacity","required":false},{"schema":{"type":"number","minimum":0,"maximum":1},"in":"query","name":"wm_scale","required":false},{"schema":{"type":"number","minimum":1,"maximum":12},"in":"query","name":"wm_density","required":false},{"schema":{"type":"number"},"in":"query","name":"wm_rot","required":false},{"schema":{"type":"string"},"in":"query","name":"wm_color","required":false},{"schema":{"type":"string"},"in":"query","name":"txt","required":false},{"schema":{"type":"string"},"in":"query","name":"txt_font","required":false},{"schema":{"type":"number"},"in":"query","name":"txt_size","required":false},{"schema":{"type":"string"},"in":"query","name":"txt_color","required":false},{"schema":{"type":"string","enum":["top","right","bottom","left","center","northeast","southeast","southwest","northwest"]},"in":"query","name":"txt_pos","required":false},{"schema":{"type":"number"},"in":"query","name":"txt_x","required":false},{"schema":{"type":"number"},"in":"query","name":"txt_y","required":false},{"schema":{"type":"string","enum":["webp","jpeg","jpg","png","avif","auto"]},"in":"query","name":"fmt","required":false},{"schema":{"type":"string","enum":["cover","contain","fill","inside","outside"]},"in":"query","name":"fit","required":false},{"schema":{"type":"string"},"in":"query","name":"crop","required":false},{"schema":{"type":"string","enum":["auto"]},"in":"query","name":"trim","required":false},{"schema":{"type":"string","enum":["top","right","bottom","left","center","northeast","southeast","southwest","northwest","entropy","attention","face"]},"in":"query","name":"pos","required":false},{"schema":{"type":"string"},"in":"query","name":"bg","required":false},{"schema":{"type":"string","enum":["true","false"]},"in":"query","name":"bg_rem","required":false},{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"query","name":"bg_asset","required":false},{"schema":{"type":"string"},"in":"query","name":"gen_rem","required":false},{"schema":{"type":"string"},"in":"query","name":"gen_fill","required":false},{"schema":{"type":"string"},"in":"query","name":"gen_mask","required":false},{"schema":{"type":"string"},"in":"query","name":"mimi","required":false},{"schema":{"type":"string","enum":["lite","standard","4k"]},"in":"query","name":"mimi_mode","required":false},{"schema":{"type":"string","enum":["2k","4k"]},"in":"query","name":"upscale","required":false},{"schema":{"type":"string"},"in":"query","name":"mimi_bg","required":false},{"schema":{"type":"string","enum":["nearest","cubic","mitchell","lanczos2","lanczos3"]},"in":"query","name":"k","required":false},{"schema":{"type":"string","enum":["true","false"]},"in":"query","name":"no_enlarge","required":false},{"schema":{"type":"string","enum":["true","false"]},"in":"query","name":"no_reduce","required":false},{"schema":{"type":"number","minimum":1,"maximum":100},"in":"query","name":"q","required":false},{"schema":{"type":"string","enum":["true","false"]},"in":"query","name":"force","required":false},{"schema":{"type":"string"},"in":"query","name":"t","required":false},{"schema":{"type":"string"},"in":"query","name":"o","required":false},{"schema":{"type":"number"},"in":"query","name":"bri","required":false},{"schema":{"type":"number"},"in":"query","name":"con","required":false},{"schema":{"type":"number"},"in":"query","name":"sat","required":false},{"schema":{"type":"number"},"in":"query","name":"hue","required":false},{"schema":{"type":"string","enum":["true","false"]},"in":"query","name":"gray","required":false},{"schema":{"type":"string"},"in":"query","name":"tint","required":false},{"schema":{"type":"number"},"in":"query","name":"rot","required":false},{"schema":{"type":"string","enum":["true","false"]},"in":"query","name":"flip","required":false},{"schema":{"type":"string","enum":["true","false"]},"in":"query","name":"flop","required":false},{"schema":{"type":"string"},"in":"query","name":"sig","required":false},{"schema":{"type":"number"},"in":"query","name":"exp","required":false},{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/health/":{"get":{"responses":{"200":{"description":"Default Response"}}}}},"servers":[{"url":"https://api.picsha.ai","description":"Production server"},{"url":"http://localhost:3000","description":"Local development server"}],"security":[{"bearerAuth":[]}]}