happytails.ai

API Enum Migration Mapper

Open API Enum Migration Mapper on Happytails.ai. This view has the same page content and links, with explicit tool capabilities. Read the processing notes before using a tool.

Tool capabilities

{
  "id": "api-enum-migration-mapper",
  "category": "developer-tools",
  "built": true,
  "requirements": "Accepts up to 200,000 characters per definition and up to 10,000 values per enum. Matching is done in your browser. Downloads are two CSV files and a JSON report.",
  "implementation": {
    "fields": [
      {
        "key": "next",
        "label": "New enum definition",
        "value": "",
        "type": "textarea",
        "maxLength": 200000,
        "help": "Paste the new version in the same kinds of format as the old one."
      },
      {
        "key": "format",
        "label": "Definition format",
        "value": "auto",
        "type": "select",
        "values": [
          "auto",
          "json",
          "yaml",
          "graphql",
          "proto",
          "list"
        ]
      },
      {
        "key": "pointer",
        "label": "JSON Pointer to the enum, optional",
        "value": "",
        "type": "text",
        "maxLength": 2000,
        "help": "For JSON or YAML with several enums, such as /components/schemas/Status."
      },
      {
        "key": "name",
        "label": "Enum name, optional",
        "value": "",
        "type": "text",
        "maxLength": 200,
        "help": "For GraphQL or protobuf files with several enums."
      },
      {
        "key": "matching",
        "label": "Automatic matching",
        "value": "normalized",
        "type": "select",
        "values": [
          "normalized",
          "case-insensitive",
          "exact"
        ]
      },
      {
        "key": "overrides",
        "label": "Confirmed overrides, optional",
        "value": "",
        "type": "textarea",
        "maxLength": 200000,
        "help": "CSV with the headers from,to. Leave to empty to mark a value as removed."
      }
    ],
    "registrationFamily": "api-contracts-reference",
    "codeDirection": "ltr",
    "inputMaxLength": 200000,
    "inputErrorCode": "API_CONTRACTS_REFERENCE_TOO_LONG",
    "note": "Runs in your browser in a background worker. Accepts up to 200000 characters per definition and 10000 enum values.",
    "experience": {
      "automatic": false,
      "single": false,
      "inputMaxLength": 200000,
      "inputMode": "text",
      "label": "Old enum definition",
      "placeholder": "enum: [pending, on_hold, shipped]",
      "help": "JSON Schema, OpenAPI, GraphQL enum, .proto enum or one value per line. Up to 200,000 characters. Review the settings before running.",
      "helpParts": [
        "JSON Schema, OpenAPI, GraphQL enum, .proto enum or one value per line.",
        "Up to 200,000 characters.",
        "Review the settings before running."
      ],
      "action": null
    },
    "mode": "explicit",
    "interactive": false
  },
  "execution": "Browser interface",
  "api": null,
  "browser_agent": {
    "supported": true,
    "name": "run_current_tool",
    "discovery": "WebMCP on the human page in a supporting browser",
    "verification": "See audit/API-AUDIT.md; availability is not verification"
  }
}

Page guide

Map the values of an old enum to a new one and see which values are unmapped, removed or new. Works with JSON Schema, OpenAPI, GraphQL, protobuf and plain lists.

How to use API Enum Migration Mapper
  1. Paste the old enum definition.
  2. Paste the new enum definition and choose how values are matched.
  3. Add confirmed overrides for values that were renamed.
  4. Run the mapping and download the from,to CSV and the review table.

Useful next steps

Dataset value mapperJSON schema validatorYAML to JSON

Accepts up to 200,000 characters per definition and up to 10,000 values per enum. Matching is done in your browser. Downloads are two CSV files and a JSON report.

Matching

Identical values of the same JSON type map exactly. Normalized matching also ignores letter case, spaces, dashes and underscores while preserving other punctuation and Unicode characters. When two new values could match, the old value is marked ambiguous instead of guessing. Distinct values in one enum that have identical CSV text, such as 1 and "1", are rejected because a two-column migration file cannot distinguish them. Overrides entered as from,to CSV win; an empty to marks a removed value.

Where enums are found

For JSON or YAML the tool uses the only enum array in the document, or the one your JSON Pointer names. For GraphQL SDL and .proto files it uses the only enum, or the one you name. A plain list uses one value per line.

Using the result

The from,to CSV contains only mapped values, ready for Dataset value mapper. The review CSV lists every old value with its status and every new value that nothing maps to. The tool builds the map; it does not change your data.