---
title: "Check for schedule conflicts before creating/updating an item. Always returns 200 with conflict details in the response body."
method: POST
path: "/ScheduleItems/check-conflicts"
tags: ["ScheduleItems"]
---

# Check for schedule conflicts before creating/updating an item. Always returns 200 with conflict details in the response body.

`POST /ScheduleItems/check-conflicts`

## Request

- Base URL: `https://api.clinicos.vet/backend/business`
- URL: `https://api.clinicos.vet/backend/business/ScheduleItems/check-conflicts`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/docs/ScheduleItems/check-conflicts/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- CheckScheduleConflictsRequest: Request to check for schedule conflicts before creating/updating
  - `locationId` string, required
  - `startTime` string, date-time, required
  - `endTime` string, date-time, required
  - `isRecurring` boolean
  - `recurrencePattern` RecurrencePatternDto: Pattern for recurring schedule items
    - `frequency` string, required: DAILY, WEEKLY, or MONTHLY
    - `interval` union: Interval between occurrences (e.g., 2 = every 2 weeks)
      - integer
      - string, int32
    - `daysOfWeek` string[], nullable: Days of week for weekly recurrence (MO, TU, WE, TH, FR, SA, SU)
    - `dayOfMonth` union: Day of month for monthly recurrence (1-31)
      - integer
      - string, int32
    - `endType` string, required: End type: never, on_date, or after_count
    - `endDate` string, date-time, nullable: End date when EndType is on_date
    - `endAfterCount` union: Number of occurrences when EndType is after_count
      - integer
      - string, int32
  - `excludeScheduleItemId` string, nullable

## Response `200`

OK

- ScheduleConflictCheckResponse: Response from the conflict check endpoint
  - `hasConflicts` boolean
  - `conflicts` ScheduleConflictDto[]
    - `proposedStart` string, date-time
    - `proposedEnd` string, date-time
    - `conflictingItemId` string, required
    - `conflictingItemTitle` string, required
    - `conflictingItemType` string, required
    - `conflictingStart` string, date-time
    - `conflictingEnd` string, date-time
    - `conflictingIsRecurringInstance` boolean
    - `conflictingParentId` string, nullable
    - `hasAppointment` boolean
  - `totalOccurrencesChecked` union
    - integer
    - string, int32

---

[API](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1.md) - [All operations](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/revisions/099cf36186e0?raw)