Staff

Manage team members, their services, and schedules.

Required scope: staff:read or staff:write

GET/businesses/{businessId}/staff

List all staff members with their services and schedule.

Response

{
  "data": [
    {
      "id": "staff-uuid",
      "firstName": "Maria",
      "lastName": "Schmidt",
      "title": "Senior Stylist",
      "isActive": true,
      "acceptsBookings": true,
      "color": "#8B5CF6",
      "services": [
        { "id": "svc-uuid", "name": "Herrenhaarschnitt" }
      ],
      "schedules": [
        { "dayOfWeek": 1, "startTime": "09:00", "endTime": "17:00" }
      ]
    }
  ]
}

POST/businesses/{businessId}/staff

Add a new staff member.

Request Body

Name	Type	Required	Description
`firstName`	string	Yes	First name
`lastName`	string	Yes	Last name
`email`	string	No	Email address
`phone`	string	No	Phone number
`title`	string	No	Job title
`color`	string	No	Hex color for calendar display
`isActive`	boolean	No	Default: true
`acceptsBookings`	boolean	No	Default: true

PATCH/businesses/{businessId}/staff/{staffId}

Update a staff member's details.

DELETE/businesses/{businessId}/staff/{staffId}

Remove a staff member (soft delete).

PUT/businesses/{businessId}/staff/{staffId}/schedules

Set the weekly schedule for a staff member.

Request

{
  "schedules": [
    { "dayOfWeek": 1, "startTime": "09:00", "endTime": "17:00" },
    { "dayOfWeek": 2, "startTime": "09:00", "endTime": "17:00" },
    { "dayOfWeek": 3, "startTime": "10:00", "endTime": "18:00" },
    { "dayOfWeek": 4, "startTime": "09:00", "endTime": "17:00" },
    { "dayOfWeek": 5, "startTime": "09:00", "endTime": "15:00" }
  ]
}

PUT/businesses/{businessId}/staff/{staffId}/services

Assign services to a staff member.

Request

{
  "serviceIds": ["svc-uuid-1", "svc-uuid-2", "svc-uuid-3"]
}