Muro Paint Colors

Find paint colours by name or code across all brands, e.g. "Hague Blue", "SW 7029", "agreeable gray", "grün". Matching ignores case and accents ("sniezny" finds "Śnieżny") and every word may be a prefix. Optionally restrict to one brand. Returns name, brand, code, hex, LRV (light reflectance, 0 = black, 100 = white), collection and the colour page url. To match a hex value or a colour from another brand, use find_equivalents instead.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Colour name or code, or part of it"
    },
    "brand": {
      "description": "Brand name, e.g. \"Benjamin Moore\", \"Farrow & Ball\", \"Dulux\"",
      "type": "string",
      "maxLength": 60
    },
    "limit": {
      "default": 10,
      "description": "Maximum results (default 10)",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Look up one paint colour by brand and exact name or code, e.g. brand "Sherwin-Williams" + "SW 7029" or "Agreeable Gray"; brand "Farrow & Ball" + "Hague Blue" or "30". Case, spacing and accents are ignored. A brand sold in several markets (Dulux UK/PL, Sikkens NL/DE/IT, Beckers SE/PL) may return one match per market. If nothing matches exactly, returns close suggestions instead.

{
  "type": "object",
  "properties": {
    "brand": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60,
      "description": "Brand name, e.g. \"Behr\", \"Benjamin Moore\", \"Śnieżka\""
    },
    "name_or_code": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Exact colour name or manufacturer code"
    }
  },
  "required": [
    "brand",
    "name_or_code"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Find the closest colours in OTHER brands to a given paint colour or hex value, e.g. "Behr equivalent of Farrow & Ball Hague Blue" or "which Benjamin Moore is closest to #D1CBC1". Give either brand + name_or_code, or hex. Distance is CIEDE2000 ΔE with a verdict: under 1 practically identical, under 2 very close, under 3.5 close, otherwise similar (nothing above ΔE 6 is returned). By default returns the single best match per brand, closest first; pass brands to restrict the search (with one brand you get several options from it). Always pass on the caveat that on-wall results depend on base, sheen and tinting.

{
  "type": "object",
  "properties": {
    "brand": {
      "description": "Brand of the source colour (with name_or_code)",
      "type": "string",
      "maxLength": 60
    },
    "name_or_code": {
      "description": "Name or code of the source colour",
      "type": "string",
      "maxLength": 100
    },
    "hex": {
      "description": "Source colour as hex, e.g. \"#3D4E57\" (instead of brand + name_or_code)",
      "type": "string",
      "maxLength": 7
    },
    "brands": {
      "description": "Only search these brands, e.g. [\"Behr\", \"Sherwin-Williams\"]",
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 60
      }
    },
    "limit": {
      "default": 8,
      "description": "Maximum results (default 8)",
      "type": "integer",
      "minimum": 1,
      "maximum": 30
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List the paint brands in the database with their number of colours and a brand page url. With country (ISO code like "DE", "PL", "US", "GB" or a name like "Germany"), returns the brands sold there in order of local relevance.

{
  "type": "object",
  "properties": {
    "country": {
      "description": "Country code or name, e.g. \"US\", \"DE\", \"Poland\"",
      "type": "string",
      "maxLength": 40
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Paid tools only. Show the Muro credit balance and plan of the connected account. Painting costs 1 credit per colour in Standard, 2 in HD and 3 in Ultra.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Paid (Muro credits, needs a Muro API key). Repaint the walls in a photo of a room, facade or roof in 1 to 12 colours at once and return one image per colour. Give the photo as image_url (a public link) or image_base64. Give each colour as brand + name_or_code from the catalogue (e.g. "Farrow & Ball" + "Hague Blue") or as hex. Waits up to about 45 seconds; if some colours are still being painted, it returns a job_id for get_visualization. Tell the user the cost before calling: 1 credit per colour in standard quality.

{
  "type": "object",
  "properties": {
    "image_url": {
      "description": "Public link to the photo (JPEG, PNG or WebP, up to 12 MB)",
      "type": "string",
      "maxLength": 2048
    },
    "image_base64": {
      "description": "The photo as base64 or a data: URL, instead of image_url",
      "type": "string"
    },
    "colors": {
      "minItems": 1,
      "maxItems": 12,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "brand": {
            "description": "Paint brand, e.g. \"Farrow & Ball\" (with name_or_code)",
            "type": "string",
            "maxLength": 60
          },
          "name_or_code": {
            "description": "Colour name or code in that brand, e.g. \"Hague Blue\" or \"30\"",
            "type": "string",
            "maxLength": 100
          },
          "hex": {
            "description": "Colour as hex, e.g. \"#3D4E57\" (instead of brand + name_or_code)",
            "type": "string",
            "maxLength": 7
          },
          "label": {
            "description": "Optional display name for a hex colour",
            "type": "string",
            "maxLength": 60
          }
        }
      },
      "description": "1 to 12 colours; each one is a separate painted image"
    },
    "surface": {
      "default": "interior",
      "description": "What is in the photo",
      "type": "string",
      "enum": [
        "interior",
        "facade",
        "roof"
      ]
    },
    "quality": {
      "default": "standard",
      "description": "standard ≈1K (1 credit per colour), hd ≈2K (2), ultra ≈4K (3; plan permitting)",
      "type": "string",
      "enum": [
        "standard",
        "hd",
        "ultra"
      ]
    },
    "paint_ceiling": {
      "default": false,
      "description": "Interiors only: paint the ceiling too",
      "type": "boolean"
    }
  },
  "required": [
    "colors"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Paid tools. Fetch the colours of a visualize_room job that were not ready yet, by job_id and project_id. Waits up to about 25 seconds. Costs nothing extra.

{
  "type": "object",
  "properties": {
    "job_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "job_id from visualize_room"
    },
    "project_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "project_id from visualize_room"
    }
  },
  "required": [
    "job_id",
    "project_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Paid (1 credit). Relight a finished interior visualization as day, evening or night, with lamps on or off, keeping the wall colour. Needs project_id and the color_key returned by visualize_room.

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "project_id from visualize_room"
    },
    "color_key": {
      "type": "string",
      "minLength": 1,
      "maxLength": 40,
      "description": "color_key of the painted result, e.g. \"c1\""
    },
    "time": {
      "type": "string",
      "enum": [
        "day",
        "evening",
        "night"
      ],
      "description": "Time of day"
    },
    "lamps": {
      "default": false,
      "description": "Lamps on",
      "type": "boolean"
    }
  },
  "required": [
    "project_id",
    "color_key",
    "time"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}