{
  "openapi": "3.0.3",
  "info": {
    "title": "icons-gen API",
    "version": "1.0.0",
    "description": "Generate Chrome extension / PWA / favicon icons as SVG. Free, no auth. Human editor with PNG export at https://icons-gen.pages.dev/"
  },
  "servers": [
    {
      "url": "https://icons-gen.pages.dev"
    }
  ],
  "paths": {
    "/api/icon.png": {
      "get": {
        "summary": "Single PNG icon (deterministic bundled font)",
        "parameters": [
          {
            "name": "text",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 4
            },
            "description": "Icon text, 1-4 characters (default IG)"
          },
          {
            "name": "bg",
            "in": "query",
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-fA-F]{6}$"
            },
            "description": "Background color hex without # (default 0f766e)"
          },
          {
            "name": "fg",
            "in": "query",
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-fA-F]{6}$"
            },
            "description": "Text color hex without # (default ffffff)"
          },
          {
            "name": "radius",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 50
            },
            "description": "Corner radius as % of size, 50 = circle (default 12)"
          },
          {
            "name": "scale",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 40,
              "maximum": 130
            },
            "description": "Text size % (default 100)"
          },
          {
            "name": "preset",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "chrome",
                "pwa",
                "favicon"
              ]
            },
            "description": "Size preset (default chrome)"
          },
          {
            "name": "maskable",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "1",
                "0"
              ]
            },
            "description": "PWA maskable mode (pwa preset only)"
          },
          {
            "name": "transparent",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "1",
                "0"
              ]
            },
            "description": "Transparent background (ignored for maskable)"
          },
          {
            "name": "size",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 8,
              "maximum": 512
            },
            "description": "Icon size in px (default 128)"
          }
        ],
        "responses": {
          "200": {
            "description": "PNG image",
            "content": {
              "image/png": {}
            }
          }
        }
      }
    },
    "/api/icon.svg": {
      "get": {
        "summary": "Single SVG icon",
        "parameters": [
          {
            "name": "text",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 4
            },
            "description": "Icon text, 1-4 characters (default IG)"
          },
          {
            "name": "bg",
            "in": "query",
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-fA-F]{6}$"
            },
            "description": "Background color hex without # (default 0f766e)"
          },
          {
            "name": "fg",
            "in": "query",
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-fA-F]{6}$"
            },
            "description": "Text color hex without # (default ffffff)"
          },
          {
            "name": "radius",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 50
            },
            "description": "Corner radius as % of size, 50 = circle (default 12)"
          },
          {
            "name": "scale",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 40,
              "maximum": 130
            },
            "description": "Text size % (default 100)"
          },
          {
            "name": "preset",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "chrome",
                "pwa",
                "favicon"
              ]
            },
            "description": "Size preset (default chrome)"
          },
          {
            "name": "maskable",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "1",
                "0"
              ]
            },
            "description": "PWA maskable mode (pwa preset only)"
          },
          {
            "name": "transparent",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "1",
                "0"
              ]
            },
            "description": "Transparent background (ignored for maskable)"
          },
          {
            "name": "size",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 8,
              "maximum": 1024
            },
            "description": "Icon size in px (default 128)"
          }
        ],
        "responses": {
          "200": {
            "description": "SVG image",
            "content": {
              "image/svg+xml": {}
            }
          }
        }
      }
    },
    "/api/pack.zip": {
      "get": {
        "summary": "ZIP with all preset sizes, manifest snippet and README",
        "parameters": [
          {
            "name": "text",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 4
            },
            "description": "Icon text, 1-4 characters (default IG)"
          },
          {
            "name": "bg",
            "in": "query",
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-fA-F]{6}$"
            },
            "description": "Background color hex without # (default 0f766e)"
          },
          {
            "name": "fg",
            "in": "query",
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-fA-F]{6}$"
            },
            "description": "Text color hex without # (default ffffff)"
          },
          {
            "name": "radius",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 50
            },
            "description": "Corner radius as % of size, 50 = circle (default 12)"
          },
          {
            "name": "scale",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 40,
              "maximum": 130
            },
            "description": "Text size % (default 100)"
          },
          {
            "name": "preset",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "chrome",
                "pwa",
                "favicon"
              ]
            },
            "description": "Size preset (default chrome)"
          },
          {
            "name": "maskable",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "1",
                "0"
              ]
            },
            "description": "PWA maskable mode (pwa preset only)"
          },
          {
            "name": "transparent",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "1",
                "0"
              ]
            },
            "description": "Transparent background (ignored for maskable)"
          }
        ],
        "responses": {
          "200": {
            "description": "ZIP archive",
            "content": {
              "application/zip": {}
            }
          }
        }
      }
    },
    "/api/manifest": {
      "get": {
        "summary": "manifest.json snippet (or favicon link tags)",
        "parameters": [
          {
            "name": "text",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 4
            },
            "description": "Icon text, 1-4 characters (default IG)"
          },
          {
            "name": "bg",
            "in": "query",
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-fA-F]{6}$"
            },
            "description": "Background color hex without # (default 0f766e)"
          },
          {
            "name": "fg",
            "in": "query",
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-fA-F]{6}$"
            },
            "description": "Text color hex without # (default ffffff)"
          },
          {
            "name": "radius",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 50
            },
            "description": "Corner radius as % of size, 50 = circle (default 12)"
          },
          {
            "name": "scale",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 40,
              "maximum": 130
            },
            "description": "Text size % (default 100)"
          },
          {
            "name": "preset",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "chrome",
                "pwa",
                "favicon"
              ]
            },
            "description": "Size preset (default chrome)"
          },
          {
            "name": "maskable",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "1",
                "0"
              ]
            },
            "description": "PWA maskable mode (pwa preset only)"
          },
          {
            "name": "transparent",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "1",
                "0"
              ]
            },
            "description": "Transparent background (ignored for maskable)"
          }
        ],
        "responses": {
          "200": {
            "description": "Snippet"
          }
        }
      }
    }
  }
}