Check Video Call Availability

Check whether a proposed time slot (one-time, daily, or weekly) overlaps with the creator's existing upcoming/ongoing video calls.

maximumOverlap of 0 means no conflicts.
overlapList contains each conflicting pair so the caller can show specifics to the user.
To check while editing an existing call, pass excludeVideocall (single) or groupId (recurring group) to exclude it from the conflict check.

Authorization

bearer

AuthorizationBearer <token>

In: header

Header Parameters

x-whitelabel-host*string

Host name of the dashboard, ex: mydomain.tagmango.com

x-timezone-offset*string

Timezone offset (in number) example-> 330

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

recurringType?string

Recurrence pattern. Defaults to "onetime".

Default"onetime"

Value in"onetime" | "daily" | "weekly"

startDate*string

Start date in YYYY-MM-DD format

endDate?string

End date in YYYY-MM-DD format. Required for daily/weekly recurrence.

fromTime*string

Start time in HH:mm (24-hour) format

timezoneName*string

IANA timezone name, e.g. "Asia/Calcutta", "America/New_York"

duration*number

Duration of each video call in minutes

repeatingDays?array<>

Array of 7 values (0 or 1) representing days Sun–Sat. Required for weekly recurrence. Example: [0,1,1,1,1,1,0] = Mon–Fri.

excludeVideocall?string

ID of an existing video call to exclude from overlap check (use when editing an existing call)

groupId?string

Group ID to exclude from overlap check (use when editing a recurring group)

Response Body

`application/json`

curl -X POST "https://api-prod-new.tagmango.com/api/v1/external/workshops/video-calls/check-availability" \  -H "x-whitelabel-host: string" \  -H "x-timezone-offset: string" \  -H "Content-Type: application/json" \  -d '{    "startDate": "2025-06-01",    "fromTime": "10:00",    "timezoneName": "Asia/Calcutta",    "duration": 60  }'

{
  "maximumOverlap": 1,
  "overlapList": [
    {
      "newCall": {
        "fromTime": "2025-06-01T10:00:00.000Z",
        "toTime": "2025-06-01T11:00:00.000Z"
      },
      "existingCall": {
        "fromTime": "2025-06-01T10:00:00.000Z",
        "toTime": "2025-06-01T11:00:00.000Z",
        "title": "Morning Standup"
      }
    }
  ]
}

{
  "code": 400,
  "type": "Bad request",
  "statusMessage": "BAD_REQUEST",
  "message": "Invalid request",
  "success": false
}

{
  "code": 401,
  "type": "Unauthorized",
  "statusMessage": "UNAUTHORIZED",
  "message": "Invalid token",
  "success": false
}

Check Video Call Availability

Authorization

Header Parameters

Request Body

Response Body

200application/json

400application/json

401application/json

`application/json`

`application/json`

`application/json`