{"openapi":"3.1.0","info":{"title":"Switchboarde","version":"0.1.0"},"servers":[{"url":"https://switchboarde-api-emporium-api-4mcz.onrender.com/"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"security":[{"bearerAuth":[]}],"paths":{"/v1/utilities/csv/to-json":{"post":{"operationId":"data.csv.to_json.v1","summary":"CSV to JSON","description":"CSV with unique headers, up to 1000 rows / 100 columns.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"csv":{"type":"string"}},"required":["csv"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"rows":{"type":"array","items":{"type":"object"}}}},"usage":{"type":"object"}}}}}},"default":{"description":"Error"}}}},"/v1/utilities/json/to-csv":{"post":{"operationId":"data.json.to_csv.v1","summary":"JSON to CSV","description":"Up to 1000 objects; columns determined by first row.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"rows":{"oneOf":[{"type":"array","items":{"type":"object"}},{"type":"string"}]}},"required":["rows"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"csv":{"type":"string"}}},"usage":{"type":"object"}}}}}},"default":{"description":"Error"}}}},"/v1/utilities/image/convert":{"post":{"operationId":"image.convert.v1","summary":"Convert image","description":"Convert PNG, JPEG, WebP, GIF, TIFF or AVIF; 5 MB / 20M pixels; optional width 1–4096.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"base64":{"type":"string","contentEncoding":"base64"},"format":{"type":"string","enum":["png","jpeg","webp"]},"width":{"type":"integer"}},"required":["base64","format"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"base64":{"type":"string","contentEncoding":"base64"},"mime_type":{"type":"string"},"bytes":{"type":"integer"}}},"usage":{"type":"object"}}}}}},"default":{"description":"Error"}}}},"/v1/utilities/image/crop":{"post":{"operationId":"image.crop.v1","summary":"Crop image","description":"Crop stored pixel coordinates; single-frame JPEG/PNG/WebP, 5 MB / 12M pixels.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"base64":{"type":"string","contentEncoding":"base64"},"left":{"type":"integer"},"top":{"type":"integer"},"width":{"type":"integer"},"height":{"type":"integer"},"format":{"type":"string","enum":["png","jpeg","webp"]}},"required":["base64","left","top","width","height"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"base64":{"type":"string","contentEncoding":"base64"},"mime_type":{"type":"string"},"bytes":{"type":"integer"},"width":{"type":"integer"},"height":{"type":"integer"}}},"usage":{"type":"object"}}}}}},"default":{"description":"Error"}}}},"/v1/utilities/image/resize":{"post":{"operationId":"image.resize.v1","summary":"Resize image","description":"Fit within width and optional height, 1–4096; no enlargement. JPEG/PNG/WebP, 5 MB / 12M pixels.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"base64":{"type":"string","contentEncoding":"base64"},"width":{"type":"integer"},"height":{"type":"integer"},"format":{"type":"string","enum":["png","jpeg","webp"]}},"required":["base64","width"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"base64":{"type":"string","contentEncoding":"base64"},"mime_type":{"type":"string"},"bytes":{"type":"integer"},"width":{"type":"integer"},"height":{"type":"integer"}}},"usage":{"type":"object"}}}}}},"default":{"description":"Error"}}}},"/v1/utilities/image/strip-metadata":{"post":{"operationId":"image.strip-metadata.v1","summary":"Remove image metadata","description":"Re-encode without metadata; not anonymization. JPEG/PNG/WebP, 5 MB / 12M pixels.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"base64":{"type":"string","contentEncoding":"base64"},"format":{"type":"string","enum":["png","jpeg","webp"]}},"required":["base64"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"base64":{"type":"string","contentEncoding":"base64"},"mime_type":{"type":"string"},"bytes":{"type":"integer"},"width":{"type":"integer"},"height":{"type":"integer"}}},"usage":{"type":"object"}}}}}},"default":{"description":"Error"}}}},"/v1/utilities/image/watermark":{"post":{"operationId":"image.watermark.v1","summary":"Watermark image","description":"Centered ASCII text, 1–100 characters. JPEG/PNG/WebP, 5 MB / 12M pixels.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"base64":{"type":"string","contentEncoding":"base64"},"text":{"type":"string"},"format":{"type":"string","enum":["png","jpeg","webp"]}},"required":["base64","text"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"base64":{"type":"string","contentEncoding":"base64"},"mime_type":{"type":"string"},"bytes":{"type":"integer"},"width":{"type":"integer"},"height":{"type":"integer"}}},"usage":{"type":"object"}}}}}},"default":{"description":"Error"}}}},"/v1/documents/pdf/compress":{"post":{"operationId":"pdf.compress.v1","summary":"Compress PDF","description":"Lossless object streams; may not reduce size. 10 MB / 200 pages.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"base64":{"type":"string","contentEncoding":"base64"}},"required":["base64"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"base64":{"type":"string","contentEncoding":"base64"},"mime_type":{"type":"string"},"bytes":{"type":"integer"},"pages":{"type":"integer"},"original_bytes":{"type":"integer"},"bytes_saved":{"type":"integer"},"mode":{"type":"string"}}},"usage":{"type":"object"}}}}}},"default":{"description":"Error"}}}},"/v1/documents/pdf/extract":{"post":{"operationId":"pdf.extract.v1","summary":"Extract PDF text","description":"Extract selectable text; no OCR. REST uses multipart file, default 50 MB / 500 pages. MCP accepts base64 up to 10 MB.","requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["file"],"properties":{"file":{"type":"string","format":"binary"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"text":{"type":"string"},"pages":{"type":"integer"},"characters":{"type":"integer"}}},"usage":{"type":"object"}}}}}},"default":{"description":"Error"}}}},"/v1/documents/pdf/merge":{"post":{"operationId":"pdf.merge.v1","summary":"Merge PDFs","description":"Merge 2–10 PDFs, each 10 MB, combined 20 MB / 200 pages.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"files":{"type":"array","items":{"type":"string","contentEncoding":"base64"},"minItems":2,"maxItems":10}},"required":["files"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"base64":{"type":"string","contentEncoding":"base64"},"mime_type":{"type":"string"},"bytes":{"type":"integer"},"pages":{"type":"integer"}}},"usage":{"type":"object"}}}}}},"default":{"description":"Error"}}}},"/v1/documents/pdf/split":{"post":{"operationId":"pdf.split.v1","summary":"Split PDF","description":"Extract inclusive 1-based page range; 10 MB / 200 pages.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"base64":{"type":"string","contentEncoding":"base64"},"start_page":{"type":"integer"},"end_page":{"type":"integer"}},"required":["base64","start_page","end_page"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"base64":{"type":"string","contentEncoding":"base64"},"mime_type":{"type":"string"},"bytes":{"type":"integer"},"pages":{"type":"integer"}}},"usage":{"type":"object"}}}}}},"default":{"description":"Error"}}}},"/v1/documents/pdf/watermark":{"post":{"operationId":"pdf.watermark.v1","summary":"Watermark PDF","description":"Centered text on every page; 1–100 printable ASCII characters. 10 MB / 200 pages.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"base64":{"type":"string","contentEncoding":"base64"},"text":{"type":"string"}},"required":["base64","text"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"base64":{"type":"string","contentEncoding":"base64"},"mime_type":{"type":"string"},"bytes":{"type":"integer"},"pages":{"type":"integer"}}},"usage":{"type":"object"}}}}}},"default":{"description":"Error"}}}},"/v1/utilities/qr":{"post":{"operationId":"qr.generate.v1","summary":"Generate QR code","description":"PNG QR code; text up to 2048 characters, size 128–1024.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string"},"size":{"type":"integer"}},"required":["text"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"base64":{"type":"string","contentEncoding":"base64"},"mime_type":{"type":"string"}}},"usage":{"type":"object"}}}}}},"default":{"description":"Error"}}}},"/v1/travel/airport/info":{"post":{"operationId":"travel.airport.info.v1","summary":"Airport information","description":"Look up airport reference information by IATA, ICAO or local identifier. Public-domain OurAirports data; not operational flight information.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string"}},"required":["code"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"airports":{"type":"array","items":{"type":"object"}},"source":{"type":"string"},"source_url":{"type":"string"},"license":{"type":"string"},"notice":{"type":"string"}}},"usage":{"type":"object"}}}}}},"default":{"description":"Error"}}}}}}