{ "openapi": "3.0.3", "info": { "title": "watermarks-remover service", "version": "0.5.0", "description": "Strip multi-vendor AI provenance marks (Unicode, C2PA/EXIF/XMP, containers). Files are passed base64-encoded in JSON; cleaned bytes come back base64-encoded." }, "paths": { "/health": { "get": { "summary": "Liveness and version", "responses": { "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ false ] }, "error": { "type": "string" } } } } } }, "401": { "description": "Missing/invalid bearer token", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ false ] }, "error": { "type": "string" } } } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ false ] }, "error": { "type": "string" } } } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ false ] }, "error": { "type": "string" } } } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ false ] }, "error": { "type": "string" } } } } } }, "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" }, "version": { "type": "string" } } } } } } } } }, "/capabilities": { "get": { "summary": "Which optional tools and heavy backends are available", "responses": { "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ false ] }, "error": { "type": "string" } } } } } }, "401": { "description": "Missing/invalid bearer token", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ false ] }, "error": { "type": "string" } } } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ false ] }, "error": { "type": "string" } } } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ false ] }, "error": { "type": "string" } } } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ false ] }, "error": { "type": "string" } } } } } }, "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" }, "version": { "type": "string" }, "tools": { "type": "object", "properties": { "c2patool": { "type": "boolean" }, "exiftool": { "type": "boolean" }, "qpdf": { "type": "boolean" } } }, "pixel_backends": { "type": "object", "properties": { "ctrlregen": { "type": "boolean" }, "diffusion": { "type": "boolean" } } }, "scorers": { "type": "object", "properties": { "synthid": { "type": "boolean" } } }, "harnesses": { "type": "object", "properties": { "markllm": { "type": "boolean" } } } } } } } } } } }, "/openapi.json": { "get": { "summary": "This OpenAPI 3.0.3 document, generated dynamically", "responses": { "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ false ] }, "error": { "type": "string" } } } } } }, "401": { "description": "Missing/invalid bearer token", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ false ] }, "error": { "type": "string" } } } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ false ] }, "error": { "type": "string" } } } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ false ] }, "error": { "type": "string" } } } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ false ] }, "error": { "type": "string" } } } } } }, "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "description": "An OpenAPI 3.0.3 document" } } } } } } }, "/inspect": { "post": { "summary": "Inspect a file for AI provenance marks (text / image / container auto-routed)", "responses": { "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ false ] }, "error": { "type": "string" } } } } } }, "401": { "description": "Missing/invalid bearer token", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ false ] }, "error": { "type": "string" } } } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ false ] }, "error": { "type": "string" } } } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ false ] }, "error": { "type": "string" } } } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ false ] }, "error": { "type": "string" } } } } } }, "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" }, "kind": { "type": "string", "enum": [ "text", "image", "container" ] }, "suspicious": { "type": "boolean" }, "report": { "type": "object" } } } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "file" ], "properties": { "file": { "type": "string", "description": "Base64-encoded file bytes", "example": "SGVsbG8gd29ybGQ=" }, "name": { "type": "string", "description": "Original filename (extension drives format routing)", "example": "notes.md" } } } } } } } }, "/clean": { "post": { "summary": "Clean a file; returns the cleaned bytes and an actions/stats report", "responses": { "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ false ] }, "error": { "type": "string" } } } } } }, "401": { "description": "Missing/invalid bearer token", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ false ] }, "error": { "type": "string" } } } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ false ] }, "error": { "type": "string" } } } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ false ] }, "error": { "type": "string" } } } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ false ] }, "error": { "type": "string" } } } } } }, "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" }, "kind": { "type": "string", "enum": [ "text", "image", "container" ] }, "cleaned": { "type": "string", "description": "Base64-encoded cleaned file bytes" }, "report": { "type": "object" } } } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "file" ], "properties": { "file": { "type": "string", "description": "Base64-encoded file bytes", "example": "SGVsbG8gd29ybGQ=" }, "name": { "type": "string", "description": "Original filename (extension drives format routing)", "example": "notes.md" }, "options": { "type": "object", "properties": { "nfkc": { "type": "boolean" }, "aggressive_homoglyphs": { "type": "boolean" }, "keep_non_ai_metadata": { "type": "boolean" }, "also_layer_a_text": { "type": "boolean" }, "remove_pixel": { "type": "string" }, "strip_all_metadata": { "type": "boolean" } }, "additionalProperties": false } } } } } } } } } }