True shine API reference

Create True Shine lighting design

true_shine.create_designwrite

Turn a Southeast Texas property address into a saved True Shine design page with an aerial building measurement, preliminary lighting price range, and a generated image when a licensed nearby street photo is available. Returns a shareable page URL and image URL for a follow-up message. This creates a page and may consume one AI image credit; it does not send a message.

Parameters

Field	Type	Required	Description
address	string	required	Full street address, city, state, and ZIP.
roofline	"warm" \| "cool" \| "color" \| "gameday" (or null)	optional	Roofline lighting style, or null for yard lighting only. Default: "warm"
coverage	"front" \| "whole"	optional	Price the front roofline or the whole building perimeter. Default: "front"
layers	array of ("landscape-uplight" \| "path-lights" \| "tree-wrap" \| "christmas" \| "column-accents" \| "patio")	optional	Optional yard and architectural lighting additions. Default: []
note	string	optional	Brief preference for the AI lighting concept. Default: ""

Example

curl -X POST https://app.chirply.io/api/v1/actions/true_shine.create_design \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "example"
  }'

Test with your API key

Over MCP the same operation is the tool true_shine_create_design at https://app.chirply.io/api/mcp, same bearer token, same input.