Create Day
create_dayFull Description
Create a RoadOps day for an exact active team. Requires exact teamId and team admin access. Use date as YYYY-MM-DD with no time or timezone, timezone as an IANA name, and include a valid human-readable location plus top-level latitude/longitude decimal-degree fields whenever the location is known. Before creating, RoadOps checks for an existing non-deleted day with the same team/date and returns that existing day for reuse instead of creating a duplicate.
Parameters (5 required, 5 optional)
datestringISO calendar date in YYYY-MM-DD format, with no time or timezone. The range is inclusive and is matched against RoadOps day dates. Example: 2026-05-31.
dayIdstringRoadOps UUID string.
namestringRoadOps day name, 1-100 characters.
teamIdstringRoadOps UUID string.
timezonestringIANA timezone name used to validate the matching local datetime. Example: America/Chicago.
colorstringOptional 6-digit hex color for the day. Example: #2E6F40.
latitudenumberTop-level RoadOps day latitude as decimal degrees, from -90 to 90. Include with longitude when the location is known from a reliable source. Example: 36.154.
locationstringHuman-readable RoadOps day location, usually City, ST or City, Country. Include this whenever known. Example: Tulsa, OK.
longitudenumberTop-level RoadOps day longitude as decimal degrees, from -180 to 180. Include with latitude when the location is known from a reliable source. Example: -95.9928.
teamNamestringRoadOps team name. Optional display-only hint for ChatGPT confirmation copy. IDs remain authoritative; if provided, RoadOps validates it against the resolved record and rejects mismatches.