Update queue for a meeting type
Update user assignments or capacities for a queue associated with a meeting type
curl --request PATCH \
--url https://api.example.com/v4/queue/meeting-type/{meetingTypeId} \
--header 'Content-Type: application/json' \
--header 'x-meetergo-api-user-id: <api-key>' \
--data '
{
"userId": "<string>",
"userCapacities": [
{
"userId": "<string>",
"capacity": 123
}
],
"userPriorities": [
{
"userId": "<string>",
"priority": 123
}
],
"userCustomLinks": [
{
"userId": "<string>",
"link": "<string>"
}
],
"maxLeadThreshold": 2,
"prioritizeNearTermAvailability": true
}
'import requests
url = "https://api.example.com/v4/queue/meeting-type/{meetingTypeId}"
payload = {
"userId": "<string>",
"userCapacities": [
{
"userId": "<string>",
"capacity": 123
}
],
"userPriorities": [
{
"userId": "<string>",
"priority": 123
}
],
"userCustomLinks": [
{
"userId": "<string>",
"link": "<string>"
}
],
"maxLeadThreshold": 2,
"prioritizeNearTermAvailability": True
}
headers = {
"x-meetergo-api-user-id": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'x-meetergo-api-user-id': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
userId: '<string>',
userCapacities: [{userId: '<string>', capacity: 123}],
userPriorities: [{userId: '<string>', priority: 123}],
userCustomLinks: [{userId: '<string>', link: '<string>'}],
maxLeadThreshold: 2,
prioritizeNearTermAvailability: true
})
};
fetch('https://api.example.com/v4/queue/meeting-type/{meetingTypeId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/v4/queue/meeting-type/{meetingTypeId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'userId' => '<string>',
'userCapacities' => [
[
'userId' => '<string>',
'capacity' => 123
]
],
'userPriorities' => [
[
'userId' => '<string>',
'priority' => 123
]
],
'userCustomLinks' => [
[
'userId' => '<string>',
'link' => '<string>'
]
],
'maxLeadThreshold' => 2,
'prioritizeNearTermAvailability' => true
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-meetergo-api-user-id: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/v4/queue/meeting-type/{meetingTypeId}"
payload := strings.NewReader("{\n \"userId\": \"<string>\",\n \"userCapacities\": [\n {\n \"userId\": \"<string>\",\n \"capacity\": 123\n }\n ],\n \"userPriorities\": [\n {\n \"userId\": \"<string>\",\n \"priority\": 123\n }\n ],\n \"userCustomLinks\": [\n {\n \"userId\": \"<string>\",\n \"link\": \"<string>\"\n }\n ],\n \"maxLeadThreshold\": 2,\n \"prioritizeNearTermAvailability\": true\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("x-meetergo-api-user-id", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.example.com/v4/queue/meeting-type/{meetingTypeId}")
.header("x-meetergo-api-user-id", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"userId\": \"<string>\",\n \"userCapacities\": [\n {\n \"userId\": \"<string>\",\n \"capacity\": 123\n }\n ],\n \"userPriorities\": [\n {\n \"userId\": \"<string>\",\n \"priority\": 123\n }\n ],\n \"userCustomLinks\": [\n {\n \"userId\": \"<string>\",\n \"link\": \"<string>\"\n }\n ],\n \"maxLeadThreshold\": 2,\n \"prioritizeNearTermAvailability\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/v4/queue/meeting-type/{meetingTypeId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["x-meetergo-api-user-id"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"userId\": \"<string>\",\n \"userCapacities\": [\n {\n \"userId\": \"<string>\",\n \"capacity\": 123\n }\n ],\n \"userPriorities\": [\n {\n \"userId\": \"<string>\",\n \"priority\": 123\n }\n ],\n \"userCustomLinks\": [\n {\n \"userId\": \"<string>\",\n \"link\": \"<string>\"\n }\n ],\n \"maxLeadThreshold\": 2,\n \"prioritizeNearTermAvailability\": true\n}"
response = http.request(request)
puts response.read_bodyAuthorizations
User ID to act on behalf of. Platform API Keys only (required with an API Key unless the endpoint states otherwise). Requests authenticated with a Personal Access Token are rejected if this header names another user.
Path Parameters
ID of the meeting type
Body
Assign or deassign specified user
User capacities for queue management
Show child attributes
Show child attributes
Host priorities for round robin (higher = booked first)
Show child attributes
Show child attributes
Per-host overrides for the meeting type custom meeting link. Empty link falls back to the meeting type default.
Show child attributes
Show child attributes
Round robin queue type
simpleRoundRobin, advancedRoundRobin, equalDistribution Max bookings a host can be ahead before their availability is hidden
x >= 1Period over which bookings are counted for equal distribution
day, week, month If true, when the lead-threshold filter would push the next available slot more than 14 days past the minimum booking notice, temporarily include over-lead hosts. Disable only for strict fairness.
Response
Queue updated successfully
curl --request PATCH \
--url https://api.example.com/v4/queue/meeting-type/{meetingTypeId} \
--header 'Content-Type: application/json' \
--header 'x-meetergo-api-user-id: <api-key>' \
--data '
{
"userId": "<string>",
"userCapacities": [
{
"userId": "<string>",
"capacity": 123
}
],
"userPriorities": [
{
"userId": "<string>",
"priority": 123
}
],
"userCustomLinks": [
{
"userId": "<string>",
"link": "<string>"
}
],
"maxLeadThreshold": 2,
"prioritizeNearTermAvailability": true
}
'import requests
url = "https://api.example.com/v4/queue/meeting-type/{meetingTypeId}"
payload = {
"userId": "<string>",
"userCapacities": [
{
"userId": "<string>",
"capacity": 123
}
],
"userPriorities": [
{
"userId": "<string>",
"priority": 123
}
],
"userCustomLinks": [
{
"userId": "<string>",
"link": "<string>"
}
],
"maxLeadThreshold": 2,
"prioritizeNearTermAvailability": True
}
headers = {
"x-meetergo-api-user-id": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'x-meetergo-api-user-id': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
userId: '<string>',
userCapacities: [{userId: '<string>', capacity: 123}],
userPriorities: [{userId: '<string>', priority: 123}],
userCustomLinks: [{userId: '<string>', link: '<string>'}],
maxLeadThreshold: 2,
prioritizeNearTermAvailability: true
})
};
fetch('https://api.example.com/v4/queue/meeting-type/{meetingTypeId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/v4/queue/meeting-type/{meetingTypeId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'userId' => '<string>',
'userCapacities' => [
[
'userId' => '<string>',
'capacity' => 123
]
],
'userPriorities' => [
[
'userId' => '<string>',
'priority' => 123
]
],
'userCustomLinks' => [
[
'userId' => '<string>',
'link' => '<string>'
]
],
'maxLeadThreshold' => 2,
'prioritizeNearTermAvailability' => true
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-meetergo-api-user-id: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/v4/queue/meeting-type/{meetingTypeId}"
payload := strings.NewReader("{\n \"userId\": \"<string>\",\n \"userCapacities\": [\n {\n \"userId\": \"<string>\",\n \"capacity\": 123\n }\n ],\n \"userPriorities\": [\n {\n \"userId\": \"<string>\",\n \"priority\": 123\n }\n ],\n \"userCustomLinks\": [\n {\n \"userId\": \"<string>\",\n \"link\": \"<string>\"\n }\n ],\n \"maxLeadThreshold\": 2,\n \"prioritizeNearTermAvailability\": true\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("x-meetergo-api-user-id", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.example.com/v4/queue/meeting-type/{meetingTypeId}")
.header("x-meetergo-api-user-id", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"userId\": \"<string>\",\n \"userCapacities\": [\n {\n \"userId\": \"<string>\",\n \"capacity\": 123\n }\n ],\n \"userPriorities\": [\n {\n \"userId\": \"<string>\",\n \"priority\": 123\n }\n ],\n \"userCustomLinks\": [\n {\n \"userId\": \"<string>\",\n \"link\": \"<string>\"\n }\n ],\n \"maxLeadThreshold\": 2,\n \"prioritizeNearTermAvailability\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/v4/queue/meeting-type/{meetingTypeId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["x-meetergo-api-user-id"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"userId\": \"<string>\",\n \"userCapacities\": [\n {\n \"userId\": \"<string>\",\n \"capacity\": 123\n }\n ],\n \"userPriorities\": [\n {\n \"userId\": \"<string>\",\n \"priority\": 123\n }\n ],\n \"userCustomLinks\": [\n {\n \"userId\": \"<string>\",\n \"link\": \"<string>\"\n }\n ],\n \"maxLeadThreshold\": 2,\n \"prioritizeNearTermAvailability\": true\n}"
response = http.request(request)
puts response.read_body