Skip to content

Meeting Type routes: update, delete

The Meeting Type Verbs update, delete as api.sb routes, with inputs, result, refusals and an example.

Reference for Meeting Type, one group of Meeting Type routes.

MeetingType.update

Changes the given properties of a Meeting Type. Verb page.

Text
PATCH /{namespace}/meeting-types/{id}

Path: id. Body, as JSON: the other inputs. Emits MeetingType.updated.

Inputs

InputTypeRequiredDescription
idstringrequiredThe id of the Meeting Type.
namestringWhat the booking page calls it, such as Intro call.
durationintegerMinutes each Meeting runs.
mediumstringHow people meet: video, phone or inPerson.
availabilityAvailabilityThe hours it books into.
urlurlThe booking link, served on the Startup’s Domain once published.
questionsstring[]What the booker answers before the time is held.
offerOfferThe Offer a paid booking accepts first, with its deposit and no-show rule.

Returns

OutputTypeRequiredDescription
meetingTypeMeeting TyperequiredThe Meeting Type.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

Terminal
curl -X PATCH https://api.sb/leaseline.app/meeting-types/mtgtype_qw2d5yGLVN \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Problem interview"}'
JSON
{
  "api": "https://api.sb/leaseline.app",
  "meetingType": {
    "$id": "https://api.sb/leaseline.app/meeting-types/mtgtype_qw2d5yGLVN",
    "$type": "MeetingType",
    "name": "Problem interview",
    "duration": 20,
    "medium": "video",
    "availability": "availability_8Zj0a7vvRl"
  },
  "action": {
    "$id": "https://api.sb/leaseline.app/actions/act_br07HsG8MG",
    "operation": "MeetingType.update",
    "status": "done"
  },
  "links": {
    "self": "https://api.sb/leaseline.app/actions/act_br07HsG8MG"
  }
}

MeetingType.delete

Deletes a Meeting Type: a soft delete that keeps its history, undone by Thing.restore. Verb page.

Text
DELETE /{namespace}/meeting-types/{id}

Path: id. Emits MeetingType.deleted.

Inputs

InputTypeRequiredDescription
idstringrequiredThe id of the Meeting Type.

Returns

OutputTypeRequiredDescription
meetingTypeMeeting TyperequiredThe Meeting Type.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

Terminal
curl -X DELETE https://api.sb/leaseline.app/meeting-types/mtgtype_qw2d5yGLVN \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY"
JSON
{
  "api": "https://api.sb/leaseline.app",
  "meetingType": {
    "$id": "https://api.sb/leaseline.app/meeting-types/mtgtype_qw2d5yGLVN",
    "$type": "MeetingType",
    "name": "Problem interview",
    "duration": 20,
    "medium": "video",
    "availability": "availability_8Zj0a7vvRl"
  },
  "action": {
    "$id": "https://api.sb/leaseline.app/actions/act_br07HsG8MG",
    "operation": "MeetingType.delete",
    "status": "done"
  },
  "links": {
    "self": "https://api.sb/leaseline.app/actions/act_br07HsG8MG"
  }
}