{"openapi":"3.1.0","info":{"title":"Unmarkr API","version":"1.0.0","description":"Remove AI watermarks from images — visible generator logos, invisible SynthID, and provenance metadata (C2PA, EXIF, the “Made with AI” tag). Key-authenticated and metered by credits.","contact":{"name":"Unmarkr Support","email":"support@unmarkr.io","url":"https://unmarkr.io/docs"},"termsOfService":"https://unmarkr.io/terms"},"servers":[{"url":"https://unmarkr.io","description":"Production"}],"externalDocs":{"description":"API documentation","url":"https://unmarkr.io/docs"},"security":[{"bearerAuth":[]}],"paths":{"/api/remove":{"post":{"operationId":"removeWatermark","summary":"Remove watermarks and provenance metadata from an image","description":"Uploads an image and returns a cleaned copy. `mode=standard` (default) strips provenance metadata for 1 credit; `mode=full` also removes the visible logo and invisible SynthID watermark for 4 credits. The response body is the cleaned image bytes; the `X-Unmarkr-Removed` header lists what was removed.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["image"],"properties":{"image":{"type":"string","format":"binary","description":"The image file (PNG, JPEG, or WebP; up to 25 MB)."},"mode":{"type":"string","enum":["standard","full"],"default":"standard","description":"Which removal to run. `standard` strips provenance metadata (C2PA, EXIF/XMP, “Made with AI”) for 1 credit; `full` also removes the visible logo and invisible SynthID watermark for 4 credits. (Legacy comma values `metadata`/`visible`/`invisible` are still accepted.)"}}}}}},"responses":{"200":{"description":"The cleaned image (returned directly for `standard`, and for `full` when processed synchronously).","headers":{"X-Unmarkr-Removed":{"description":"What was removed (e.g. `metadata: EXIF, C2PA` or `logo, synthid, metadata`).","schema":{"type":"string"}}},"content":{"image/png":{"schema":{"type":"string","format":"binary"}},"image/jpeg":{"schema":{"type":"string","format":"binary"}},"image/webp":{"schema":{"type":"string","format":"binary"}}}},"202":{"description":"`full` accepted as an asynchronous job. Poll `poll` until done, then fetch `result`.","content":{"application/json":{"schema":{"type":"object","properties":{"jobId":{"type":"string"},"status":{"type":"string","example":"processing"},"poll":{"type":"string","example":"/api/jobs/{id}"},"result":{"type":"string","example":"/api/jobs/{id}/result"}}}}}},"400":{"description":"Bad request — expected multipart/form-data with an `image` field.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, invalid, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Out of credits — buy a credit pack or subscribe.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Image exceeds the 25 MB limit.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded.","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"`full` removal temporarily unavailable — try `standard`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"An Unmarkr API key (`unmarkr_live_…`) created in the dashboard."}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"string","description":"Human-readable error message."},"code":{"type":"string","description":"Machine-readable code (e.g. `no_credits`)."}},"required":["error"]}}}}