Set a host's calendars, hours and buffers

PUT

/v1/workspace/meetings/hosts/{user_id}/schedule

curl --request PUT \
  --url https://api.vocapable.com/v1/workspace/meetings/hosts/example/schedule \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "expected_revision": 1, "calendar_ids": [ "example" ], "write_calendar_id": "example", "timezone": "example", "working_hours": { "additionalProperty": [ [ "example" ] ] }, "buffer_before_minutes": 1, "buffer_after_minutes": 1, "allow_share_booking": true, "share_duration_minutes": 15 }'

Authorizations

• HTTPBearer

Parameters

Path Parameters

user_id

required

User Id

string

Request Body^required

Media typeapplication/json

WorkspaceHostScheduleUpdate

object

expected_revision

Any of:

integer

integer

>= 1

null

null

calendar_ids

Any of:

Array<string>

Array<string>

<= 10 items

null

null

write_calendar_id

Any of:

string

string

<= 500 characters

null

null

timezone

Any of:

string

string

<= 64 characters

null

null

working_hours

Any of:

object

object

key

additional properties

Array<Array<string>>

null

null

buffer_before_minutes

Any of:

integer

integer

<= 120

null

null

buffer_after_minutes

Any of:

integer

integer

<= 120

null

null

allow_share_booking

Any of:

boolean

boolean

null

null

share_duration_minutes

Any of:

integer

integer

Allowed values: 15 30 45 60

null

null

Responses

200

Successful Response

Media typeapplication/json

WorkspaceHostSchedule

object

user_id

required

User Id

string

calendar

required

WorkspaceHostCalendar

What a host’s calendar can do for a booking, stated exactly.

object

state

required

State

string

Allowed values: connected not_connected not_assigned awaiting_review needs_admin_consent reauthorization_required attention_needed paused

provider

required

Any of:

string

string

Allowed values: google_calendar microsoft_calendar calendly

null

null

provider_name

required

Any of:

string

string

null

null

account_label

required

Any of:

string

string

null

null

installation_id

required

Any of:

string

string

null

null

calendars

required

Calendars

Array<object>

WorkspaceCalendarChoice

object

id

required

Id

string

label

required

Label

string

writable

required

Writable

boolean

write_calendar_id

required

Any of:

string

string

null

null

working_hours

required

Working Hours

object

key

additional properties

Array<Array<string>>

buffer_before_minutes

required

Buffer Before Minutes

integer

buffer_after_minutes

required

Buffer After Minutes

integer

timezone

required

Any of:

string

string

null

null

event_types

required

Event Types

Array<object>

WorkspaceEventTypeChoice

object

id

required

Id

string

label

required

Label

string

duration_minutes

required

Any of:

integer

integer

null

null

event_type_booking

required

Any of:

string

string

null

null

admin_consent_url

required

Any of:

string

string

null

null

detail

required

Detail

string

connect_path

required

Connect Path

string

allow_share_booking

required

Allow Share Booking

boolean

share_duration_minutes

required

Share Duration Minutes

integer

revision

required

Any of:

integer

integer

null

null

Example

{
  "calendar": {
    "state": "connected",
    "provider": "google_calendar"
  }
}

422

Validation Error

Media typeapplication/json

HTTPValidationError

object

detail

Detail

Array<object>

ValidationError

object

loc

required

Location

Array

msg

required

Message

string

type

required

Error Type

string

input

Input

ctx

Context

object

Example^generated

{
  "detail": [
    {
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example",
      "input": "example",
      "ctx": {}
    }
  ]
}