WebLogin
HooT's WebLogin API allows you to record or register login event of a user.
Authorization-Token
and x-hoot-instance
that signifies the instance name are passed as headers.
The API returns a JSON object with two parameters: user id as user_id
and user_uuid
as unique user id. This unique user id is used to identify the user across the conferencing system
Authorizations:
header Parameters
Authorization required | string(^[\w-]*\.[\w-]*\.[\w-]*$) Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c Auth JWT token from IDP |
x-hoot-instance required | string Default: Generic Enum: "Generic" "Speakerbus" Example: Generic Instance name of the requesting entity |
Request Body schema: application/json
In the request body, the user profile is passed. This user profile is generated when we have logged in/signed up through the third-party authentication system Auth0. The user profile is a JSON object, which looks like the object shown in Example-BB.
given_name | string non-empty |
family_name | string non-empty |
nickname | string non-empty |
name required | string non-empty |
picture | string non-empty |
locale | string non-empty |
updated_at | string non-empty |
email required | string non-empty ^[a-zA-Z0-9.a-zA-Z0-9.!#$%&'*+-/=?^_`{|}~]+@[... |
email_verified | boolean |
sub required | string non-empty ^(?!\s*$).+ |
uuid | string [ 1 .. 36 ] characters ^(?!\s*$).+ |
username | string non-empty |
idpRegistered | boolean |
Responses
Request samples
- Payload
{- "given_name": "Jane",
- "family_name": "Doe",
- "nickname": "Jane.Doe",
- "name": "Jane Doe",
- "locale": "en-GB",
- "updated_at": "2022-03-12T10:31:28.797Z",
- "email": "jane.doe@example.com",
- "email_verified": true,
- "sub": "google-oauth2|108203387585675245469"
}
Response samples
- 200
- 500
{- "user_id": "dev@mpsc.io",
- "user_uuid": "728de4da-e94f-4367-80e7-c672814a55e6"
}
CheckConferenceByID
Use HooT's CheckConferenceByID API to check if a conference is alive.
The API takes Conference ID coined conf_id
as a path parameter.
Authorization-Token
and x-hoot-instance
that signifies the instance name are passed as headers.
The API returns a 200 response code in case a conference with the given Conference ID is alive, else it returns a 404 reponse code.
Authorizations:
path Parameters
conf_id required | string non-empty ^(?!\s*$).+ Example: 6e19e88d-634f-4872-826b-2d26503caba1 unique conference id used to identify a conference |
header Parameters
Authorization required | string non-empty (^[\w-]*\.[\w-]*\.[\w-]*$) Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c Auth JWT token from IDP |
x-hoot-instance required | string Default: Generic Enum: "Generic" "Melco" "Speakerbus" Example: Generic Instance name of the requesting entity |
Responses
UserLastJoinedConferences
Use HooT's UserLastJoinedConferences API to fetch list of conferences recently joined by the user within a valid range of values (to,from).
Authorization-Token
and x-hoot-instance
that signifies the instance name are passed as headers.
Unique user id as user_uuid
is passed as a path parameter to identify the user for whom the list of last joined conferences is to be retrieved.
If from is greater than maximum number of conferences joined by the user, then 204 is returned as the response code with no reponse body.
If to is greater than the maximum number of conferences joined, then conferences are returned within index range of (from,maximum number of conferences joined).
Authorizations:
path Parameters
user_uuid required | string [ 1 .. 36 ] characters ^(?!\s*$).+ Example: a5c818fb-bd18-41f6-a030-745ff9fe7f21 unique user id used to identify a user |
query Parameters
from | integer from index |
to | integer Default: -1 to index (-1 means all) |
header Parameters
Authorization required | string non-empty (^[\w-]*\.[\w-]*\.[\w-]*$) Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c Auth JWT token from IDP |
x-hoot-instance required | string Default: Generic Enum: "Generic" "Melco" "Speakerbus" Example: Generic Instance name of the requesting entity |
Responses
Response samples
- 200
[- {
- "party": {
- "user": {
- "given_name": "Dale",
- "family_name": "Steyn",
- "nickname": "Dale Steyn",
- "name": "Dale Steyn",
- "locale": "string",
- "updated_at": "2022-11-15T12:00:49.009Z",
- "email": "dev@mpsc.io",
- "email_verified": true,
- "sub": "google-oauth2|113951147567304752181",
- "uuid": "938de4da-e94f-4367-80e7-c672814a55b0",
- "username": "string",
- "idpRegistered": true
}, - "is_moderator": true,
- "conf_provider_id": "23f4c53b-4119-4581-96ca-dcc48cb8cadb",
- "is_presenter": true,
- "is_listen_only": true,
- "has_video": true,
- "client_type": "HTML5",
- "id": "23f4c53b-4129-4581-96ca-dcc48cb8cadb",
- "epoch_expiry": 0
}, - "conference": {
- "id": "23f4c53b-4719-4581-96ca-dcc48cb8cadf",
- "name": "Test-conf123",
- "coremx": {
- "uuid": "a5c818fb-bd18-41f6-a030-745ff9fe7f22",
- "name": "gcp-z2",
- "parent_cloud": "gcp",
- "capabilities": [
- "string"
], - "control_secret": "string",
- "sip": {
- "location": "sip:97263212@gcp-a1.hoot.mx",
- "username": "sip:28012@gcp-a1.hoot.mx",
- "secret": "i1Aq7prad0lNXL6Fiawn123",
- "headers": { },
- "codecs": [
- "string"
], - "domain": "string",
- "protocol": "TCP"
}, - "tags": [
- "Generic"
]
}, - "owners": [
- {
- "user": {
- "given_name": "Dale",
- "family_name": "Steyn",
- "nickname": "Dale Steyn",
- "name": "Dale Steyn",
- "locale": "string",
- "updated_at": "2022-11-15T12:00:49.009Z",
- "email": "dev@mpsc.io",
- "email_verified": true,
- "sub": "google-oauth2|113951147567304752181",
- "uuid": "938de4da-e94f-4367-80e7-c672814a55b0",
- "username": "string",
- "idpRegistered": true
}, - "is_moderator": true,
- "conf_provider_id": "23f4c53b-4119-4581-96ca-dcc48cb8cadb",
- "is_presenter": true,
- "is_listen_only": true,
- "has_video": true,
- "client_type": "HTML5",
- "id": "23f4c53b-4129-4581-96ca-dcc48cb8cadb",
- "epoch_expiry": 0
}
], - "participants": [
- {
- "user": {
- "given_name": "Dale",
- "family_name": "Steyn",
- "nickname": "Dale Steyn",
- "name": "Dale Steyn",
- "locale": "string",
- "updated_at": "2022-11-15T12:00:49.009Z",
- "email": "dev@mpsc.io",
- "email_verified": true,
- "sub": "google-oauth2|113951147567304752181",
- "uuid": "938de4da-e94f-4367-80e7-c672814a55b0",
- "username": "string",
- "idpRegistered": true
}, - "is_moderator": true,
- "conf_provider_id": "23f4c53b-4119-4581-96ca-dcc48cb8cadb",
- "is_presenter": true,
- "is_listen_only": true,
- "has_video": true,
- "client_type": "HTML5",
- "id": "23f4c53b-4129-4581-96ca-dcc48cb8cadb",
- "epoch_expiry": 0
}
], - "mod_pass": "string",
- "attend_pass": "string",
- "welcome": "<br>Welcome to <b>Test-aGMJXQYoP, SIP extn: 97263211</b>!",
- "dial_number": "+44(0)35150021",
- "voice_bridge": "91991891",
- "web_voice": "string",
- "record": "string",
- "duration": 0,
- "meta": "string",
- "moderator_only_message": "string",
- "auto_start_recording": true,
- "allow_start_stop_recording": true,
- "is_active": true,
- "hoot_instance": "Generic",
- "features": {
- "join_audio_on": true,
- "join_webcam_on": true,
- "documents": {
- "pdf_list": [
- {
- "name": "mydoc.pdf",
- "base64_representation": "string"
}
]
}, - "message_for_moderator": "string",
- "branding_skin_color": "#97340F",
- "branding_client_title": "string",
- "welcome_document": "string",
- "invitation": {
- "epoch_start": 0,
- "epoch_end": 0,
- "temporary_users": [
- "user@example.com"
]
}
}
}
}
]
UserInvitedToConferences
Use HooT's UserInvitedToConferences API to fetch list of conferences a user has been invited to, within a valid range of values (to,from).
Authorization-Token
and x-hoot-instance
that signifies the instance name are passed as headers.
Unique user id as user_uuid
is passed as a path parameter to identify the user for whom the list of invited conferences is to be retrieved.
If from is greater than maximum number of conferences the user has been invited to, then 204 is returned as the response code with no reponse body.
If to is greater than the maximum number of conferences the user has been invited to, then conferences are returned within index range of (from,maximum number of conferences user has been invited to).
Authorizations:
path Parameters
user_uuid required | string [ 1 .. 36 ] characters ^(?!\s*$).+ Example: a5c818fb-bd18-41f6-a030-745ff9fe7f21 unique user id used to identify a user |
query Parameters
from | integer >= 0 from index |
to | integer Default: -1 to index (-1) means all or max |
header Parameters
Authorization required | string(^[\w-]*\.[\w-]*\.[\w-]*$) Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c Auth JWT token from IDP |
x-hoot-instance required | string Default: Generic Enum: "Generic" "Melco" "Speakerbus" Example: Generic Instance name of the requesting entity |
Responses
Response samples
- 200
[- {
- "party": {
- "user": {
- "given_name": "Dale",
- "family_name": "Steyn",
- "nickname": "Dale Steyn",
- "name": "Dale Steyn",
- "locale": "string",
- "updated_at": "2022-11-15T12:00:49.009Z",
- "email": "dev@mpsc.io",
- "email_verified": true,
- "sub": "google-oauth2|113951147567304752181",
- "uuid": "938de4da-e94f-4367-80e7-c672814a55b0",
- "username": "string",
- "idpRegistered": true
}, - "is_moderator": true,
- "conf_provider_id": "23f4c53b-4119-4581-96ca-dcc48cb8cadb",
- "is_presenter": true,
- "is_listen_only": true,
- "has_video": true,
- "client_type": "HTML5",
- "id": "23f4c53b-4129-4581-96ca-dcc48cb8cadb",
- "epoch_expiry": 0
}, - "conference": {
- "id": "23f4c53b-4719-4581-96ca-dcc48cb8cadf",
- "name": "Test-conf123",
- "coremx": {
- "uuid": "a5c818fb-bd18-41f6-a030-745ff9fe7f22",
- "name": "gcp-z2",
- "parent_cloud": "gcp",
- "capabilities": [
- "string"
], - "control_secret": "string",
- "sip": {
- "location": "sip:97263212@gcp-a1.hoot.mx",
- "username": "sip:28012@gcp-a1.hoot.mx",
- "secret": "i1Aq7prad0lNXL6Fiawn123",
- "headers": { },
- "codecs": [
- "string"
], - "domain": "string",
- "protocol": "TCP"
}, - "tags": [
- "Generic"
]
}, - "owners": [
- {
- "user": {
- "given_name": "Dale",
- "family_name": "Steyn",
- "nickname": "Dale Steyn",
- "name": "Dale Steyn",
- "locale": "string",
- "updated_at": "2022-11-15T12:00:49.009Z",
- "email": "dev@mpsc.io",
- "email_verified": true,
- "sub": "google-oauth2|113951147567304752181",
- "uuid": "938de4da-e94f-4367-80e7-c672814a55b0",
- "username": "string",
- "idpRegistered": true
}, - "is_moderator": true,
- "conf_provider_id": "23f4c53b-4119-4581-96ca-dcc48cb8cadb",
- "is_presenter": true,
- "is_listen_only": true,
- "has_video": true,
- "client_type": "HTML5",
- "id": "23f4c53b-4129-4581-96ca-dcc48cb8cadb",
- "epoch_expiry": 0
}
], - "participants": [
- {
- "user": {
- "given_name": "Dale",
- "family_name": "Steyn",
- "nickname": "Dale Steyn",
- "name": "Dale Steyn",
- "locale": "string",
- "updated_at": "2022-11-15T12:00:49.009Z",
- "email": "dev@mpsc.io",
- "email_verified": true,
- "sub": "google-oauth2|113951147567304752181",
- "uuid": "938de4da-e94f-4367-80e7-c672814a55b0",
- "username": "string",
- "idpRegistered": true
}, - "is_moderator": true,
- "conf_provider_id": "23f4c53b-4119-4581-96ca-dcc48cb8cadb",
- "is_presenter": true,
- "is_listen_only": true,
- "has_video": true,
- "client_type": "HTML5",
- "id": "23f4c53b-4129-4581-96ca-dcc48cb8cadb",
- "epoch_expiry": 0
}
], - "mod_pass": "string",
- "attend_pass": "string",
- "welcome": "<br>Welcome to <b>Test-aGMJXQYoP, SIP extn: 97263211</b>!",
- "dial_number": "+44(0)35150021",
- "voice_bridge": "91991891",
- "web_voice": "string",
- "record": "string",
- "duration": 0,
- "meta": "string",
- "moderator_only_message": "string",
- "auto_start_recording": true,
- "allow_start_stop_recording": true,
- "is_active": true,
- "hoot_instance": "Generic",
- "features": {
- "join_audio_on": true,
- "join_webcam_on": true,
- "documents": {
- "pdf_list": [
- {
- "name": "mydoc.pdf",
- "base64_representation": "string"
}
]
}, - "message_for_moderator": "string",
- "branding_skin_color": "#97340F",
- "branding_client_title": "string",
- "welcome_document": "string",
- "invitation": {
- "epoch_start": 0,
- "epoch_end": 0,
- "temporary_users": [
- "user@example.com"
]
}
}
}
}
]
UserFavouriteConference
HooT's UserFavouriteConference API fetches the list of conferences a user has marked as favourite.
The API returns the list of all the conferences user has marked as favourite in the form of a JSON object.
Unique user id as user_uuid
is passed as a path parameter to identify the user for whom the favoruite conferences are to be retrieved.
Authorization-Token
and x-hoot-instance
that signifies the instance name are passed as headers.
Authorizations:
path Parameters
user_uuid required | string [ 1 .. 36 ] characters ^(?!\s*$).+ Example: a5c818fb-bd18-41f6-a030-745ff9fe7f21 unique user id used to identify a user |
header Parameters
Authorization required | string non-empty (^[\w-]*\.[\w-]*\.[\w-]*$) Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c Auth JWT token from IDP |
x-hoot-instance required | string Default: Generic Enum: "Generic" "Melco" "Speakerbus" Example: Generic Instance name of the requesting entity |
Responses
Response samples
- 200
[- {
- "party": {
- "user": {
- "given_name": "Dale",
- "family_name": "Steyn",
- "nickname": "Dale Steyn",
- "name": "Dale Steyn",
- "locale": "string",
- "updated_at": "2022-11-15T12:00:49.009Z",
- "email": "dev@mpsc.io",
- "email_verified": true,
- "sub": "google-oauth2|113951147567304752181",
- "uuid": "938de4da-e94f-4367-80e7-c672814a55b0",
- "username": "string",
- "idpRegistered": true
}, - "is_moderator": true,
- "conf_provider_id": "23f4c53b-4119-4581-96ca-dcc48cb8cadb",
- "is_presenter": true,
- "is_listen_only": true,
- "has_video": true,
- "client_type": "HTML5",
- "id": "23f4c53b-4129-4581-96ca-dcc48cb8cadb",
- "epoch_expiry": 0
}, - "conference": {
- "id": "23f4c53b-4719-4581-96ca-dcc48cb8cadf",
- "name": "Test-conf123",
- "coremx": {
- "uuid": "a5c818fb-bd18-41f6-a030-745ff9fe7f22",
- "name": "gcp-z2",
- "parent_cloud": "gcp",
- "capabilities": [
- "string"
], - "control_secret": "string",
- "sip": {
- "location": "sip:97263212@gcp-a1.hoot.mx",
- "username": "sip:28012@gcp-a1.hoot.mx",
- "secret": "i1Aq7prad0lNXL6Fiawn123",
- "headers": { },
- "codecs": [
- "string"
], - "domain": "string",
- "protocol": "TCP"
}, - "tags": [
- "Generic"
]
}, - "owners": [
- {
- "user": {
- "given_name": "Dale",
- "family_name": "Steyn",
- "nickname": "Dale Steyn",
- "name": "Dale Steyn",
- "locale": "string",
- "updated_at": "2022-11-15T12:00:49.009Z",
- "email": "dev@mpsc.io",
- "email_verified": true,
- "sub": "google-oauth2|113951147567304752181",
- "uuid": "938de4da-e94f-4367-80e7-c672814a55b0",
- "username": "string",
- "idpRegistered": true
}, - "is_moderator": true,
- "conf_provider_id": "23f4c53b-4119-4581-96ca-dcc48cb8cadb",
- "is_presenter": true,
- "is_listen_only": true,
- "has_video": true,
- "client_type": "HTML5",
- "id": "23f4c53b-4129-4581-96ca-dcc48cb8cadb",
- "epoch_expiry": 0
}
], - "participants": [
- {
- "user": {
- "given_name": "Dale",
- "family_name": "Steyn",
- "nickname": "Dale Steyn",
- "name": "Dale Steyn",
- "locale": "string",
- "updated_at": "2022-11-15T12:00:49.009Z",
- "email": "dev@mpsc.io",
- "email_verified": true,
- "sub": "google-oauth2|113951147567304752181",
- "uuid": "938de4da-e94f-4367-80e7-c672814a55b0",
- "username": "string",
- "idpRegistered": true
}, - "is_moderator": true,
- "conf_provider_id": "23f4c53b-4119-4581-96ca-dcc48cb8cadb",
- "is_presenter": true,
- "is_listen_only": true,
- "has_video": true,
- "client_type": "HTML5",
- "id": "23f4c53b-4129-4581-96ca-dcc48cb8cadb",
- "epoch_expiry": 0
}
], - "mod_pass": "string",
- "attend_pass": "string",
- "welcome": "<br>Welcome to <b>Test-aGMJXQYoP, SIP extn: 97263211</b>!",
- "dial_number": "+44(0)35150021",
- "voice_bridge": "91991891",
- "web_voice": "string",
- "record": "string",
- "duration": 0,
- "meta": "string",
- "moderator_only_message": "string",
- "auto_start_recording": true,
- "allow_start_stop_recording": true,
- "is_active": true,
- "hoot_instance": "Generic",
- "features": {
- "join_audio_on": true,
- "join_webcam_on": true,
- "documents": {
- "pdf_list": [
- {
- "name": "mydoc.pdf",
- "base64_representation": "string"
}
]
}, - "message_for_moderator": "string",
- "branding_skin_color": "#97340F",
- "branding_client_title": "string",
- "welcome_document": "string",
- "invitation": {
- "epoch_start": 0,
- "epoch_end": 0,
- "temporary_users": [
- "user@example.com"
]
}
}
}
}
]
UserSetFavouriteConference
You can leverage HooT's UserSetFavouriteConference API to mark a conference as favourite for a particular user.
On successful addition to the Favourites list, the API will return a 202 response code.
Conference Id as conf_id
and Unique user id as user_uuid
are passed as path parameters to identify the conference and user respectively.
Authorization-Token
and x-hoot-instance
that signifies the instance name are passed as headers.
Authorizations:
path Parameters
user_uuid required | string [ 1 .. 36 ] characters ^(?!\s*$).+ Example: a5c818fb-bd18-41f6-a030-745ff9fe7f21 unique user id used to identify a user |
conf_id required | string non-empty ^(?!\s*$).+ Example: 6e19e88d-634f-4872-826b-2d26503caba1 unique conference id used to identify a conference |
header Parameters
Authorization required | string non-empty (^[\w-]*\.[\w-]*\.[\w-]*$) Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c Auth JWT token from IDP |
x-hoot-instance required | string Default: Generic Enum: "Generic" "Melco" "Speakerbus" Example: Generic Instance name of the requesting entity |
Responses
UserUnsetFavouriteConference
You can leverage HooT's UserUnsetFavouriteConference API to remove a conference from favourites for a particular user.
On successful removal from Favourites, the API will return a 202 response code.
Conference Id as conf_id
and Unique user id as user_uuid
are passed as path parameters to identify the conference and user respectively.
Authorization-Token
and x-hoot-instance
that signifies the instance name are passed as headers.
Authorizations:
path Parameters
user_uuid required | string [ 1 .. 36 ] characters ^(?!\s*$).+ Example: a5c818fb-bd18-41f6-a030-745ff9fe7f21 unique user id used to identify a user |
conf_id required | string non-empty ^(?!\s*$).+ Example: 6e19e88d-634f-4872-826b-2d26503caba1 unique conference id used to identify a conference |
header Parameters
Authorization required | string non-empty (^[\w-]*\.[\w-]*\.[\w-]*$) Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c Auth JWT token from IDP |
x-hoot-instance required | string Default: Generic Enum: "Generic" "Melco" "Speakerbus" Example: Generic Instance name of the requesting entity |
Responses
SearchConferences
Leverage HooT's SearchConferences API to fetch list of conferences that include the search string coined search_string
, passed a path parameter.
Authorization-Token
and x-hoot-instance
that signifies the instance name are passed as headers.
count
is passed as a query parameter that signifies the limit to number of search results.By default, it's -1 which means returns all the search results.
Conferences found that includes the search term in conference name, will be returned as elements of a list object with a 200 response code, as shown in example-1
.
Authorizations:
path Parameters
search_string required | string >= 3 characters ^[a-zA-Z0-9_]*$ Example: searchterm1 Search term that should be present in the conference name. |
query Parameters
count | integer Default: -1 limit result to number of results (-1 means all) |
header Parameters
Authorization required | string Auth JWT token from IDP |
x-hoot-instance required | string Default: Generic Instance name of the requesting entity |
Responses
Response samples
- 200
SayHello
Authorizations:
header Parameters
Authorization | string Auth JWT token from IDP |
x-hoot-instance | string Default: Generic Instance name of the requesting entity |
Request Body schema: application/json
type | string Enum: "registry" "coremx" "login" "other" |
object (coremx) The CoreMX implementation |
Responses
Request samples
- Payload
CreateConference
Use HooT's CreateConference API to seamlessly create new conferences. The API returns a JSON object containing the conference details, in case the conference has been successfully created, with a 200 reponse code.
Authorization-Token
and x-hoot-instance
that signifies the instance name are passed as headers.
Conference name as conference_name
is passed a path parameter.
Authorizations:
path Parameters
conference_name required | string non-empty ^(?!\s*$).+ Example: Test-conf123 conference name by which a user can identify the conference. |
header Parameters
Authorization required | string non-empty (^[\w-]*\.[\w-]*\.[\w-]*$) Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c Auth JWT token from IDP |
x-hoot-instance required | string Default: Generic Enum: "Generic" "Speakerbus" "Melco" Example: Generic Instance name of the requesting entity |
Request Body schema: application/json
Request body accepts two mandatory parameters: moderators and participants. These are list objects containing email id of the moderators/participants you want to include in the conference. In case you want to create a conference with no moderators/participants(other than yourself), assign an empty list to both the parameters.
moderators required | Array of strings |
participants required | Array of strings |
object (features) |
Responses
Request samples
- Payload
{- "moderators": [
- "[\"FTzYdTaBpUXhZ@gmail.com\", \"OiRWiMdPGLSPk@gmail.com\"]"
], - "participants": [
- "[\"FTzYdTaBpUXhZ@gmail.com\", \"OiRWiMdPGLSPk@gmail.com\"]"
], - "features": {
- "join_audio_on": true,
- "join_webcam_on": true,
- "documents": {
- "pdf_list": [
- {
- "name": "mydoc.pdf",
- "base64_representation": "string"
}
]
}, - "message_for_moderator": "string",
- "branding_skin_color": "#97340F",
- "branding_client_title": "string",
- "welcome_document": "string",
- "invitation": {
- "epoch_start": 0,
- "epoch_end": 0,
- "temporary_users": [
- "user@example.com"
]
}
}
}
Response samples
- 200
{- "party": {
- "user": {
- "given_name": "Dale",
- "family_name": "Steyn",
- "nickname": "Dale Steyn",
- "name": "Dale Steyn",
- "locale": "string",
- "updated_at": "2022-11-15T12:00:49.009Z",
- "email": "dev@mpsc.io",
- "email_verified": true,
- "sub": "google-oauth2|113951147567304752181",
- "uuid": "938de4da-e94f-4367-80e7-c672814a55b0",
- "username": "string",
- "idpRegistered": true
}, - "is_moderator": true,
- "conf_provider_id": "23f4c53b-4119-4581-96ca-dcc48cb8cadb",
- "is_presenter": true,
- "is_listen_only": true,
- "has_video": true,
- "client_type": "HTML5",
- "id": "23f4c53b-4129-4581-96ca-dcc48cb8cadb",
- "epoch_expiry": 0
}, - "conference": {
- "id": "23f4c53b-4719-4581-96ca-dcc48cb8cadf",
- "name": "Test-conf123",
- "coremx": {
- "uuid": "a5c818fb-bd18-41f6-a030-745ff9fe7f22",
- "name": "gcp-z2",
- "parent_cloud": "gcp",
- "capabilities": [
- "string"
], - "control_secret": "string",
- "sip": {
- "location": "sip:97263212@gcp-a1.hoot.mx",
- "username": "sip:28012@gcp-a1.hoot.mx",
- "secret": "i1Aq7prad0lNXL6Fiawn123",
- "headers": { },
- "codecs": [
- "string"
], - "domain": "string",
- "protocol": "TCP"
}, - "tags": [
- "Generic"
]
}, - "owners": [
- {
- "user": {
- "given_name": "Dale",
- "family_name": "Steyn",
- "nickname": "Dale Steyn",
- "name": "Dale Steyn",
- "locale": "string",
- "updated_at": "2022-11-15T12:00:49.009Z",
- "email": "dev@mpsc.io",
- "email_verified": true,
- "sub": "google-oauth2|113951147567304752181",
- "uuid": "938de4da-e94f-4367-80e7-c672814a55b0",
- "username": "string",
- "idpRegistered": true
}, - "is_moderator": true,
- "conf_provider_id": "23f4c53b-4119-4581-96ca-dcc48cb8cadb",
- "is_presenter": true,
- "is_listen_only": true,
- "has_video": true,
- "client_type": "HTML5",
- "id": "23f4c53b-4129-4581-96ca-dcc48cb8cadb",
- "epoch_expiry": 0
}
], - "participants": [
- {
- "user": {
- "given_name": "Dale",
- "family_name": "Steyn",
- "nickname": "Dale Steyn",
- "name": "Dale Steyn",
- "locale": "string",
- "updated_at": "2022-11-15T12:00:49.009Z",
- "email": "dev@mpsc.io",
- "email_verified": true,
- "sub": "google-oauth2|113951147567304752181",
- "uuid": "938de4da-e94f-4367-80e7-c672814a55b0",
- "username": "string",
- "idpRegistered": true
}, - "is_moderator": true,
- "conf_provider_id": "23f4c53b-4119-4581-96ca-dcc48cb8cadb",
- "is_presenter": true,
- "is_listen_only": true,
- "has_video": true,
- "client_type": "HTML5",
- "id": "23f4c53b-4129-4581-96ca-dcc48cb8cadb",
- "epoch_expiry": 0
}
], - "mod_pass": "string",
- "attend_pass": "string",
- "welcome": "<br>Welcome to <b>Test-aGMJXQYoP, SIP extn: 97263211</b>!",
- "dial_number": "+44(0)35150021",
- "voice_bridge": "91991891",
- "web_voice": "string",
- "record": "string",
- "duration": 0,
- "meta": "string",
- "moderator_only_message": "string",
- "auto_start_recording": true,
- "allow_start_stop_recording": true,
- "is_active": true,
- "hoot_instance": "Generic",
- "features": {
- "join_audio_on": true,
- "join_webcam_on": true,
- "documents": {
- "pdf_list": [
- {
- "name": "mydoc.pdf",
- "base64_representation": "string"
}
]
}, - "message_for_moderator": "string",
- "branding_skin_color": "#97340F",
- "branding_client_title": "string",
- "welcome_document": "string",
- "invitation": {
- "epoch_start": 0,
- "epoch_end": 0,
- "temporary_users": [
- "user@example.com"
]
}
}
}
}
Xform
HooT's Get Base64 URL API takes Base64 encoded conference URL coined b64_URL
as a path parameter and returns the actual join URL as a JSON String with 302 response code.
If the encoded URL is not valid, the API returns a 404 response code.
Authorizations:
path Parameters
b64_URL required | string^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[... Example: TWFueSBoYW5kcyBtYWtlIGxpZ2h0IHdvcmsu conference URL in encoded in Base 64 format |
header Parameters
Authorization required | string non-empty (^[\w-]*\.[\w-]*\.[\w-]*$) Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c Auth JWT token from IDP |
x-hoot-instance required | string Default: Generic Enum: "Generic" "Melco" "Speakerbus" Example: Generic Instance name of the requesting entity |
Responses
DeleteConference
Use the DeleteConference API to delete any conference.
The API returns a 200 response code when a conference has been successfully deleted, else it will return a 404 response code if no conference is found with the given conference id.
Authorization-Token
and x-hoot-instance
that signifies the instance name are passed as headers.
Conference ID as conf_id
is passed as a path parameter to uniquely identify the conference.
Authorizations:
path Parameters
conf_id required | string non-empty ^(?!\s*$).+ Example: 6e19e88d-634f-4872-826b-2d26503caba1 unique conference id used to identify a conference |
header Parameters
Authorization required | string non-empty (^[\w-]*\.[\w-]*\.[\w-]*$) Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c Auth JWT token from IDP |
x-hoot-instance required | string Default: Generic Enum: "Generic" "Melco" "Speakerbus" Example: Generic Instance name of the requesting entity |
Responses
Response samples
- 200
AddUserSearchString
Use HooT's AddUserSearchString API to add a search term to user's search history.
The API takes the user's unique user id as user_id
and search term as search_string
,as path parameters.
Authorization-Token
and x-hoot-instance
that signifies the instance name are passed as headers.
On successfully adding the search term, the API will return a 200 response code.
Authorizations:
path Parameters
user_id required | string [ 1 .. 36 ] characters ^(?!\s*$).+ Example: a5c818fb-bd18-41f6-a030-745ff9fe7f21 unique user id to identify a user |
search_string required | string non-empty ^[a-zA-Z0-9_]*$ Example: searchterm1 search term to be added to user's search history |
header Parameters
Authorization required | string non-empty (^[\w-]*\.[\w-]*\.[\w-]*$) Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c Auth JWT token from IDP |
x-hoot-instance required | string Default: Generic Enum: "Generic" "Melco" "Speakerbus" Example: Generic Instance name of the requesting entity |
Responses
UserSearchStrings
Use HooT's UserSearchStrings API to get a list of user's search history.
The API takes the user's unique user id as user_id
as a path parameter.
Authorization-Token
and x-hoot-instance
that signifies the instance name are passed as headers.
On successful execution, the API will return a JSON object as shown in example-1
,with a 200 response code.
Authorizations:
path Parameters
user_id required | string [ 1 .. 36 ] characters ^(?!\s*$).+ Example: a5c818fb-bd18-41f6-a030-745ff9fe7f21 unique user id to identify a user |
header Parameters
Authorization required | string non-empty (^[\w-]*\.[\w-]*\.[\w-]*$) Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c Auth JWT token from IDP |
x-hoot-instance required | string Default: Generic Enum: "Generic" "Melco" "Speakerbus" Example: Generic Instance name of the requesting entity |
Responses
Response samples
- 200
[- "searchterm1",
- "searchterm2"
]
EditConference
Leverage HooT's EditConference API to add/remove participants from an existing conference. Additionally you can use this API to add existing participants or new participants as moderators to the conference.
The API takes Conference ID as conf_id
as a path parameter to uniquely identify the conference.
Authorization-Token
and x-hoot-instance
that signifies the instance name are passed as headers.
On successfully edit, the API returns a 200 reponse code with a JSON object as shown in example-1
.
Authorizations:
path Parameters
conf_id required | string non-empty ^(?!\s*$).+ Example: 6e19e88d-634f-4872-826b-2d26503caba1 unique conference id used to identify a conference |
header Parameters
Authorization required | string(^[\w-]*\.[\w-]*\.[\w-]*$) Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c Auth JWT token from IDP |
x-hoot-instance required | string Default: Generic Enum: "Generic" "Speakerbus" "Melco" Example: Generic Instance name of the requesting entity |
Request Body schema: application/json
Request body accepts three mandatory parameters: new moderators as new_moderators
,new participants as new_participants
and remove users as remove_users
.These are list objects containing email id of the moderators/participants you want to include/remove from the conference.
In case you want to leave one of these parameters blank, just assign an empty list to the said parameter
new_moderators required | Array of strings |
new_participants required | Array of strings |
remove_users required | Array of strings |
object (features) |
Responses
Request samples
- Payload
{- "new_moderators": [
- "a@b.com",
- "def@ghi.com"
], - "new_participants": [
- "client@business.com"
], - "remove_users": [
- "kkk@gmail.com"
]
}
Response samples
- 200
- 403
- 500
AllUsersofConference
Use HooT's AllUsersofConference API to fetch the list of all participants and moderators of a conference. The API takes conference ID as conf_id
as a path param to identify the conference.
If a conference is found with the given conference ID, the API will return a JSON object with two parameters moderators
and participants
containing the list of moderators and participants in the conference respectively.
Authorization-Token
and x-hoot-instance
that signifies the instance name are passed as headers.
Conference ID as conf_id
is passed as a path parameter to uniquely identify the conference
Authorizations:
path Parameters
conf_id required | string non-empty ^(?!\s*$).+ Example: 6e19e88d-634f-4872-826b-2d26503caba1 unique conference id used to identify a conference. |
header Parameters
Authorization required | string non-empty (^[\w-]*\.[\w-]*\.[\w-]*$) Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c Auth JWT token from IDP |
x-hoot-instance required | string Default: Generic Enum: "Generic" "Speakerbus" "Melco" Example: Generic Instance name of the requesting entity |
Responses
Response samples
- 200
{- "moderators": [
- "abc@f.com"
], - "participants": [
- "dev@gmail.com"
]
}
AllConferenceUsers
Use HooT's AllConferenceUsers API to fetch the list of all participants of a conference. The API takes conference ID as conf_id
as a path param to identify the conference.
If a conference is found with the given conference ID, the API will return an Array of JSON objects containing the name and email of participants in the conference respectively.
Authorization-Token
and x-hoot-instance
that signifies the instance name are passed as headers.
Conference ID as conf_id
is passed as a path parameter to uniquely identify the conference
Authorizations:
path Parameters
conf_id required | string non-empty ^(?!\s*$).+ Example: 6e19e88d-634f-4872-826b-2d26503caba1 unique conference id used to identify a conference. |
header Parameters
Authorization required | string non-empty (^[\w-]*\.[\w-]*\.[\w-]*$) Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c Auth JWT token from IDP |
x-hoot-instance required | string Default: Generic Enum: "Generic" "Speakerbus" "Melco" Example: Generic Instance name of the requesting entity |
Responses
Response samples
- 200
[- {
- "name": "ABC",
- "email": "abc@gmail.com"
}, - {
- "name": "DEF",
- "email": "def@gmail.com"
}
]
GetSIPDetailsForUserViaDeepLink
Authorizations:
path Parameters
token required | string |
participant_id required | string |
Responses
Response samples
- 200
{- "location": "sip:97263212@gcp-a1.hoot.mx",
- "username": "sip:28012@gcp-a1.hoot.mx",
- "secret": "i1Aq7prad0lNXL6Fiawn123",
- "headers": { },
- "codecs": [
- "string"
], - "domain": "string",
- "protocol": "TCP"
}
GetSIPDetailsForUserViaDeepLink-Bypass
Bypass links are to break iOS universal link loop but to exactly same as the non bypass equivalent.
Authorizations:
path Parameters
token required | string |
participant_id required | string |
Responses
Response samples
- 200
{- "location": "sip:97263212@gcp-a1.hoot.mx",
- "username": "sip:28012@gcp-a1.hoot.mx",
- "secret": "i1Aq7prad0lNXL6Fiawn123",
- "headers": { },
- "codecs": [
- "string"
], - "domain": "string",
- "protocol": "TCP"
}
SubscribeConference
Request to subscribe to a conference's events. Provide the subscription
Authorizations:
path Parameters
conf_id required | string |
header Parameters
Authorization | string Auth JWT token from IDP |
x-hoot-instance | string Instance name of the requesting entity |
Request Body schema: application/json
api_endpoint required | string^http https REST endpoint |
Responses
Request samples
- Payload
{
}
Response samples
- 201
{- "expiry_seconds": 259200,
- "id": "00f05eac-7c13-4120-b3d5-b0b0500c62a9",
- "conference_number": "98272818"
}