Organization API

Create multi-day Service Appointments

Creates one Service Appointment row per local day between startDate and endDate using shared daily schedule, Team Member assignment, primary member, timezone, notes, and confidence semantics. Requires Idempotency-Key and service_appointments:write.

/api/v1/service-appointments/multi-day

Create multi-day Service Appointments. Use an organization API key with service_appointments:write. Check the response envelope and meta.requestId before triggering dependent workflow steps.

Required scopes

service_appointments:writeIdempotency-Key required

Parameters

No path or query parameters.

Request body

objectrequired

Field	Type	Description
workOrderIdrequired	string	Optional unless marked required.
startDaterequired	string	Optional unless marked required.
endDaterequired	string	Optional unless marked required.
dailyStartTimerequired	string	Optional unless marked required.
dailyEndTimerequired	string	Optional unless marked required.
timezonerequired	string	Optional unless marked required.
assignedTeamMemberIds[]required	array<string>	Optional unless marked required.
primaryTeamMemberIdrequired	string	Optional unless marked required.
notes	string \| null	Optional unless marked required.
schedulingConfidence	TENTATIVELY_SCHEDULED \| CONFIDENTLY_SCHEDULED \| CONFIRMED	Optional unless marked required.

createmultidayserviceappointmentsRequest

{
  "workOrderId": "work_order_123",
  "startDate": "2026-08-13",
  "endDate": "2026-08-15",
  "dailyStartTime": "09:00",
  "dailyEndTime": "15:00",
  "timezone": "America/Los_Angeles",
  "assignedTeamMemberIds": [
    "team_member_123"
  ],
  "primaryTeamMemberId": "team_member_123"
}

Responses

201

Multi-day Service Appointment envelope

#/components/schemas/OrgApiResourceEnvelope

401

Missing or invalid organization API key

#/components/schemas/OrgApiError

402

Organization billing access or an endpoint-specific business quota denied the request

#/components/schemas/OrgApiError

403

Missing required scope: service_appointments:write

#/components/schemas/OrgApiError

429

Rate limit exceeded

#/components/schemas/OrgApiError

Errors

401 Missing or invalid organization API key402 Organization billing access or an endpoint-specific business quota denied the request403 Missing required scope: service_appointments:write429 Rate limit exceeded

Static examples

curl -X POST "$SOLAROS_BASE_URL/api/v1/service-appointments/multi-day" \
  -H "Authorization: Bearer $SOLAROS_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $SOLAROS_IDEMPOTENCY_KEY" \
  --data '{"workOrderId":"work_order_123","startDate":"2026-08-13","endDate":"2026-08-15","dailyStartTime":"09:00","dailyEndTime":"15:00","timezone":"America/Los_Angeles","assignedTeamMemberIds":["team_member_123"],"primaryTeamMemberId":"team_member_123"}'