{"openapi":"3.1.0","info":{"title":"FinchFile Paint API","version":"1.0.0","description":"Real paint-color palettes from our database. Never invents brand names or codes."},"servers":[{"url":"https://finchfile.com"}],"security":[{"bearerAuth":[]},{"apiKey":[]}],"paths":{"/api/palette":{"post":{"operationId":"createPalette","summary":"Recommend 3 palettes from room analysis JSON","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RoomAnalysis"}}}},"responses":{"200":{"description":"Three palettes of real database colors"}}}},"/api/colors/match":{"get":{"operationId":"matchColors","summary":"Closest real colors to a hex (Delta E 2000)","parameters":[{"name":"hex","in":"query","required":true,"schema":{"type":"string","example":"#D1CBC1"}},{"name":"brand","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":8}}],"responses":{"200":{"description":"Matches"}}}},"/api/colors/{brand}/{code}":{"get":{"operationId":"getColor","summary":"Full color details + cross-brand dupes","parameters":[{"name":"brand","in":"path","required":true,"schema":{"type":"string","example":"sherwin-williams"}},{"name":"code","in":"path","required":true,"schema":{"type":"string","example":"SW 7029"}}],"responses":{"200":{"description":"Color"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"},"apiKey":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"RoomAnalysis":{"type":"object","required":["roomType","naturalLight","currentWallHex","fixedElements","style"],"properties":{"roomType":{"type":"string"},"naturalLight":{"type":"object","properties":{"amount":{"type":"string","enum":["low","medium","high"]},"direction":{"type":"string"}}},"currentWallHex":{"type":"string"},"fixedElements":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"label":{"type":"string"},"hex":{"type":"string"}}}},"style":{"type":"string"}}}}}}