This is bold text.
\n"}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/markdown/to-text":{"post":{"operationId":"markdownToText","tags":["Text & Data"],"summary":"Convert Markdown to plain text","description":"Strips all Markdown syntax (headings, bold, links, code blocks, etc.) and returns plain text.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["markdown"],"properties":{"markdown":{"type":"string","description":"Markdown source text","example":"# Hello\n\nThis is **bold** text."}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"text":{"type":"string"}},"example":{"text":"Hello\n\nThis is bold text."}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/html-to-text/convert":{"post":{"operationId":"htmlToTextConvert","tags":["Text & Data"],"summary":"Convert HTML to plain text","description":"Strips HTML tags and decodes entities. Optionally preserves links and images as Markdown-style references.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["html"],"properties":{"html":{"type":"string","description":"HTML string to convert","example":"This is bold text.
"},"preserveLinks":{"type":"boolean","description":"Keep links as [text](url)","default":false},"preserveImages":{"type":"boolean","description":"Keep images as [alt](src)","default":false}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"text":{"type":"string"},"wordCount":{"type":"integer"}},"example":{"text":"Hello\nThis is bold text.","wordCount":5}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/lorem/generate":{"post":{"operationId":"loremGenerate","tags":["Text & Data"],"summary":"Generate lorem ipsum text","description":"Generates placeholder text as paragraphs, sentences, or individual words.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["paragraphs","sentences","words"],"description":"The unit of text to generate","example":"paragraphs"},"count":{"type":"integer","description":"How many units to generate (1-100)","default":3,"minimum":1,"maximum":100}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"text":{"type":"string"},"count":{"type":"integer"},"type":{"type":"string"}},"example":{"text":"Lorem ipsum dolor sit amet, consectetur adipiscing elit...","count":3,"type":"paragraphs"}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/regex/test":{"post":{"operationId":"regexTest","tags":["Text & Data"],"summary":"Test a regex pattern against a string","description":"Executes a regular expression against a test string and returns all matches with indices and named groups.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["pattern","testString"],"properties":{"pattern":{"type":"string","description":"Regular expression pattern (without delimiters)","example":"(\\d{4})-(\\d{2})-(\\d{2})"},"flags":{"type":"string","description":"Regex flags (e.g. \"gi\")","default":""},"testString":{"type":"string","description":"String to test against","example":"Date: 2025-01-15 and 2025-06-30"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"matches":{"type":"array","items":{"type":"object","properties":{"match":{"type":"string"},"index":{"type":"integer"},"groups":{"type":"object"}}}},"matched":{"type":"boolean"},"matchCount":{"type":"integer"}},"example":{"matches":[{"match":"2025-01-15","index":6},{"match":"2025-06-30","index":21}],"matched":true,"matchCount":2}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/regex/replace":{"post":{"operationId":"regexReplace","tags":["Text & Data"],"summary":"Find and replace with regex","description":"Applies a regex-based find-and-replace on a string and returns the result with a replacement count.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["pattern","testString","replacement"],"properties":{"pattern":{"type":"string","description":"Regular expression pattern","example":"\\d+"},"flags":{"type":"string","description":"Regex flags","default":""},"testString":{"type":"string","description":"Input string","example":"Order 123 has 5 items"},"replacement":{"type":"string","description":"Replacement string (supports $1, $2, etc.)","example":"#"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"result":{"type":"string"},"replacements":{"type":"integer"}},"example":{"result":"Order # has # items","replacements":2}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/hash/":{"post":{"operationId":"hashGenerate","tags":["Developer Utilities"],"summary":"Generate a hash","description":"Computes a cryptographic hash of the input text using the specified algorithm.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["text","algorithm"],"properties":{"text":{"type":"string","description":"Text to hash","example":"Hello, World!"},"algorithm":{"type":"string","enum":["md5","sha1","sha256","sha384","sha512"],"description":"Hash algorithm","example":"sha256"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"hash":{"type":"string"},"algorithm":{"type":"string"}},"example":{"hash":"dffd6021bb2bd5b0af676290809ec3a53191dd81c7f70a4b28688a362182986f","algorithm":"sha256"}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/hash/batch":{"post":{"operationId":"hashBatch","tags":["Developer Utilities"],"summary":"Generate multiple hashes at once","description":"Computes hashes for the same input across multiple algorithms in a single request. Defaults to all supported algorithms if none specified.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["text"],"properties":{"text":{"type":"string","description":"Text to hash","example":"Hello, World!"},"algorithms":{"type":"array","items":{"type":"string","enum":["md5","sha1","sha256","sha384","sha512"]},"description":"Algorithms to use. Omit for all supported algorithms.","example":["sha256","md5"]}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"hashes":{"type":"object","additionalProperties":{"type":"string"}}},"example":{"hashes":{"sha256":"dffd6021bb2bd5b0af676290809ec3a53191dd81c7f70a4b28688a362182986f","md5":"65a8e27d8879283831b664bd8b7f0ad4"}}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/uuid/v4":{"post":{"operationId":"uuidGenerateV4","tags":["Developer Utilities"],"summary":"Generate a UUID v4","description":"Returns a single cryptographically random UUID v4.","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"uuid":{"type":"string","format":"uuid"}},"example":{"uuid":"f47ac10b-58cc-4372-a567-0e02b2c3d479"}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/uuid/batch":{"post":{"operationId":"uuidBatch","tags":["Developer Utilities"],"summary":"Generate multiple UUIDs","description":"Returns up to 100 UUID v4 values in a single request.","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer","description":"Number of UUIDs to generate (1-100)","default":1,"minimum":1,"maximum":100,"example":5}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"uuids":{"type":"array","items":{"type":"string","format":"uuid"}}},"example":{"uuids":["f47ac10b-58cc-4372-a567-0e02b2c3d479","a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d"]}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/uuid/ulid":{"post":{"operationId":"uuidGenerateUlid","tags":["Developer Utilities"],"summary":"Generate a ULID","description":"Returns a Universally Unique Lexicographically Sortable Identifier (ULID). Contains a 48-bit timestamp and 80 bits of randomness.","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"ulid":{"type":"string"}},"example":{"ulid":"01ARZ3NDEKTSV4RRFFQ69G5FAV"}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/uuid/validate":{"post":{"operationId":"uuidValidate","tags":["Developer Utilities"],"summary":"Validate a UUID","description":"Checks whether a string is a valid UUID and detects its version.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["uuid"],"properties":{"uuid":{"type":"string","description":"UUID string to validate","example":"f47ac10b-58cc-4372-a567-0e02b2c3d479"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"valid":{"type":"boolean"},"version":{"type":"integer"}},"example":{"valid":true,"version":4}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/url/encode":{"post":{"operationId":"urlEncode","tags":["Developer Utilities"],"summary":"URL-encode a string","description":"Encodes a string for safe use in URLs. Uses encodeURIComponent by default or encodeURI when component is false.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["text"],"properties":{"text":{"type":"string","description":"String to encode","example":"hello world & foo=bar"},"component":{"type":"boolean","description":"Use encodeURIComponent (true) or encodeURI (false)","default":true}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"encoded":{"type":"string"}},"example":{"encoded":"hello%20world%20%26%20foo%3Dbar"}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/url/decode":{"post":{"operationId":"urlDecode","tags":["Developer Utilities"],"summary":"URL-decode a string","description":"Decodes a percent-encoded URL string.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["text"],"properties":{"text":{"type":"string","description":"URL-encoded string to decode","example":"hello%20world%20%26%20foo%3Dbar"},"component":{"type":"boolean","description":"Use decodeURIComponent (true) or decodeURI (false)","default":true}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"decoded":{"type":"string"}},"example":{"decoded":"hello world & foo=bar"}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/url/parse":{"post":{"operationId":"urlParse","tags":["Developer Utilities"],"summary":"Parse a URL into its components","description":"Breaks a URL into protocol, host, pathname, query parameters, hash, and more.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","description":"Full URL to parse","example":"https://botoi.com/tools?q=json&lang=en#results"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"protocol":{"type":"string"},"host":{"type":"string"},"hostname":{"type":"string"},"port":{"type":"string","nullable":true},"pathname":{"type":"string"},"search":{"type":"string","nullable":true},"queryParams":{"type":"object","additionalProperties":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]}},"hash":{"type":"string","nullable":true},"origin":{"type":"string"},"username":{"type":"string","nullable":true},"password":{"type":"string","nullable":true}},"example":{"protocol":"https:","host":"botoi.com","hostname":"botoi.com","port":null,"pathname":"/tools","search":"?q=json&lang=en","queryParams":{"q":"json","lang":"en"},"hash":"#results","origin":"https://botoi.com","username":null,"password":null}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/password/generate":{"post":{"operationId":"passwordGenerate","tags":["Developer Utilities"],"summary":"Generate secure passwords","description":"Generates one or more cryptographically random passwords with configurable length, character sets, and ambiguous character exclusion.","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"length":{"type":"integer","description":"Password length (4-256)","default":16,"minimum":4,"maximum":256},"count":{"type":"integer","description":"Number of passwords to generate (1-50)","default":1,"minimum":1,"maximum":50},"uppercase":{"type":"boolean","description":"Include uppercase letters","default":true},"lowercase":{"type":"boolean","description":"Include lowercase letters","default":true},"numbers":{"type":"boolean","description":"Include digits","default":true},"symbols":{"type":"boolean","description":"Include special characters","default":false},"excludeAmbiguous":{"type":"boolean","description":"Exclude ambiguous characters (0, O, I, l, 1, |)","default":false}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"passwords":{"type":"array","items":{"type":"string"}}},"example":{"passwords":["xK9mB2nPqR4tW7yZ"]}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/password/strength":{"post":{"operationId":"passwordStrength","tags":["Developer Utilities"],"summary":"Check password strength","description":"Analyzes a password and returns a strength score (0-4), entropy bits, and human-readable feedback.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["password"],"properties":{"password":{"type":"string","description":"Password to analyze","example":"MyS3cure!Pass"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"score":{"type":"integer","minimum":0,"maximum":4},"feedback":{"type":"string"},"entropy":{"type":"number"}},"example":{"score":3,"feedback":"Strong. Good length and character diversity.","entropy":77.55}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/cron/parse":{"post":{"operationId":"cronParse","tags":["Developer Utilities"],"summary":"Parse and describe a cron expression","description":"Validates a standard 5-field cron expression, returns a human-readable description, the next 5 scheduled runs, and the parsed field breakdown.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["expression"],"properties":{"expression":{"type":"string","description":"Five-field cron expression","example":"*/15 9-17 * * 1-5"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"isValid":{"type":"boolean"},"description":{"type":"string"},"nextRuns":{"type":"array","items":{"type":"string","format":"date-time"}},"parts":{"type":"object","nullable":true,"properties":{"minute":{"type":"string"},"hour":{"type":"string"},"dayOfMonth":{"type":"string"},"dayOfWeek":{"type":"string"},"month":{"type":"string"}}}},"example":{"isValid":true,"description":"Every 15 minutes past 9AM on Monday","nextRuns":["2026-03-24T09:00:00.000Z"],"parts":{"minute":"*/15","hour":"9-17","dayOfMonth":"*","month":"*","dayOfWeek":"1-5"}}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/cron/next":{"post":{"operationId":"cronNext","tags":["Developer Utilities"],"summary":"Get next scheduled runs for a cron expression","description":"Returns the next N scheduled execution times for a cron expression, optionally starting from a custom date.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["expression"],"properties":{"expression":{"type":"string","description":"Five-field cron expression","example":"0 0 * * *"},"count":{"type":"integer","description":"Number of runs to return (1-25)","default":5,"minimum":1,"maximum":25},"from":{"type":"string","format":"date-time","description":"Start date for calculation (defaults to now)","example":"2026-01-01T00:00:00Z"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"nextRuns":{"type":"array","items":{"type":"string","format":"date-time"}}},"example":{"nextRuns":["2026-01-02T00:00:00.000Z","2026-01-03T00:00:00.000Z","2026-01-04T00:00:00.000Z"]}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/og/generate":{"post":{"operationId":"ogGenerate","tags":["Image Generation"],"summary":"Generate an Open Graph image","description":"Creates a customizable OG image as SVG using Satori. Choose from three templates (default, minimal, bold), light/dark themes, and custom colors.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["title"],"properties":{"title":{"type":"string","description":"Main heading text","example":"Build APIs faster with Botoi"},"description":{"type":"string","description":"Subtitle text (optional)","example":"Free developer utility APIs"},"template":{"type":"string","enum":["default","minimal","bold"],"description":"Layout template","default":"default"},"theme":{"type":"string","enum":["dark","light"],"description":"Color theme","default":"dark"},"format":{"type":"string","enum":["svg"],"description":"Output format (only SVG is supported)","default":"svg"},"bgColor":{"type":"string","description":"Custom background color (hex)","example":"#111114"},"textColor":{"type":"string","description":"Custom text color (hex)","example":"#E8E6E1"},"accentColor":{"type":"string","description":"Custom accent color (hex)","example":"#3EC997"},"width":{"type":"integer","description":"Image width in pixels (200-4096)","default":1200},"height":{"type":"integer","description":"Image height in pixels (200-4096)","default":630}}}}}},"responses":{"200":{"description":"SVG image","content":{"image/svg+xml":{"schema":{"type":"string"}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/qr/generate":{"post":{"operationId":"qrGeneratePost","tags":["Image Generation"],"summary":"Generate a QR code (POST)","description":"Generates a QR code from the given text. Returns SVG by default. Supports custom colors, error correction levels, and margins.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["text"],"properties":{"text":{"type":"string","description":"Content to encode in the QR code","example":"https://botoi.com"},"size":{"type":"integer","description":"Image size in pixels (50-2000)","default":300,"minimum":50,"maximum":2000},"format":{"type":"string","enum":["svg","png","base64"],"description":"Output format. PNG falls back to SVG in this environment.","default":"svg"},"darkColor":{"type":"string","description":"Foreground color (hex)","default":"#000000"},"lightColor":{"type":"string","description":"Background color (hex)","default":"#ffffff"},"errorCorrectionLevel":{"type":"string","enum":["L","M","Q","H"],"description":"Error correction level: L (7%), M (15%), Q (25%), H (30%)","default":"M"},"margin":{"type":"integer","description":"Quiet zone margin (0-20 modules)","default":4,"minimum":0,"maximum":20}}}}}},"responses":{"200":{"description":"QR code image (SVG)","content":{"image/svg+xml":{"schema":{"type":"string"}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"get":{"operationId":"qrGenerateGet","tags":["Image Generation"],"summary":"Generate a QR code (GET)","description":"Generates a QR code via query parameters. Useful for embedding inHello
"},"allowed_tags":{"type":"array","items":{"type":"string"},"description":"List of allowed HTML tags","example":["p","b","i","a"]}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"sanitized":{"type":"string"},"removed_tags":{"type":"array","items":{"type":"string"}},"removed_attributes":{"type":"array","items":{"type":"string"}}},"example":{"sanitized":"Hello
","removed_tags":["script"],"removed_attributes":[]}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/csv/to-json":{"post":{"operationId":"csvToJson","tags":["Text & Data"],"summary":"Convert CSV to JSON","description":"Parses a CSV string and returns an array of JSON objects. Supports custom delimiters and optional header row.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["csv"],"properties":{"csv":{"type":"string","description":"CSV data as a string","example":"name,age\nAlice,30\nBob,25"},"delimiter":{"type":"string","description":"Column delimiter character","default":","},"has_header":{"type":"boolean","description":"Whether the first row contains column headers","default":true}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object"}},"rows":{"type":"integer"},"columns":{"type":"integer"}},"example":{"data":[{"name":"Alice","age":"30"},{"name":"Bob","age":"25"}],"rows":2,"columns":2}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/csv/to-csv":{"post":{"operationId":"jsonToCsv","tags":["Text & Data"],"summary":"Convert JSON to CSV","description":"Converts an array of JSON objects to CSV format. Supports custom delimiters and optional header row.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object"},"description":"Array of JSON objects to convert","example":[{"name":"Alice","age":30},{"name":"Bob","age":25}]},"delimiter":{"type":"string","description":"Column delimiter character","default":","},"include_header":{"type":"boolean","description":"Include a header row from object keys","default":true}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"csv":{"type":"string"},"rows":{"type":"integer"},"columns":{"type":"integer"}},"example":{"csv":"name,age\nAlice,30\nBob,25","rows":2,"columns":2}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/xml/to-json":{"post":{"operationId":"xmlToJson","tags":["Text & Data"],"summary":"Convert XML to JSON","description":"Parses an XML string and returns a JSON representation of the document structure.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["xml"],"properties":{"xml":{"type":"string","description":"XML string to convert","example":"This is bold text.
"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"markdown":{"type":"string"}},"example":{"markdown":"# Hello\n\nThis is **bold** text."}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/pii/detect":{"post":{"operationId":"piiDetect","tags":["Security"],"summary":"Detect personally identifiable information in text","description":"Scans text for PII patterns including email addresses, phone numbers, SSNs, credit card numbers (Luhn-validated), IP addresses, and dates of birth. Returns each finding with its type, position, and a masked version of the value.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["text"],"properties":{"text":{"type":"string","description":"The text to scan for PII","example":"Contact john@example.com or call 555-123-4567."}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"found":{"type":"boolean"},"count":{"type":"integer"},"findings":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","description":"PII type: email, phone, ssn, credit_card, ip_address, or date_of_birth"},"value":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"masked":{"type":"string"}}}}},"example":{"found":true,"count":2,"findings":[{"type":"email","value":"john@example.com","start":8,"end":24,"masked":"jo**@example.com"},{"type":"phone","value":"555-123-4567","start":33,"end":45,"masked":"***-***-4567"}]}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/minify/js":{"post":{"operationId":"minifyJs","tags":["Developer Utilities"],"summary":"Minify JavaScript code","description":"Removes comments, collapses whitespace, and strips unnecessary characters from JavaScript code. Returns the minified output along with original size, minified size, and savings percentage.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"JavaScript code to minify","example":"const x = 1; // a number\nconsole.log(x);"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"minified":{"type":"string"},"original_size":{"type":"integer"},"minified_size":{"type":"integer"},"savings_percent":{"type":"number"}},"example":{"minified":"const x=1;console.log(x);","original_size":40,"minified_size":26,"savings_percent":35}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/minify/css":{"post":{"operationId":"minifyCss","tags":["Developer Utilities"],"summary":"Minify CSS code","description":"Removes comments, collapses whitespace, and strips unnecessary characters from CSS code. Returns the minified output along with original size, minified size, and savings percentage.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"CSS code to minify","example":"body {\n margin: 0;\n padding: 0;\n}"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"minified":{"type":"string"},"original_size":{"type":"integer"},"minified_size":{"type":"integer"},"savings_percent":{"type":"number"}},"example":{"minified":"body{margin:0;padding:0}","original_size":35,"minified_size":24,"savings_percent":31.43}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/minify/html":{"post":{"operationId":"minifyHtml","tags":["Developer Utilities"],"summary":"Minify HTML code","description":"Removes comments, collapses whitespace, and strips unnecessary characters from HTML code. Returns the minified output along with original size, minified size, and savings percentage.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"HTML code to minify","example":"\n \nHello
\n \n"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"minified":{"type":"string"},"original_size":{"type":"integer"},"minified_size":{"type":"integer"},"savings_percent":{"type":"number"}},"example":{"minified":"Hello
","original_size":48,"minified_size":38,"savings_percent":20.83}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/sql/format":{"post":{"operationId":"sqlFormat","tags":["Developer Utilities"],"summary":"Format and prettify SQL queries","description":"Uppercases SQL keywords and adds line breaks before major clauses (SELECT, FROM, WHERE, JOIN, etc.) for readability. Supports an optional indent width for subqueries.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["sql"],"properties":{"sql":{"type":"string","description":"SQL query to format","example":"select id, name from users where active = true order by name"},"indent":{"type":"integer","description":"Number of spaces for indentation (default: 2)","default":2}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"formatted":{"type":"string"}},"example":{"formatted":"SELECT id, name\nFROM users\nWHERE active = TRUE\nORDER BY name"}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/code/format":{"post":{"operationId":"codeFormat","tags":["Developer Utilities"],"summary":"Format source code","description":"Formats source code for a given language. Supported languages: javascript, json, html, css, sql, xml. Applies indentation, keyword casing (for SQL), and structural formatting.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["code","language"],"properties":{"code":{"type":"string","description":"Source code to format","example":"{\"name\":\"botoi\",\"version\":\"1.0\"}"},"language":{"type":"string","description":"Programming language (javascript, json, html, css, sql, xml)","enum":["javascript","json","html","css","sql","xml"],"example":"json"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"formatted":{"type":"string"},"language":{"type":"string"}},"example":{"formatted":"{\n \"name\": \"botoi\",\n \"version\": \"1.0\"\n}","language":"json"}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/schema/json-to-typescript":{"post":{"operationId":"jsonToTypescript","tags":["Developer Utilities"],"summary":"Convert a JSON value to a TypeScript interface","description":"Infers TypeScript types from a JSON value and generates an interface or type alias. Handles nested objects, arrays, and primitive types. Optionally accepts a custom interface name.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["json"],"properties":{"json":{"type":"object","description":"Any valid JSON value to convert (object, array, string, number, etc.)","example":{"name":"Alice","age":30,"active":true}},"name":{"type":"string","description":"Name for the generated interface (default: \"Root\")","default":"Root","example":"User"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"typescript":{"type":"string"},"name":{"type":"string"}},"example":{"typescript":"interface User {\n name: string;\n age: number;\n active: boolean;\n}","name":"User"}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/webhook/inbox/create":{"post":{"operationId":"webhookInboxCreate","tags":["Storage & Services"],"summary":"Create a webhook inbox","description":"Creates a temporary webhook inbox that captures incoming POST payloads for 24 hours. Useful for testing third-party webhook integrations without deploying a server.","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"inbox_id":{"type":"string"},"url":{"type":"string","description":"URL where webhook providers should POST payloads"},"payloads_url":{"type":"string","description":"GET this URL to list captured payloads"},"expires_in":{"type":"integer","description":"Seconds until inbox expires"}},"example":{"inbox_id":"a1b2c3d4","url":"https://api.botoi.com/v1/webhook/inbox/a1b2c3d4/receive","payloads_url":"https://api.botoi.com/v1/webhook/inbox/a1b2c3d4/payloads","expires_in":86400}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/webhook/inbox/{id}/receive":{"post":{"operationId":"webhookInboxReceive","tags":["Storage & Services"],"summary":"Receive a webhook payload","description":"Captures an incoming POST payload into the specified inbox. Point webhook providers (Stripe, GitHub, etc.) to this URL. Accepts any JSON body.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Inbox ID returned from /v1/webhook/inbox/create","example":"a1b2c3d4"}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"received":{"type":"boolean"},"payload_id":{"type":"string"}},"example":{"received":true,"payload_id":"e5f6g7h8"}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"404":{"description":"Inbox not found or expired","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/webhook/inbox/{id}":{"get":{"operationId":"webhookInboxGet","tags":["Storage & Services"],"summary":"Get inbox metadata","description":"Returns metadata for a webhook inbox: creation time, receive URL, payloads URL, and current payload count.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"example":"a1b2c3d4"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"inbox_id":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"receive_url":{"type":"string"},"payloads_url":{"type":"string"},"payload_count":{"type":"integer"}},"example":{"inbox_id":"a1b2c3d4","created_at":"2026-04-15T10:00:00.000Z","receive_url":"https://api.botoi.com/v1/webhook/inbox/a1b2c3d4/receive","payloads_url":"https://api.botoi.com/v1/webhook/inbox/a1b2c3d4/payloads","payload_count":3}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"404":{"description":"Inbox not found or expired","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/webhook/inbox/{id}/payloads":{"get":{"operationId":"webhookInboxPayloads","tags":["Storage & Services"],"summary":"List captured webhook payloads","description":"Returns up to 50 of the most recent payloads captured by the inbox, each with an id, received_at timestamp, and the original JSON body.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"example":"a1b2c3d4"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"inbox_id":{"type":"string"},"count":{"type":"integer"},"payloads":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"received_at":{"type":"string","format":"date-time"},"body":{"type":"object","additionalProperties":true}}}}},"example":{"inbox_id":"a1b2c3d4","count":1,"payloads":[{"id":"e5f6g7h8","received_at":"2026-04-15T10:30:00.000Z","body":{"event":"payment.completed","amount":4999}}]}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"404":{"description":"Inbox not found or expired","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/webhook/inbox/{id}/list":{"post":{"operationId":"webhookInboxListDeprecated","tags":["Storage & Services"],"deprecated":true,"summary":"List captured webhook payloads (deprecated)","description":"Deprecated alias for `GET /v1/webhook/inbox/{id}/payloads`. Returns the same list of up to 50 recent payloads. Kept for SDK and backward compatibility. Prefer the GET endpoint for new integrations.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"example":"a1b2c3d4"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"inbox_id":{"type":"string"},"count":{"type":"integer"},"payloads":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"received_at":{"type":"string","format":"date-time"},"body":{"type":"object","additionalProperties":true}}}}}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"404":{"description":"Inbox not found or expired","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/auth/signup":{"post":{"operationId":"authSignup","tags":["Auth"],"summary":"Send a magic-link signup email","description":"Sends a magic-link email to the provided address. Rate-limited to 3 requests per 15 minutes per IP. Clicking the link completes signup and provisions an API key on first use.","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["email"],"properties":{"email":{"type":"string","format":"email","example":"alice@example.com"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"message":{"type":"string"}},"example":{"message":"Check your email for a magic link"}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Too many signup requests","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/auth/verify":{"get":{"operationId":"authVerify","tags":["Auth"],"summary":"Verify a magic-link token","description":"Consumes a one-time magic-link token. On success, redirects to the dashboard with a session cookie and an optional claim token for first-time users. Never returns JSON; it issues a 302 redirect.","security":[],"parameters":[{"name":"token","in":"query","required":true,"schema":{"type":"string"},"description":"The magic-link token delivered by email"}],"responses":{"302":{"description":"Redirects to botoi.com/api/dashboard with session/claim params"}}}},"/auth/claim":{"get":{"operationId":"authClaim","tags":["Auth"],"summary":"Claim a freshly provisioned API key","description":"Exchanges a single-use claim token (returned after signup or key regeneration) for the plaintext API key. The claim token expires 5 minutes after issuance.","security":[],"parameters":[{"name":"token","in":"query","required":true,"schema":{"type":"string"},"description":"Claim token"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"key":{"type":"string","description":"Plaintext API key (shown once)"},"keyId":{"type":"string"}}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"404":{"description":"Claim token expired or already used","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/auth/checkout-claim":{"get":{"operationId":"authCheckoutClaim","tags":["Auth"],"summary":"Finalize a Stripe checkout and claim an API key","description":"Fulfill-on-redirect endpoint for Stripe Checkout success URLs. Verifies the checkout session, provisions the user if needed, updates Unkey rate limits from the purchased tier, and returns session + claim tokens.","security":[],"parameters":[{"name":"checkout_session_id","in":"query","required":true,"schema":{"type":"string"},"description":"The Stripe Checkout session ID"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"sessionToken":{"type":"string"},"claimToken":{"type":"string","nullable":true},"existingUser":{"type":"boolean"}}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment has not completed yet","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"404":{"description":"Stripe checkout session not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/auth/me":{"get":{"operationId":"authMe","tags":["Auth"],"summary":"Get the signed-in user profile","description":"Returns the current user, keyId, tier, and rate-limit quotas. Requires a valid session cookie set by the magic-link flow.","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"email":{"type":"string"},"keyId":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"tier":{"type":"string","enum":["free","starter","pro","scale"]},"limits":{"type":"object","properties":{"requestsPerMinute":{"type":"integer"},"requestsPerDay":{"type":"integer"},"requestsPerMonth":{"type":"integer"}}}}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"404":{"description":"User not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/auth/usage":{"get":{"operationId":"authUsage","tags":["Auth"],"summary":"Get current API usage for the signed-in user","description":"Returns day and month usage counters plus the per-minute rate limit. Requires a valid session cookie.","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"today":{"type":"object","properties":{"used":{"type":"integer"},"limit":{"type":"integer"}}},"month":{"type":"object","properties":{"used":{"type":"integer"},"limit":{"type":"integer"}}},"rateLimit":{"type":"object","properties":{"perMinute":{"type":"integer"}}}}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/auth/regenerate":{"post":{"operationId":"authRegenerate","tags":["Auth"],"summary":"Rotate the signed-in user API key","description":"Revokes the existing Unkey key and provisions a new one. Returns a short-lived claim token used to fetch the new plaintext key. Requires a valid session cookie.","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"claimToken":{"type":"string"}}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"404":{"description":"User not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/billing/checkout":{"post":{"operationId":"billingCheckout","tags":["Billing"],"summary":"Create a Stripe Checkout session","description":"Creates a subscription Checkout session for the selected price tier. Returns the hosted Stripe URL to redirect the customer to. Public endpoint; users do not need an API key yet.","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["priceId"],"properties":{"priceId":{"type":"string","description":"Stripe price ID for one of the Botoi subscription tiers","example":"price_1QabcdEFgh1234"},"email":{"type":"string","format":"email"},"successUrl":{"type":"string"},"cancelUrl":{"type":"string"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"url":{"type":"string"},"sessionId":{"type":"string"}}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/billing/portal":{"post":{"operationId":"billingPortal","tags":["Billing"],"summary":"Create a Stripe Billing Portal session","description":"Creates a Stripe Customer Portal session so the user can update payment methods, download invoices, or cancel. Requires a valid session cookie.","security":[],"parameters":[{"name":"returnUrl","in":"query","required":false,"schema":{"type":"string"},"description":"URL Stripe redirects to when the user exits the portal"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"url":{"type":"string"}}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"404":{"description":"No active subscription found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/billing/change-plan":{"post":{"operationId":"billingChangePlan","tags":["Billing"],"summary":"Upgrade or downgrade the active subscription","description":"Updates the customer subscription to the requested price with prorated billing. Syncs Unkey rate limits to the new tier immediately. Requires a valid session cookie.","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["priceId"],"properties":{"priceId":{"type":"string"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"tier":{"type":"string"},"message":{"type":"string"},"warning":{"type":"string"}}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"403":{"description":"Billing record does not match your account","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"404":{"description":"No subscription found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"502":{"description":"Stripe update failed","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/billing/webhook":{"post":{"operationId":"billingStripeWebhook","tags":["Billing"],"summary":"Stripe webhook receiver","description":"Consumes Stripe webhook events (`checkout.session.completed`, `customer.subscription.updated`, `customer.subscription.deleted`, etc.) to keep billing state and Unkey rate limits in sync. Signed with the Stripe webhook secret; no API key required.","security":[],"parameters":[{"name":"stripe-signature","in":"header","required":true,"schema":{"type":"string"},"description":"Stripe webhook signature header"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"200":{"description":"Event received and processed"},"400":{"description":"Missing or invalid signature","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/image/resize":{"post":{"operationId":"imageResize","tags":["Image & Media"],"summary":"Describe a resize operation for a remote or base64 image","description":"Inspects the source image (URL or base64) and returns the target dimensions, CSS instructions, and size metadata. Native pixel resizing runs client-side; edge Workers cannot process image bytes directly.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["width"],"properties":{"url":{"type":"string"},"base64":{"type":"string"},"width":{"type":"integer","minimum":1},"height":{"type":"integer","minimum":1}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"source":{"type":"string"},"content_type":{"type":"string"},"size_bytes":{"type":"integer"},"target_width":{"type":"integer"},"target_height":{"type":"integer","nullable":true},"css_resize":{"type":"string"},"note":{"type":"string"}}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/image/convert":{"post":{"operationId":"imageConvert","tags":["Image & Media"],"summary":"Describe an image format conversion","description":"Reports whether a requested format conversion (e.g. jpeg->webp) is supported by browsers or common server-side libraries. Actual pixel encoding is not performed on edge Workers.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["from","to"],"properties":{"url":{"type":"string"},"base64":{"type":"string"},"from":{"type":"string","example":"jpeg"},"to":{"type":"string","example":"webp"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"},"supported":{"type":"boolean"},"note":{"type":"string"}}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/image/metadata":{"post":{"operationId":"imageMetadata","tags":["Image & Media"],"summary":"Fetch metadata for a remote or base64 image","description":"Returns content type, byte size, last-modified, and cache-control headers for the provided image URL (via HEAD request) or infers the values from a base64 data URI.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"base64":{"type":"string"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"url":{"type":"string","nullable":true},"content_type":{"type":"string"},"size_bytes":{"type":"integer"},"last_modified":{"type":"string","nullable":true},"cache_control":{"type":"string","nullable":true}}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/pdf/from-html":{"post":{"operationId":"pdfFromHtml","tags":["Image & Media"],"summary":"Wrap HTML for print-to-PDF","description":"Returns HTML wrapped with print-ready `@page` CSS for the chosen paper size and orientation. Open the result in a browser and use File > Print > Save as PDF; edge Workers cannot render binary PDFs directly.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["html"],"properties":{"html":{"type":"string"},"options":{"type":"object","properties":{"format":{"type":"string","enum":["A4","letter"],"default":"A4"},"landscape":{"type":"boolean","default":false}}}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"html":{"type":"string"},"format":{"type":"string"},"landscape":{"type":"boolean"},"note":{"type":"string"}}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/pdf/from-markdown":{"post":{"operationId":"pdfFromMarkdown","tags":["Image & Media"],"summary":"Render Markdown to print-ready HTML","description":"Converts Markdown to HTML and wraps it with print CSS. Open the result in a browser and use File > Print > Save as PDF.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["markdown"],"properties":{"markdown":{"type":"string"},"options":{"type":"object","properties":{"format":{"type":"string","enum":["A4","letter"],"default":"A4"},"landscape":{"type":"boolean","default":false}}}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"html":{"type":"string"},"format":{"type":"string"},"landscape":{"type":"boolean"},"note":{"type":"string"}}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/screenshot/capture":{"post":{"operationId":"screenshotCapture","tags":["Image & Media"],"summary":"Wrap HTML for headless screenshot rendering","description":"Returns HTML with a fixed-size viewport wrapper suitable for headless Chromium/Puppeteer to render and capture at the specified dimensions. Native browser rendering is not available in edge Workers.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["html"],"properties":{"html":{"type":"string"},"width":{"type":"integer","minimum":100,"maximum":4096,"default":1280},"height":{"type":"integer","minimum":100,"maximum":4096,"default":720},"format":{"type":"string","enum":["png","jpeg"],"default":"png"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"html":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"},"format":{"type":"string"},"note":{"type":"string"}}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/svg/optimize":{"post":{"operationId":"svgOptimize","tags":["Image & Media"],"summary":"Optimize an SVG string","description":"Removes XML declarations, comments, editor metadata, empty elements, and collapses whitespace. Returns the optimized SVG along with original and final byte sizes.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["svg"],"properties":{"svg":{"type":"string"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"optimized":{"type":"string"},"original_size":{"type":"integer"},"optimized_size":{"type":"integer"},"savings_percent":{"type":"number"}}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/code/detect":{"post":{"operationId":"codeDetect","tags":["Developer Utilities"],"summary":"Detect the programming language of a snippet","description":"Scores the snippet against language heuristics (keywords, syntax tokens) and returns the best guess with a confidence score and up to 3 alternatives.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"language":{"type":"string"},"confidence":{"type":"number"},"alternatives":{"type":"array","items":{"type":"object","properties":{"language":{"type":"string"},"confidence":{"type":"number"}}}}}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/code/highlight":{"post":{"operationId":"codeHighlight","tags":["Developer Utilities"],"summary":"Syntax-highlight code as HTML","description":"Tokenizes the snippet and wraps each token in a styled `` suitable for dropping into a page. Supports a dark or light color theme.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["code","language"],"properties":{"code":{"type":"string"},"language":{"type":"string","example":"javascript"},"theme":{"type":"string","enum":["dark","light"],"default":"dark"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"html":{"type":"string"},"language":{"type":"string"},"theme":{"type":"string"}}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/emoji/search":{"post":{"operationId":"emojiSearch","tags":["Text & Data"],"summary":"Search the emoji database","description":"Returns emojis whose name or keywords include the query. Responses include the emoji character, canonical name, Unicode code points, and matching keywords.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["query"],"properties":{"query":{"type":"string","example":"happy"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":20}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"emoji":{"type":"string"},"name":{"type":"string"},"unicode":{"type":"string"},"keywords":{"type":"array","items":{"type":"string"}}}}},"count":{"type":"integer"}}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/regex/generate":{"post":{"operationId":"regexGenerate","tags":["Developer Utilities"],"summary":"Generate a regex pattern from a description","description":"Matches the description against known patterns (email, URL, phone, date, IPv4, hex color, UUID, credit card, ZIP) and returns the corresponding regex. If `test_string` is supplied, also runs the pattern against it.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["description"],"properties":{"description":{"type":"string","example":"email"},"test_string":{"type":"string"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"pattern":{"type":"string"},"flags":{"type":"string"},"description":{"type":"string"},"test_result":{"type":"object","properties":{"matches":{"type":"boolean"},"found":{"type":"array","items":{"type":"string"}}}}}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/country/lookup":{"post":{"operationId":"countryLookup","tags":["Text & Data"],"summary":"Look up country metadata","description":"Resolves a country by ISO 3166-1 alpha-2 code, alpha-3 code, or (partial) name. Returns the canonical record including dial codes and currency.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["query"],"properties":{"query":{"type":"string","example":"US"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"country":{"type":"object","additionalProperties":true}}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"404":{"description":"No country found for the query","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/number/spell":{"post":{"operationId":"numberSpell","tags":["Text & Data"],"summary":"Spell a number in words","description":"Spells a finite number in English words (other locales fall back to English with a note). Supports integers and up to trillions plus decimal digits.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["number"],"properties":{"number":{"type":"number","example":1234},"locale":{"type":"string","example":"en"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"words":{"type":"string"},"number":{"type":"number"}}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/text/readability":{"post":{"operationId":"textReadability","tags":["Text & Data"],"summary":"Calculate readability scores","description":"Returns Flesch-Kincaid grade, Flesch reading ease, and Gunning Fog indices for the supplied text, along with sentence/word/syllable counts.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["text"],"properties":{"text":{"type":"string"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"flesch_kincaid_grade":{"type":"number"},"flesch_reading_ease":{"type":"number"},"gunning_fog":{"type":"number"},"sentences":{"type":"integer"},"words":{"type":"integer"},"syllables":{"type":"integer"},"complex_words":{"type":"integer"}}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/text/similarity":{"post":{"operationId":"textSimilarity","tags":["Text & Data"],"summary":"Compute text similarity","description":"Returns the similarity score between two text snippets using either cosine (default) or jaccard word-set comparison. Output is in the 0-1 range.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["text_a","text_b"],"properties":{"text_a":{"type":"string"},"text_b":{"type":"string"},"method":{"type":"string","enum":["cosine","jaccard"],"default":"cosine"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"similarity":{"type":"number"},"method":{"type":"string"}}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/currency/convert":{"post":{"operationId":"currencyConvert","tags":["Lookup"],"summary":"Convert between currencies","description":"Uses live exchange rates from Frankfurter to convert a given `amount` from one ISO 4217 code to another.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["amount","from","to"],"properties":{"amount":{"type":"number","example":100},"from":{"type":"string","example":"USD"},"to":{"type":"string","example":"EUR"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"amount":{"type":"number"},"from":{"type":"string"},"to":{"type":"string"},"result":{"type":"number"},"rate":{"type":"number"},"timestamp":{"type":"string","format":"date-time"}}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/currency/rates":{"post":{"operationId":"currencyRates","tags":["Lookup"],"summary":"Get exchange rates for a base currency","description":"Returns the latest cross rates for the base currency (defaults to USD) from Frankfurter.","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"base":{"type":"string","default":"USD"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"base":{"type":"string"},"date":{"type":"string","format":"date"},"rates":{"type":"object","additionalProperties":{"type":"number"}}}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/currency-list/list":{"get":{"operationId":"currencyListList","tags":["Lookup"],"summary":"List ISO 4217 currencies","description":"Returns the full static currency catalog with names, symbols, decimal digits, and country codes. Accepts an optional `filter` or `q` query param for case-insensitive substring matching against code or name.","parameters":[{"name":"filter","in":"query","schema":{"type":"string"}},{"name":"q","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"currencies":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"},"symbol":{"type":"string"},"decimal_digits":{"type":"integer"},"countries":{"type":"array","items":{"type":"string"}}}}},"count":{"type":"integer"}}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"404":{"description":"No currencies matched the filter","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/ical/parse":{"post":{"operationId":"icalParse","tags":["Text & Data"],"summary":"Parse an iCalendar (ICS) feed","description":"Parses RFC 5545 content and extracts `VEVENT` entries with UID, summary, description, location, start, end, and all-day status.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["ics"],"properties":{"ics":{"type":"string"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"events":{"type":"array","items":{"type":"object","properties":{"uid":{"type":"string"},"summary":{"type":"string"},"description":{"type":"string"},"location":{"type":"string"},"start":{"type":"string"},"end":{"type":"string"},"all_day":{"type":"boolean"}}}},"count":{"type":"integer"}}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/ical/generate":{"post":{"operationId":"icalGenerate","tags":["Text & Data"],"summary":"Generate an iCalendar (ICS) feed","description":"Builds a VCALENDAR/VEVENT string from one or more events. Accepts all-day (YYYY-MM-DD) or timed (ISO 8601) start/end values.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["events"],"properties":{"events":{"type":"array","minItems":1,"items":{"type":"object","required":["summary","start"],"properties":{"summary":{"type":"string"},"start":{"type":"string"},"end":{"type":"string"},"description":{"type":"string"},"location":{"type":"string"}}}}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"ics":{"type":"string"},"events":{"type":"integer"}}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/json-extra/flatten":{"post":{"operationId":"jsonExtraFlatten","tags":["Text & Data"],"summary":"Flatten nested JSON to a single-level map","description":"Walks the object tree and produces `{\"a.b.c\": value}` style flat keys. Supports a custom delimiter.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["json"],"properties":{"json":{"type":"object","additionalProperties":true},"delimiter":{"type":"string","default":"."}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"flattened":{"type":"object","additionalProperties":true},"keys":{"type":"integer"}}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/json-extra/unflatten":{"post":{"operationId":"jsonExtraUnflatten","tags":["Text & Data"],"summary":"Unflatten a dotted JSON map","description":"Reverses `/flatten`. Interprets numeric path parts as array indexes and reconstructs nested arrays/objects.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["json"],"properties":{"json":{"type":"object","additionalProperties":true},"delimiter":{"type":"string","default":"."}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"unflattened":{}}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/sql/parse":{"post":{"operationId":"sqlParse","tags":["Developer Utilities"],"summary":"Parse a SQL statement","description":"Best-effort parser that identifies the statement type, referenced tables and columns, and whether it contains WHERE/JOIN/subqueries.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["sql"],"properties":{"sql":{"type":"string"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"type":{"type":"string"},"tables":{"type":"array","items":{"type":"string"}},"columns":{"type":"array","items":{"type":"string"}},"has_where":{"type":"boolean"},"has_join":{"type":"boolean"},"has_subquery":{"type":"boolean"}}},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"duration":{"type":"number"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/v1/metatag/generate":{"post":{"operationId":"metatagGenerate","tags":["Text & Data"],"summary":"Generate SEO and social meta tags","description":"Produces `