# Community
Publish, share, and discover palettes in the community gallery.
## List publicly shared palettes
> Returns a paginated list of community palettes where \`is\_shared\` is \`true\`, ordered by most recently published then by popularity.
```json
{"openapi":"3.1.0","info":{"title":"UI Color Palette API","version":"1.0.0"},"tags":[{"name":"Community","description":"Publish, share, and discover palettes in the community gallery.\n"}],"servers":[{"url":"https://api-uicp.yelbolt.workers.dev/v1","description":"Production"}],"paths":{"/list-published-palettes":{"get":{"operationId":"listPublishedPalettes","summary":"List publicly shared palettes","description":"Returns a paginated list of community palettes where `is_shared` is `true`, ordered by most recently published then by popularity.\n","tags":["Community"],"parameters":[{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1},"description":"Page number (1-based)."},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20},"description":"Number of results per page (max 50)."},{"name":"search","in":"query","schema":{"type":"string"},"description":"Case-insensitive substring search on palette name."}],"responses":{"200":{"description":"Array of published palettes","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PublishedPalette"}}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"schemas":{"PublishedPalette":{"type":"object","properties":{"palette_id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string","nullable":true},"preset":{"$ref":"#/components/schemas/PresetConfiguration"},"shift":{"$ref":"#/components/schemas/ShiftConfiguration"},"are_source_colors_locked":{"type":"boolean"},"colors":{"type":"array","items":{"$ref":"#/components/schemas/ColorConfiguration"}},"themes":{"type":"array","items":{"$ref":"#/components/schemas/ThemeConfiguration"}},"color_space":{"$ref":"#/components/schemas/ColorSpace"},"algorithm_version":{"$ref":"#/components/schemas/AlgorithmVersion"},"creator_full_name":{"type":"string","nullable":true},"creator_avatar_url":{"type":"string","nullable":true},"is_shared":{"type":"boolean"},"star_count":{"type":"integer"}}},"PresetConfiguration":{"type":"object","required":["id","name","stops","min","max","easing"],"properties":{"id":{"type":"string","description":"Unique identifier for the preset. Auto-generated if omitted on creation."},"name":{"type":"string"},"stops":{"type":"array","items":{"type":"integer","minimum":0}},"min":{"type":"number","minimum":0,"maximum":100},"max":{"type":"number","minimum":0,"maximum":100},"easing":{"$ref":"#/components/schemas/EasingFunction"}}},"EasingFunction":{"type":"string","enum":["NONE","LINEAR","EASEIN_SINE","EASEOUT_SINE","EASEINOUT_SINE","EASEIN_QUAD","EASEOUT_QUAD","EASEINOUT_QUAD","EASEIN_CUBIC","EASEOUT_CUBIC","EASEINOUT_CUBIC"]},"ShiftConfiguration":{"type":"object","required":["chroma","hue"],"properties":{"chroma":{"type":"number"},"hue":{"type":"number"}}},"ColorConfiguration":{"type":"object","required":["name","rgb","hue","chroma","alpha"],"properties":{"id":{"type":"string","description":"Auto-generated if omitted."},"name":{"type":"string"},"rgb":{"$ref":"#/components/schemas/RgbChannel"},"hue":{"type":"object","required":["shift","isLocked"],"properties":{"shift":{"type":"number"},"isLocked":{"type":"boolean"}}},"chroma":{"type":"object","required":["shift","isLocked"],"properties":{"shift":{"type":"number"},"isLocked":{"type":"boolean"}}},"alpha":{"type":"object","required":["isEnabled","backgroundColor"],"properties":{"isEnabled":{"type":"boolean"},"backgroundColor":{"$ref":"#/components/schemas/HexColor"}}}}},"RgbChannel":{"type":"object","required":["r","g","b"],"properties":{"r":{"type":"number","minimum":0,"maximum":1},"g":{"type":"number","minimum":0,"maximum":1},"b":{"type":"number","minimum":0,"maximum":1}}},"HexColor":{"type":"string","pattern":"^#[0-9a-fA-F]{3,8}$"},"ThemeConfiguration":{"type":"object","required":["name"],"properties":{"id":{"type":"string","description":"Auto-generated if omitted."},"name":{"type":"string"},"scale":{"type":"object","description":"Map of stop names to lightness values (0–100). When omitted the preset stops are used unchanged.\n","additionalProperties":{"type":"number","minimum":0,"maximum":100}},"paletteBackground":{"$ref":"#/components/schemas/HexColor"},"textColorsTheme":{"type":"object","required":["lightColor","darkColor"],"properties":{"lightColor":{"$ref":"#/components/schemas/HexColor"},"darkColor":{"$ref":"#/components/schemas/HexColor"}}},"visionSimulationMode":{"$ref":"#/components/schemas/VisionSimulationMode"},"type":{"type":"string","enum":["default theme","custom theme"]}}},"VisionSimulationMode":{"type":"string","enum":["NONE","PROTANOMALY","PROTANOPIA","DEUTERANOMALY","DEUTERANOPIA","TRITANOMALY","TRITANOPIA","ACHROMATOMALY","ACHROMATOPSIA"]},"ColorSpace":{"type":"string","enum":["LCH","OKLCH","LAB","OKLAB","HSL","HSLUV","HSV","CMYK","RGB","HEX","P3"]},"AlgorithmVersion":{"type":"string","enum":["v1","v2","v3"]},"ErrorResponse":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}}}}}
```
## List the authenticated user's palettes
> Returns a paginated list of palettes belonging to the authenticated user (both shared and private).
```json
{"openapi":"3.1.0","info":{"title":"UI Color Palette API","version":"1.0.0"},"tags":[{"name":"Community","description":"Publish, share, and discover palettes in the community gallery.\n"}],"servers":[{"url":"https://api-uicp.yelbolt.workers.dev/v1","description":"Production"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Supabase access token obtained from the `/authenticate` SSE flow. Pass it as `Authorization: Bearer `.\n"}},"schemas":{"MyPublishedPalette":{"allOf":[{"$ref":"#/components/schemas/PublishedPalette"},{"type":"object","properties":{"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"published_at":{"type":"string","format":"date-time"}}}]},"PublishedPalette":{"type":"object","properties":{"palette_id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string","nullable":true},"preset":{"$ref":"#/components/schemas/PresetConfiguration"},"shift":{"$ref":"#/components/schemas/ShiftConfiguration"},"are_source_colors_locked":{"type":"boolean"},"colors":{"type":"array","items":{"$ref":"#/components/schemas/ColorConfiguration"}},"themes":{"type":"array","items":{"$ref":"#/components/schemas/ThemeConfiguration"}},"color_space":{"$ref":"#/components/schemas/ColorSpace"},"algorithm_version":{"$ref":"#/components/schemas/AlgorithmVersion"},"creator_full_name":{"type":"string","nullable":true},"creator_avatar_url":{"type":"string","nullable":true},"is_shared":{"type":"boolean"},"star_count":{"type":"integer"}}},"PresetConfiguration":{"type":"object","required":["id","name","stops","min","max","easing"],"properties":{"id":{"type":"string","description":"Unique identifier for the preset. Auto-generated if omitted on creation."},"name":{"type":"string"},"stops":{"type":"array","items":{"type":"integer","minimum":0}},"min":{"type":"number","minimum":0,"maximum":100},"max":{"type":"number","minimum":0,"maximum":100},"easing":{"$ref":"#/components/schemas/EasingFunction"}}},"EasingFunction":{"type":"string","enum":["NONE","LINEAR","EASEIN_SINE","EASEOUT_SINE","EASEINOUT_SINE","EASEIN_QUAD","EASEOUT_QUAD","EASEINOUT_QUAD","EASEIN_CUBIC","EASEOUT_CUBIC","EASEINOUT_CUBIC"]},"ShiftConfiguration":{"type":"object","required":["chroma","hue"],"properties":{"chroma":{"type":"number"},"hue":{"type":"number"}}},"ColorConfiguration":{"type":"object","required":["name","rgb","hue","chroma","alpha"],"properties":{"id":{"type":"string","description":"Auto-generated if omitted."},"name":{"type":"string"},"rgb":{"$ref":"#/components/schemas/RgbChannel"},"hue":{"type":"object","required":["shift","isLocked"],"properties":{"shift":{"type":"number"},"isLocked":{"type":"boolean"}}},"chroma":{"type":"object","required":["shift","isLocked"],"properties":{"shift":{"type":"number"},"isLocked":{"type":"boolean"}}},"alpha":{"type":"object","required":["isEnabled","backgroundColor"],"properties":{"isEnabled":{"type":"boolean"},"backgroundColor":{"$ref":"#/components/schemas/HexColor"}}}}},"RgbChannel":{"type":"object","required":["r","g","b"],"properties":{"r":{"type":"number","minimum":0,"maximum":1},"g":{"type":"number","minimum":0,"maximum":1},"b":{"type":"number","minimum":0,"maximum":1}}},"HexColor":{"type":"string","pattern":"^#[0-9a-fA-F]{3,8}$"},"ThemeConfiguration":{"type":"object","required":["name"],"properties":{"id":{"type":"string","description":"Auto-generated if omitted."},"name":{"type":"string"},"scale":{"type":"object","description":"Map of stop names to lightness values (0–100). When omitted the preset stops are used unchanged.\n","additionalProperties":{"type":"number","minimum":0,"maximum":100}},"paletteBackground":{"$ref":"#/components/schemas/HexColor"},"textColorsTheme":{"type":"object","required":["lightColor","darkColor"],"properties":{"lightColor":{"$ref":"#/components/schemas/HexColor"},"darkColor":{"$ref":"#/components/schemas/HexColor"}}},"visionSimulationMode":{"$ref":"#/components/schemas/VisionSimulationMode"},"type":{"type":"string","enum":["default theme","custom theme"]}}},"VisionSimulationMode":{"type":"string","enum":["NONE","PROTANOMALY","PROTANOPIA","DEUTERANOMALY","DEUTERANOPIA","TRITANOMALY","TRITANOPIA","ACHROMATOMALY","ACHROMATOPSIA"]},"ColorSpace":{"type":"string","enum":["LCH","OKLCH","LAB","OKLAB","HSL","HSLUV","HSV","CMYK","RGB","HEX","P3"]},"AlgorithmVersion":{"type":"string","enum":["v1","v2","v3"]},"ErrorResponse":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}}}},"paths":{"/list-my-published-palettes":{"get":{"operationId":"listMyPublishedPalettes","summary":"List the authenticated user's palettes","description":"Returns a paginated list of palettes belonging to the authenticated user (both shared and private).\n","tags":["Community"],"parameters":[{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}},{"name":"search","in":"query","schema":{"type":"string"},"description":"Case-insensitive substring search on palette name."}],"responses":{"200":{"description":"Array of the user's published palettes","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MyPublishedPalette"}}}}},"401":{"description":"Missing or invalid authorization token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```
## Publish a new palette
> Create and persist a new palette in the database. Set \`is\_shared: true\` to make it immediately visible in the community gallery.
```json
{"openapi":"3.1.0","info":{"title":"UI Color Palette API","version":"1.0.0"},"tags":[{"name":"Community","description":"Publish, share, and discover palettes in the community gallery.\n"}],"servers":[{"url":"https://api-uicp.yelbolt.workers.dev/v1","description":"Production"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Supabase access token obtained from the `/authenticate` SSE flow. Pass it as `Authorization: Bearer `.\n"}},"schemas":{"PublishPaletteBody":{"type":"object","required":["name","preset","shift","colors","themes","color_space","algorithm_version"],"properties":{"name":{"type":"string","minLength":1},"description":{"type":"string"},"preset":{"$ref":"#/components/schemas/PresetConfiguration"},"shift":{"$ref":"#/components/schemas/ShiftConfiguration"},"are_source_colors_locked":{"type":"boolean","default":false},"colors":{"type":"array","items":{"$ref":"#/components/schemas/ColorConfiguration"},"minItems":1},"themes":{"type":"array","items":{"$ref":"#/components/schemas/ThemeConfiguration"},"minItems":1},"color_space":{"$ref":"#/components/schemas/ColorSpace"},"algorithm_version":{"$ref":"#/components/schemas/AlgorithmVersion"},"is_shared":{"type":"boolean","default":false}}},"PresetConfiguration":{"type":"object","required":["id","name","stops","min","max","easing"],"properties":{"id":{"type":"string","description":"Unique identifier for the preset. Auto-generated if omitted on creation."},"name":{"type":"string"},"stops":{"type":"array","items":{"type":"integer","minimum":0}},"min":{"type":"number","minimum":0,"maximum":100},"max":{"type":"number","minimum":0,"maximum":100},"easing":{"$ref":"#/components/schemas/EasingFunction"}}},"EasingFunction":{"type":"string","enum":["NONE","LINEAR","EASEIN_SINE","EASEOUT_SINE","EASEINOUT_SINE","EASEIN_QUAD","EASEOUT_QUAD","EASEINOUT_QUAD","EASEIN_CUBIC","EASEOUT_CUBIC","EASEINOUT_CUBIC"]},"ShiftConfiguration":{"type":"object","required":["chroma","hue"],"properties":{"chroma":{"type":"number"},"hue":{"type":"number"}}},"ColorConfiguration":{"type":"object","required":["name","rgb","hue","chroma","alpha"],"properties":{"id":{"type":"string","description":"Auto-generated if omitted."},"name":{"type":"string"},"rgb":{"$ref":"#/components/schemas/RgbChannel"},"hue":{"type":"object","required":["shift","isLocked"],"properties":{"shift":{"type":"number"},"isLocked":{"type":"boolean"}}},"chroma":{"type":"object","required":["shift","isLocked"],"properties":{"shift":{"type":"number"},"isLocked":{"type":"boolean"}}},"alpha":{"type":"object","required":["isEnabled","backgroundColor"],"properties":{"isEnabled":{"type":"boolean"},"backgroundColor":{"$ref":"#/components/schemas/HexColor"}}}}},"RgbChannel":{"type":"object","required":["r","g","b"],"properties":{"r":{"type":"number","minimum":0,"maximum":1},"g":{"type":"number","minimum":0,"maximum":1},"b":{"type":"number","minimum":0,"maximum":1}}},"HexColor":{"type":"string","pattern":"^#[0-9a-fA-F]{3,8}$"},"ThemeConfiguration":{"type":"object","required":["name"],"properties":{"id":{"type":"string","description":"Auto-generated if omitted."},"name":{"type":"string"},"scale":{"type":"object","description":"Map of stop names to lightness values (0–100). When omitted the preset stops are used unchanged.\n","additionalProperties":{"type":"number","minimum":0,"maximum":100}},"paletteBackground":{"$ref":"#/components/schemas/HexColor"},"textColorsTheme":{"type":"object","required":["lightColor","darkColor"],"properties":{"lightColor":{"$ref":"#/components/schemas/HexColor"},"darkColor":{"$ref":"#/components/schemas/HexColor"}}},"visionSimulationMode":{"$ref":"#/components/schemas/VisionSimulationMode"},"type":{"type":"string","enum":["default theme","custom theme"]}}},"VisionSimulationMode":{"type":"string","enum":["NONE","PROTANOMALY","PROTANOPIA","DEUTERANOMALY","DEUTERANOPIA","TRITANOMALY","TRITANOPIA","ACHROMATOMALY","ACHROMATOPSIA"]},"ColorSpace":{"type":"string","enum":["LCH","OKLCH","LAB","OKLAB","HSL","HSLUV","HSV","CMYK","RGB","HEX","P3"]},"AlgorithmVersion":{"type":"string","enum":["v1","v2","v3"]},"MyPublishedPalette":{"allOf":[{"$ref":"#/components/schemas/PublishedPalette"},{"type":"object","properties":{"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"published_at":{"type":"string","format":"date-time"}}}]},"PublishedPalette":{"type":"object","properties":{"palette_id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string","nullable":true},"preset":{"$ref":"#/components/schemas/PresetConfiguration"},"shift":{"$ref":"#/components/schemas/ShiftConfiguration"},"are_source_colors_locked":{"type":"boolean"},"colors":{"type":"array","items":{"$ref":"#/components/schemas/ColorConfiguration"}},"themes":{"type":"array","items":{"$ref":"#/components/schemas/ThemeConfiguration"}},"color_space":{"$ref":"#/components/schemas/ColorSpace"},"algorithm_version":{"$ref":"#/components/schemas/AlgorithmVersion"},"creator_full_name":{"type":"string","nullable":true},"creator_avatar_url":{"type":"string","nullable":true},"is_shared":{"type":"boolean"},"star_count":{"type":"integer"}}},"ErrorResponse":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}}}},"paths":{"/publish-palette":{"post":{"operationId":"publishPalette","summary":"Publish a new palette","description":"Create and persist a new palette in the database. Set `is_shared: true` to make it immediately visible in the community gallery.\n","tags":["Community"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishPaletteBody"}}}},"responses":{"201":{"description":"Palette created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MyPublishedPalette"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid authorization token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```
## Get a specific shared palette
> Retrieve a single publicly shared palette by its ID. Returns \`404\` if the palette does not exist or is not shared.
```json
{"openapi":"3.1.0","info":{"title":"UI Color Palette API","version":"1.0.0"},"tags":[{"name":"Community","description":"Publish, share, and discover palettes in the community gallery.\n"}],"servers":[{"url":"https://api-uicp.yelbolt.workers.dev/v1","description":"Production"}],"paths":{"/get-published-palette/{paletteId}":{"get":{"operationId":"getPublishedPalette","summary":"Get a specific shared palette","description":"Retrieve a single publicly shared palette by its ID. Returns `404` if the palette does not exist or is not shared.\n","tags":["Community"],"parameters":[{"name":"paletteId","in":"path","required":true,"schema":{"type":"string"},"description":"The unique palette identifier."}],"responses":{"200":{"description":"The requested palette","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishedPalette"}}}},"404":{"description":"Palette not found or not shared","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"schemas":{"PublishedPalette":{"type":"object","properties":{"palette_id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string","nullable":true},"preset":{"$ref":"#/components/schemas/PresetConfiguration"},"shift":{"$ref":"#/components/schemas/ShiftConfiguration"},"are_source_colors_locked":{"type":"boolean"},"colors":{"type":"array","items":{"$ref":"#/components/schemas/ColorConfiguration"}},"themes":{"type":"array","items":{"$ref":"#/components/schemas/ThemeConfiguration"}},"color_space":{"$ref":"#/components/schemas/ColorSpace"},"algorithm_version":{"$ref":"#/components/schemas/AlgorithmVersion"},"creator_full_name":{"type":"string","nullable":true},"creator_avatar_url":{"type":"string","nullable":true},"is_shared":{"type":"boolean"},"star_count":{"type":"integer"}}},"PresetConfiguration":{"type":"object","required":["id","name","stops","min","max","easing"],"properties":{"id":{"type":"string","description":"Unique identifier for the preset. Auto-generated if omitted on creation."},"name":{"type":"string"},"stops":{"type":"array","items":{"type":"integer","minimum":0}},"min":{"type":"number","minimum":0,"maximum":100},"max":{"type":"number","minimum":0,"maximum":100},"easing":{"$ref":"#/components/schemas/EasingFunction"}}},"EasingFunction":{"type":"string","enum":["NONE","LINEAR","EASEIN_SINE","EASEOUT_SINE","EASEINOUT_SINE","EASEIN_QUAD","EASEOUT_QUAD","EASEINOUT_QUAD","EASEIN_CUBIC","EASEOUT_CUBIC","EASEINOUT_CUBIC"]},"ShiftConfiguration":{"type":"object","required":["chroma","hue"],"properties":{"chroma":{"type":"number"},"hue":{"type":"number"}}},"ColorConfiguration":{"type":"object","required":["name","rgb","hue","chroma","alpha"],"properties":{"id":{"type":"string","description":"Auto-generated if omitted."},"name":{"type":"string"},"rgb":{"$ref":"#/components/schemas/RgbChannel"},"hue":{"type":"object","required":["shift","isLocked"],"properties":{"shift":{"type":"number"},"isLocked":{"type":"boolean"}}},"chroma":{"type":"object","required":["shift","isLocked"],"properties":{"shift":{"type":"number"},"isLocked":{"type":"boolean"}}},"alpha":{"type":"object","required":["isEnabled","backgroundColor"],"properties":{"isEnabled":{"type":"boolean"},"backgroundColor":{"$ref":"#/components/schemas/HexColor"}}}}},"RgbChannel":{"type":"object","required":["r","g","b"],"properties":{"r":{"type":"number","minimum":0,"maximum":1},"g":{"type":"number","minimum":0,"maximum":1},"b":{"type":"number","minimum":0,"maximum":1}}},"HexColor":{"type":"string","pattern":"^#[0-9a-fA-F]{3,8}$"},"ThemeConfiguration":{"type":"object","required":["name"],"properties":{"id":{"type":"string","description":"Auto-generated if omitted."},"name":{"type":"string"},"scale":{"type":"object","description":"Map of stop names to lightness values (0–100). When omitted the preset stops are used unchanged.\n","additionalProperties":{"type":"number","minimum":0,"maximum":100}},"paletteBackground":{"$ref":"#/components/schemas/HexColor"},"textColorsTheme":{"type":"object","required":["lightColor","darkColor"],"properties":{"lightColor":{"$ref":"#/components/schemas/HexColor"},"darkColor":{"$ref":"#/components/schemas/HexColor"}}},"visionSimulationMode":{"$ref":"#/components/schemas/VisionSimulationMode"},"type":{"type":"string","enum":["default theme","custom theme"]}}},"VisionSimulationMode":{"type":"string","enum":["NONE","PROTANOMALY","PROTANOPIA","DEUTERANOMALY","DEUTERANOPIA","TRITANOMALY","TRITANOPIA","ACHROMATOMALY","ACHROMATOPSIA"]},"ColorSpace":{"type":"string","enum":["LCH","OKLCH","LAB","OKLAB","HSL","HSLUV","HSV","CMYK","RGB","HEX","P3"]},"AlgorithmVersion":{"type":"string","enum":["v1","v2","v3"]},"ErrorResponse":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}}}}}
```
## Make a palette publicly visible
> Set \`is\_shared\` to \`true\` on one of the authenticated user's palettes, making it appear in the community gallery.
```json
{"openapi":"3.1.0","info":{"title":"UI Color Palette API","version":"1.0.0"},"tags":[{"name":"Community","description":"Publish, share, and discover palettes in the community gallery.\n"}],"servers":[{"url":"https://api-uicp.yelbolt.workers.dev/v1","description":"Production"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Supabase access token obtained from the `/authenticate` SSE flow. Pass it as `Authorization: Bearer `.\n"}},"schemas":{"MyPublishedPalette":{"allOf":[{"$ref":"#/components/schemas/PublishedPalette"},{"type":"object","properties":{"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"published_at":{"type":"string","format":"date-time"}}}]},"PublishedPalette":{"type":"object","properties":{"palette_id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string","nullable":true},"preset":{"$ref":"#/components/schemas/PresetConfiguration"},"shift":{"$ref":"#/components/schemas/ShiftConfiguration"},"are_source_colors_locked":{"type":"boolean"},"colors":{"type":"array","items":{"$ref":"#/components/schemas/ColorConfiguration"}},"themes":{"type":"array","items":{"$ref":"#/components/schemas/ThemeConfiguration"}},"color_space":{"$ref":"#/components/schemas/ColorSpace"},"algorithm_version":{"$ref":"#/components/schemas/AlgorithmVersion"},"creator_full_name":{"type":"string","nullable":true},"creator_avatar_url":{"type":"string","nullable":true},"is_shared":{"type":"boolean"},"star_count":{"type":"integer"}}},"PresetConfiguration":{"type":"object","required":["id","name","stops","min","max","easing"],"properties":{"id":{"type":"string","description":"Unique identifier for the preset. Auto-generated if omitted on creation."},"name":{"type":"string"},"stops":{"type":"array","items":{"type":"integer","minimum":0}},"min":{"type":"number","minimum":0,"maximum":100},"max":{"type":"number","minimum":0,"maximum":100},"easing":{"$ref":"#/components/schemas/EasingFunction"}}},"EasingFunction":{"type":"string","enum":["NONE","LINEAR","EASEIN_SINE","EASEOUT_SINE","EASEINOUT_SINE","EASEIN_QUAD","EASEOUT_QUAD","EASEINOUT_QUAD","EASEIN_CUBIC","EASEOUT_CUBIC","EASEINOUT_CUBIC"]},"ShiftConfiguration":{"type":"object","required":["chroma","hue"],"properties":{"chroma":{"type":"number"},"hue":{"type":"number"}}},"ColorConfiguration":{"type":"object","required":["name","rgb","hue","chroma","alpha"],"properties":{"id":{"type":"string","description":"Auto-generated if omitted."},"name":{"type":"string"},"rgb":{"$ref":"#/components/schemas/RgbChannel"},"hue":{"type":"object","required":["shift","isLocked"],"properties":{"shift":{"type":"number"},"isLocked":{"type":"boolean"}}},"chroma":{"type":"object","required":["shift","isLocked"],"properties":{"shift":{"type":"number"},"isLocked":{"type":"boolean"}}},"alpha":{"type":"object","required":["isEnabled","backgroundColor"],"properties":{"isEnabled":{"type":"boolean"},"backgroundColor":{"$ref":"#/components/schemas/HexColor"}}}}},"RgbChannel":{"type":"object","required":["r","g","b"],"properties":{"r":{"type":"number","minimum":0,"maximum":1},"g":{"type":"number","minimum":0,"maximum":1},"b":{"type":"number","minimum":0,"maximum":1}}},"HexColor":{"type":"string","pattern":"^#[0-9a-fA-F]{3,8}$"},"ThemeConfiguration":{"type":"object","required":["name"],"properties":{"id":{"type":"string","description":"Auto-generated if omitted."},"name":{"type":"string"},"scale":{"type":"object","description":"Map of stop names to lightness values (0–100). When omitted the preset stops are used unchanged.\n","additionalProperties":{"type":"number","minimum":0,"maximum":100}},"paletteBackground":{"$ref":"#/components/schemas/HexColor"},"textColorsTheme":{"type":"object","required":["lightColor","darkColor"],"properties":{"lightColor":{"$ref":"#/components/schemas/HexColor"},"darkColor":{"$ref":"#/components/schemas/HexColor"}}},"visionSimulationMode":{"$ref":"#/components/schemas/VisionSimulationMode"},"type":{"type":"string","enum":["default theme","custom theme"]}}},"VisionSimulationMode":{"type":"string","enum":["NONE","PROTANOMALY","PROTANOPIA","DEUTERANOMALY","DEUTERANOPIA","TRITANOMALY","TRITANOPIA","ACHROMATOMALY","ACHROMATOPSIA"]},"ColorSpace":{"type":"string","enum":["LCH","OKLCH","LAB","OKLAB","HSL","HSLUV","HSV","CMYK","RGB","HEX","P3"]},"AlgorithmVersion":{"type":"string","enum":["v1","v2","v3"]},"ErrorResponse":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}}}},"paths":{"/share-published-palette/{paletteId}":{"post":{"operationId":"sharePublishedPalette","summary":"Make a palette publicly visible","description":"Set `is_shared` to `true` on one of the authenticated user's palettes, making it appear in the community gallery.\n","tags":["Community"],"parameters":[{"name":"paletteId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Updated palette record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MyPublishedPalette"}}}},"401":{"description":"Missing or invalid authorization token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Palette not found or not owned by the authenticated user","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```
## Make a palette private
> Set \`is\_shared\` to \`false\` on one of the authenticated user's palettes, hiding it from the community gallery.
```json
{"openapi":"3.1.0","info":{"title":"UI Color Palette API","version":"1.0.0"},"tags":[{"name":"Community","description":"Publish, share, and discover palettes in the community gallery.\n"}],"servers":[{"url":"https://api-uicp.yelbolt.workers.dev/v1","description":"Production"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Supabase access token obtained from the `/authenticate` SSE flow. Pass it as `Authorization: Bearer `.\n"}},"schemas":{"MyPublishedPalette":{"allOf":[{"$ref":"#/components/schemas/PublishedPalette"},{"type":"object","properties":{"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"published_at":{"type":"string","format":"date-time"}}}]},"PublishedPalette":{"type":"object","properties":{"palette_id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string","nullable":true},"preset":{"$ref":"#/components/schemas/PresetConfiguration"},"shift":{"$ref":"#/components/schemas/ShiftConfiguration"},"are_source_colors_locked":{"type":"boolean"},"colors":{"type":"array","items":{"$ref":"#/components/schemas/ColorConfiguration"}},"themes":{"type":"array","items":{"$ref":"#/components/schemas/ThemeConfiguration"}},"color_space":{"$ref":"#/components/schemas/ColorSpace"},"algorithm_version":{"$ref":"#/components/schemas/AlgorithmVersion"},"creator_full_name":{"type":"string","nullable":true},"creator_avatar_url":{"type":"string","nullable":true},"is_shared":{"type":"boolean"},"star_count":{"type":"integer"}}},"PresetConfiguration":{"type":"object","required":["id","name","stops","min","max","easing"],"properties":{"id":{"type":"string","description":"Unique identifier for the preset. Auto-generated if omitted on creation."},"name":{"type":"string"},"stops":{"type":"array","items":{"type":"integer","minimum":0}},"min":{"type":"number","minimum":0,"maximum":100},"max":{"type":"number","minimum":0,"maximum":100},"easing":{"$ref":"#/components/schemas/EasingFunction"}}},"EasingFunction":{"type":"string","enum":["NONE","LINEAR","EASEIN_SINE","EASEOUT_SINE","EASEINOUT_SINE","EASEIN_QUAD","EASEOUT_QUAD","EASEINOUT_QUAD","EASEIN_CUBIC","EASEOUT_CUBIC","EASEINOUT_CUBIC"]},"ShiftConfiguration":{"type":"object","required":["chroma","hue"],"properties":{"chroma":{"type":"number"},"hue":{"type":"number"}}},"ColorConfiguration":{"type":"object","required":["name","rgb","hue","chroma","alpha"],"properties":{"id":{"type":"string","description":"Auto-generated if omitted."},"name":{"type":"string"},"rgb":{"$ref":"#/components/schemas/RgbChannel"},"hue":{"type":"object","required":["shift","isLocked"],"properties":{"shift":{"type":"number"},"isLocked":{"type":"boolean"}}},"chroma":{"type":"object","required":["shift","isLocked"],"properties":{"shift":{"type":"number"},"isLocked":{"type":"boolean"}}},"alpha":{"type":"object","required":["isEnabled","backgroundColor"],"properties":{"isEnabled":{"type":"boolean"},"backgroundColor":{"$ref":"#/components/schemas/HexColor"}}}}},"RgbChannel":{"type":"object","required":["r","g","b"],"properties":{"r":{"type":"number","minimum":0,"maximum":1},"g":{"type":"number","minimum":0,"maximum":1},"b":{"type":"number","minimum":0,"maximum":1}}},"HexColor":{"type":"string","pattern":"^#[0-9a-fA-F]{3,8}$"},"ThemeConfiguration":{"type":"object","required":["name"],"properties":{"id":{"type":"string","description":"Auto-generated if omitted."},"name":{"type":"string"},"scale":{"type":"object","description":"Map of stop names to lightness values (0–100). When omitted the preset stops are used unchanged.\n","additionalProperties":{"type":"number","minimum":0,"maximum":100}},"paletteBackground":{"$ref":"#/components/schemas/HexColor"},"textColorsTheme":{"type":"object","required":["lightColor","darkColor"],"properties":{"lightColor":{"$ref":"#/components/schemas/HexColor"},"darkColor":{"$ref":"#/components/schemas/HexColor"}}},"visionSimulationMode":{"$ref":"#/components/schemas/VisionSimulationMode"},"type":{"type":"string","enum":["default theme","custom theme"]}}},"VisionSimulationMode":{"type":"string","enum":["NONE","PROTANOMALY","PROTANOPIA","DEUTERANOMALY","DEUTERANOPIA","TRITANOMALY","TRITANOPIA","ACHROMATOMALY","ACHROMATOPSIA"]},"ColorSpace":{"type":"string","enum":["LCH","OKLCH","LAB","OKLAB","HSL","HSLUV","HSV","CMYK","RGB","HEX","P3"]},"AlgorithmVersion":{"type":"string","enum":["v1","v2","v3"]},"ErrorResponse":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}}}},"paths":{"/unshare-published-palette/{paletteId}":{"post":{"operationId":"unsharePublishedPalette","summary":"Make a palette private","description":"Set `is_shared` to `false` on one of the authenticated user's palettes, hiding it from the community gallery.\n","tags":["Community"],"parameters":[{"name":"paletteId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Updated palette record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MyPublishedPalette"}}}},"401":{"description":"Missing or invalid authorization token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Palette not found or not owned by the authenticated user","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```
## Update an existing palette
> Partially update an existing palette. Only the fields present in the request body are updated; all others remain unchanged.
```json
{"openapi":"3.1.0","info":{"title":"UI Color Palette API","version":"1.0.0"},"tags":[{"name":"Community","description":"Publish, share, and discover palettes in the community gallery.\n"}],"servers":[{"url":"https://api-uicp.yelbolt.workers.dev/v1","description":"Production"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Supabase access token obtained from the `/authenticate` SSE flow. Pass it as `Authorization: Bearer `.\n"}},"schemas":{"UpdatePaletteBody":{"type":"object","description":"All fields are optional; only the supplied ones are updated.","properties":{"name":{"type":"string","minLength":1},"description":{"type":"string"},"preset":{"$ref":"#/components/schemas/PresetConfiguration"},"shift":{"$ref":"#/components/schemas/ShiftConfiguration"},"are_source_colors_locked":{"type":"boolean"},"colors":{"type":"array","items":{"$ref":"#/components/schemas/ColorConfiguration"},"minItems":1},"themes":{"type":"array","items":{"$ref":"#/components/schemas/ThemeConfiguration"},"minItems":1},"color_space":{"$ref":"#/components/schemas/ColorSpace"},"algorithm_version":{"$ref":"#/components/schemas/AlgorithmVersion"},"is_shared":{"type":"boolean"}}},"PresetConfiguration":{"type":"object","required":["id","name","stops","min","max","easing"],"properties":{"id":{"type":"string","description":"Unique identifier for the preset. Auto-generated if omitted on creation."},"name":{"type":"string"},"stops":{"type":"array","items":{"type":"integer","minimum":0}},"min":{"type":"number","minimum":0,"maximum":100},"max":{"type":"number","minimum":0,"maximum":100},"easing":{"$ref":"#/components/schemas/EasingFunction"}}},"EasingFunction":{"type":"string","enum":["NONE","LINEAR","EASEIN_SINE","EASEOUT_SINE","EASEINOUT_SINE","EASEIN_QUAD","EASEOUT_QUAD","EASEINOUT_QUAD","EASEIN_CUBIC","EASEOUT_CUBIC","EASEINOUT_CUBIC"]},"ShiftConfiguration":{"type":"object","required":["chroma","hue"],"properties":{"chroma":{"type":"number"},"hue":{"type":"number"}}},"ColorConfiguration":{"type":"object","required":["name","rgb","hue","chroma","alpha"],"properties":{"id":{"type":"string","description":"Auto-generated if omitted."},"name":{"type":"string"},"rgb":{"$ref":"#/components/schemas/RgbChannel"},"hue":{"type":"object","required":["shift","isLocked"],"properties":{"shift":{"type":"number"},"isLocked":{"type":"boolean"}}},"chroma":{"type":"object","required":["shift","isLocked"],"properties":{"shift":{"type":"number"},"isLocked":{"type":"boolean"}}},"alpha":{"type":"object","required":["isEnabled","backgroundColor"],"properties":{"isEnabled":{"type":"boolean"},"backgroundColor":{"$ref":"#/components/schemas/HexColor"}}}}},"RgbChannel":{"type":"object","required":["r","g","b"],"properties":{"r":{"type":"number","minimum":0,"maximum":1},"g":{"type":"number","minimum":0,"maximum":1},"b":{"type":"number","minimum":0,"maximum":1}}},"HexColor":{"type":"string","pattern":"^#[0-9a-fA-F]{3,8}$"},"ThemeConfiguration":{"type":"object","required":["name"],"properties":{"id":{"type":"string","description":"Auto-generated if omitted."},"name":{"type":"string"},"scale":{"type":"object","description":"Map of stop names to lightness values (0–100). When omitted the preset stops are used unchanged.\n","additionalProperties":{"type":"number","minimum":0,"maximum":100}},"paletteBackground":{"$ref":"#/components/schemas/HexColor"},"textColorsTheme":{"type":"object","required":["lightColor","darkColor"],"properties":{"lightColor":{"$ref":"#/components/schemas/HexColor"},"darkColor":{"$ref":"#/components/schemas/HexColor"}}},"visionSimulationMode":{"$ref":"#/components/schemas/VisionSimulationMode"},"type":{"type":"string","enum":["default theme","custom theme"]}}},"VisionSimulationMode":{"type":"string","enum":["NONE","PROTANOMALY","PROTANOPIA","DEUTERANOMALY","DEUTERANOPIA","TRITANOMALY","TRITANOPIA","ACHROMATOMALY","ACHROMATOPSIA"]},"ColorSpace":{"type":"string","enum":["LCH","OKLCH","LAB","OKLAB","HSL","HSLUV","HSV","CMYK","RGB","HEX","P3"]},"AlgorithmVersion":{"type":"string","enum":["v1","v2","v3"]},"MyPublishedPalette":{"allOf":[{"$ref":"#/components/schemas/PublishedPalette"},{"type":"object","properties":{"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"published_at":{"type":"string","format":"date-time"}}}]},"PublishedPalette":{"type":"object","properties":{"palette_id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string","nullable":true},"preset":{"$ref":"#/components/schemas/PresetConfiguration"},"shift":{"$ref":"#/components/schemas/ShiftConfiguration"},"are_source_colors_locked":{"type":"boolean"},"colors":{"type":"array","items":{"$ref":"#/components/schemas/ColorConfiguration"}},"themes":{"type":"array","items":{"$ref":"#/components/schemas/ThemeConfiguration"}},"color_space":{"$ref":"#/components/schemas/ColorSpace"},"algorithm_version":{"$ref":"#/components/schemas/AlgorithmVersion"},"creator_full_name":{"type":"string","nullable":true},"creator_avatar_url":{"type":"string","nullable":true},"is_shared":{"type":"boolean"},"star_count":{"type":"integer"}}},"ErrorResponse":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}}}},"paths":{"/update-published-palette/{paletteId}":{"post":{"operationId":"updatePublishedPalette","summary":"Update an existing palette","description":"Partially update an existing palette. Only the fields present in the request body are updated; all others remain unchanged.\n","tags":["Community"],"parameters":[{"name":"paletteId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePaletteBody"}}}},"responses":{"200":{"description":"Updated palette record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MyPublishedPalette"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid authorization token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Palette not found or not owned by the authenticated user","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```
## Permanently delete a palette
> Permanently remove a palette from the database. This action is \*\*irreversible\*\*. Only the palette's creator can delete it.
```json
{"openapi":"3.1.0","info":{"title":"UI Color Palette API","version":"1.0.0"},"tags":[{"name":"Community","description":"Publish, share, and discover palettes in the community gallery.\n"}],"servers":[{"url":"https://api-uicp.yelbolt.workers.dev/v1","description":"Production"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Supabase access token obtained from the `/authenticate` SSE flow. Pass it as `Authorization: Bearer `.\n"}},"schemas":{"MyPublishedPalette":{"allOf":[{"$ref":"#/components/schemas/PublishedPalette"},{"type":"object","properties":{"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"published_at":{"type":"string","format":"date-time"}}}]},"PublishedPalette":{"type":"object","properties":{"palette_id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string","nullable":true},"preset":{"$ref":"#/components/schemas/PresetConfiguration"},"shift":{"$ref":"#/components/schemas/ShiftConfiguration"},"are_source_colors_locked":{"type":"boolean"},"colors":{"type":"array","items":{"$ref":"#/components/schemas/ColorConfiguration"}},"themes":{"type":"array","items":{"$ref":"#/components/schemas/ThemeConfiguration"}},"color_space":{"$ref":"#/components/schemas/ColorSpace"},"algorithm_version":{"$ref":"#/components/schemas/AlgorithmVersion"},"creator_full_name":{"type":"string","nullable":true},"creator_avatar_url":{"type":"string","nullable":true},"is_shared":{"type":"boolean"},"star_count":{"type":"integer"}}},"PresetConfiguration":{"type":"object","required":["id","name","stops","min","max","easing"],"properties":{"id":{"type":"string","description":"Unique identifier for the preset. Auto-generated if omitted on creation."},"name":{"type":"string"},"stops":{"type":"array","items":{"type":"integer","minimum":0}},"min":{"type":"number","minimum":0,"maximum":100},"max":{"type":"number","minimum":0,"maximum":100},"easing":{"$ref":"#/components/schemas/EasingFunction"}}},"EasingFunction":{"type":"string","enum":["NONE","LINEAR","EASEIN_SINE","EASEOUT_SINE","EASEINOUT_SINE","EASEIN_QUAD","EASEOUT_QUAD","EASEINOUT_QUAD","EASEIN_CUBIC","EASEOUT_CUBIC","EASEINOUT_CUBIC"]},"ShiftConfiguration":{"type":"object","required":["chroma","hue"],"properties":{"chroma":{"type":"number"},"hue":{"type":"number"}}},"ColorConfiguration":{"type":"object","required":["name","rgb","hue","chroma","alpha"],"properties":{"id":{"type":"string","description":"Auto-generated if omitted."},"name":{"type":"string"},"rgb":{"$ref":"#/components/schemas/RgbChannel"},"hue":{"type":"object","required":["shift","isLocked"],"properties":{"shift":{"type":"number"},"isLocked":{"type":"boolean"}}},"chroma":{"type":"object","required":["shift","isLocked"],"properties":{"shift":{"type":"number"},"isLocked":{"type":"boolean"}}},"alpha":{"type":"object","required":["isEnabled","backgroundColor"],"properties":{"isEnabled":{"type":"boolean"},"backgroundColor":{"$ref":"#/components/schemas/HexColor"}}}}},"RgbChannel":{"type":"object","required":["r","g","b"],"properties":{"r":{"type":"number","minimum":0,"maximum":1},"g":{"type":"number","minimum":0,"maximum":1},"b":{"type":"number","minimum":0,"maximum":1}}},"HexColor":{"type":"string","pattern":"^#[0-9a-fA-F]{3,8}$"},"ThemeConfiguration":{"type":"object","required":["name"],"properties":{"id":{"type":"string","description":"Auto-generated if omitted."},"name":{"type":"string"},"scale":{"type":"object","description":"Map of stop names to lightness values (0–100). When omitted the preset stops are used unchanged.\n","additionalProperties":{"type":"number","minimum":0,"maximum":100}},"paletteBackground":{"$ref":"#/components/schemas/HexColor"},"textColorsTheme":{"type":"object","required":["lightColor","darkColor"],"properties":{"lightColor":{"$ref":"#/components/schemas/HexColor"},"darkColor":{"$ref":"#/components/schemas/HexColor"}}},"visionSimulationMode":{"$ref":"#/components/schemas/VisionSimulationMode"},"type":{"type":"string","enum":["default theme","custom theme"]}}},"VisionSimulationMode":{"type":"string","enum":["NONE","PROTANOMALY","PROTANOPIA","DEUTERANOMALY","DEUTERANOPIA","TRITANOMALY","TRITANOPIA","ACHROMATOMALY","ACHROMATOPSIA"]},"ColorSpace":{"type":"string","enum":["LCH","OKLCH","LAB","OKLAB","HSL","HSLUV","HSV","CMYK","RGB","HEX","P3"]},"AlgorithmVersion":{"type":"string","enum":["v1","v2","v3"]},"ErrorResponse":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}}}},"paths":{"/unpublish-palette/{paletteId}":{"delete":{"operationId":"unpublishPalette","summary":"Permanently delete a palette","description":"Permanently remove a palette from the database. This action is **irreversible**. Only the palette's creator can delete it.\n","tags":["Community"],"parameters":[{"name":"paletteId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The deleted palette record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MyPublishedPalette"}}}},"401":{"description":"Missing or invalid authorization token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.ui-color-palette.com/api-reference/community.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.