Skip to main content

OpenAPI definition v0

info

You are viewing REST API documentation. This documentation is auto-generated from a swagger specification which itself is generated from annotations in the source code of the project. It is possible that this documentation includes bugs and that code samples are incomplete or wrong.

Authentication

Interaction

Retrieve an existing interaction by it's id

GET http://localhost:8080/rtc-api/interactions/{interactionId} HTTP/1.1
Host: localhost:8080
Accept: application/json

Parameters

ParameterInTypeRequiredDescription
interactionIdpathstringtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKInteraction
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

200 Response

{
"id": "string",
"organizationId": "string",
"createdBy": "string",
"createdAt": "2019-08-24T14:15:22Z",
"type": "string",
"data": {
"property1": {},
"property2": {}
},
"version": 0
}

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X GET http://localhost:8080/rtc-api/interactions/{interactionId} \
-H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Update an existing interaction

PUT http://localhost:8080/rtc-api/interactions/{interactionId} HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Accept: */*

Request body

{
"type": "string",
"data": {
"property1": {},
"property2": {}
},
"version": 0
}

Parameters

ParameterInTypeRequiredDescription
interactionIdpathstringtruenone
bodybodyUpdateInteractionWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
204No ContentUpdatedNone
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X PUT http://localhost:8080/rtc-api/interactions/{interactionId} \
-H 'Content-Type: application/json' \ -H 'Accept: */*' \ -H 'Authorization: Bearer {access-token}'

Create a new contact (not actually)

POST http://localhost:8080/rtc-api/talkdesk-integration/create HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Accept: application/json

Request body

{
"data": {
"contact_id": "string"
}
}

Parameters

ParameterInTypeRequiredDescription
bodybodyTalkdeskCreateTalkdeskRequesttruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKTalkdeskCreateTalkdeskResponse
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

200 Response

{
"message": "string",
"contact_external_id": "string"
}

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST http://localhost:8080/rtc-api/talkdesk-integration/create \
-H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

validate authorization

POST http://localhost:8080/rtc-api/talkdesk-integration/authorization-validator HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Accept: application/json

Request body

{
"property1": {},
"property2": {}
}

Parameters

ParameterInTypeRequiredDescription
bodybodyobjecttruenone
» additionalPropertiesbodyobjectfalsenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKInline
400Bad RequestBad RequestInline
Response Schema

Status Code 200

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

200 Response

{
"property1": "string",
"property2": "string"
}

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST http://localhost:8080/rtc-api/talkdesk-integration/authorization-validator \
-H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Return contact activity

POST http://localhost:8080/rtc-api/talkdesk-integration/activity HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Accept: application/json
Host: string

Request body

{
"meta": {
"interaction_types": [
"string"
]
},
"data": {
"contact_id": "string"
}
}

Parameters

ParameterInTypeRequiredDescription
Hostheaderstringtruenone
bodybodyTalkdeskContactActivityRequesttruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKInline
400Bad RequestBad RequestInline
Response Schema

Status Code 200

NameTypeRequiredRestrictionsDescription
anonymous[TalkdeskContactActivityResponseItem]falsenonenone
» idstringfalsenonenone
» subjectstringfalsenonenone
» descriptionstringfalsenonenone
» datestringfalsenonenone
» urlstringfalsenonenone
» typestringfalsenonenone
» prioritystringfalsenonenone
» statusstringfalsenonenone

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

200 Response

[
{
"id": "string",
"subject": "string",
"description": "string",
"date": "string",
"url": "string",
"type": "string",
"priority": "string",
"status": "string"
}
]

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST http://localhost:8080/rtc-api/talkdesk-integration/activity \
-H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Host: string' \ -H 'Authorization: Bearer {access-token}'

Retrieve interactions by date range

GET http://localhost:8080/rtc-api/interactions?pageable=page,0,size,1,sort,string&start=2019-08-24T14%3A15%3A22Z&end=2019-08-24T14%3A15%3A22Z&params=property1,string,property2,string HTTP/1.1
Host: localhost:8080
Accept: application/json

Parameters

ParameterInTypeRequiredDescription
pageablequeryPageabletruenone
startquerystring(date-time)truenone
endquerystring(date-time)truenone
paramsqueryobjecttruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKPageInteraction
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

200 Response

{
"totalPages": 0,
"totalElements": 0,
"size": 0,
"content": [
{
"id": "string",
"organizationId": "string",
"createdBy": "string",
"createdAt": "2019-08-24T14:15:22Z",
"type": "string",
"data": {
"property1": {},
"property2": {}
},
"version": 0
}
],
"number": 0,
"sort": [
{
"direction": "string",
"nullHandling": "string",
"ascending": true,
"property": "string",
"ignoreCase": true
}
],
"first": true,
"last": true,
"numberOfElements": 0,
"pageable": {
"offset": 0,
"sort": [
{
"direction": "string",
"nullHandling": "string",
"ascending": true,
"property": "string",
"ignoreCase": true
}
],
"pageSize": 0,
"paged": true,
"pageNumber": 0,
"unpaged": true
},
"empty": true
}

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X GET http://localhost:8080/rtc-api/interactions?pageable=page,0,size,1,sort,string&start=2019-08-24T14%3A15%3A22Z&end=2019-08-24T14%3A15%3A22Z&params=property1,string,property2,string \
-H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Create a new interaction

POST http://localhost:8080/rtc-api/interactions HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Accept: application/json

Request body

{
"interactionId": "string",
"type": "string",
"data": {
"property1": {},
"property2": {}
}
}

Parameters

ParameterInTypeRequiredDescription
bodybodyCreateInteractionWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKCreateInteractionResponse
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

200 Response

{
"interactionId": "string",
"version": 0
}

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST http://localhost:8080/rtc-api/interactions \
-H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Registrations

Create a new user endpoint aka register a user

POST http://localhost:8080/rtc-api/users/endpoints HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Accept: application/json

Request body

{
"userEndpointId": "string",
"keepAliveSeconds": 5,
"serverKeepAliveReminderOn": true
}

Parameters

ParameterInTypeRequiredDescription
bodybodyRegisterUserEndpointWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKstring
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

200 Response

"string"

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST http://localhost:8080/rtc-api/users/endpoints \
-H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Destroy an existing user endpoint aka unregister a user

POST http://localhost:8080/rtc-api/users/endpoints/unregister HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Accept: */*

Request body

{
"userEndpointId": "string",
"reason": "string"
}

Parameters

ParameterInTypeRequiredDescription
bodybodyUnregisterUserEndpointWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
204No ContentNo ContentNone
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST http://localhost:8080/rtc-api/users/endpoints/unregister \
-H 'Content-Type: application/json' \ -H 'Accept: */*' \ -H 'Authorization: Bearer {access-token}'

Sends event to all registered user endpoints

POST http://localhost:8080/rtc-api/users/endpoints/sendEvent HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Accept: */*

Returns number of messages sent. Users with 'SERVICE' role need to supply organization id.

Request body

{
"userId": "string",
"organizationId": "string",
"userEndpointId": "string",
"event": {
"property1": {},
"property2": {}
},
"masks": [
"string"
],
"qos": 0
}

Parameters

ParameterInTypeRequiredDescription
bodybodySendEventToUserWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKinteger
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

200 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST http://localhost:8080/rtc-api/users/endpoints/sendEvent \
-H 'Content-Type: application/json' \ -H 'Accept: */*' \ -H 'Authorization: Bearer {access-token}'

Create a new user endpoint aka register a user - ios specific call

POST http://localhost:8080/rtc-api/users/endpoints/register HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Accept: application/json

Request body

{
"userEndpointId": "string",
"keepAliveSeconds": 5,
"serverKeepAliveReminderOn": true
}

Parameters

ParameterInTypeRequiredDescription
bodybodyRegisterUserEndpointWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKRegisterResult
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

200 Response

{
"id": "string"
}

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST http://localhost:8080/rtc-api/users/endpoints/register \
-H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Send keepalive for a user endpoint

POST http://localhost:8080/rtc-api/users/endpoints/keepalive HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Accept: */*

Request body

{
"userEndpointId": "string"
}

Parameters

ParameterInTypeRequiredDescription
bodybodyKeepUserEndpointAliveWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
204No ContentNo ContentNone
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST http://localhost:8080/rtc-api/users/endpoints/keepalive \
-H 'Content-Type: application/json' \ -H 'Accept: */*' \ -H 'Authorization: Bearer {access-token}'

Snapshots

Upload a snapshot

POST http://localhost:8080/rtc-api/snapshots/upload HTTP/1.1
Host: localhost:8080
Content-Type: multipart/form-data
Accept: */*

Request body

relatedSnapshotId: string
applicationId: string
targetUserId: string
targetUserEndpointId: string
interactionId: string
userEndpointId: string
snapshotType: string
snapshotSuffix: string
snapshotMimeType: string
image: string

Parameters

ParameterInTypeRequiredDescription
bodybodyobjecttruenone
» relatedSnapshotIdbodystringfalsenone
» applicationIdbodystringtruenone
» targetUserIdbodystringtruenone
» targetUserEndpointIdbodystringtruenone
» interactionIdbodystringtruenone
» userEndpointIdbodystringtruenone
» snapshotTypebodystringtruenone
» snapshotSuffixbodystringtruenone
» snapshotMimeTypebodystringtruenone
» imagebodystring(binary)truenone

Responses

Overview
StatusMeaningDescriptionSchema
204No ContentNo ContentSnapshotUploadResult
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

204 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST http://localhost:8080/rtc-api/snapshots/upload \
-H 'Content-Type: multipart/form-data' \ -H 'Accept: */*' \ -H 'Authorization: Bearer {access-token}'

Create a signed url for a snapshot

POST http://localhost:8080/rtc-api/snapshots/signedUrl HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Accept: application/json
Referer: string

Request body

{
"snapshotId": "string",
"createInternalSignedUrl": true
}

Parameters

ParameterInTypeRequiredDescription
Refererheaderstringtruenone
bodybodyCreateSnapshotSignedURLWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKSignedUrl
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

200 Response

{
"url": "string",
"validUntil": "2019-08-24T14:15:22Z"
}

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST http://localhost:8080/rtc-api/snapshots/signedUrl \
-H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Referer: string' \ -H 'Authorization: Bearer {access-token}'

Creates a new snapshot request

POST http://localhost:8080/rtc-api/snapshots/request HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Accept: application/json

Request body

{
"applicationId": "string",
"userEndpointId": "string",
"targetUserId": "string",
"targetUserEndpointId": "string",
"sessionType": "UNKNOWN",
"sessionId": "string",
"interactionId": "string",
"snapshotType": "string"
}

Parameters

ParameterInTypeRequiredDescription
bodybodySnapshotRequestWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKSnapshotRequestResult
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

200 Response

{
"snapshotId": "string"
}

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST http://localhost:8080/rtc-api/snapshots/request \
-H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Discard a snapshot

POST http://localhost:8080/rtc-api/snapshots/discard HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Accept: */*

Request body

{
"snapshotId": "string",
"userEndpointId": "string"
}

Parameters

ParameterInTypeRequiredDescription
bodybodySnapshotDiscardWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
204No ContentNo ContentNone
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST http://localhost:8080/rtc-api/snapshots/discard \
-H 'Content-Type: application/json' \ -H 'Accept: */*' \ -H 'Authorization: Bearer {access-token}'

Creates a new camera request

POST http://localhost:8080/rtc-api/snapshots/cameraRequest HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Accept: application/json

Request body

{
"userEndpointId": "string",
"targetUserId": "string",
"targetUserEndpointId": "string",
"sessionType": "UNKNOWN",
"sessionId": "string",
"cameraRequestType": "CAMERA_SWITCH"
}

Parameters

ParameterInTypeRequiredDescription
bodybodySnapshotCameraRequestWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKstring
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

200 Response

"string"

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST http://localhost:8080/rtc-api/snapshots/cameraRequest \
-H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Responds to a camera request

POST http://localhost:8080/rtc-api/snapshots/cameraRequestRespond HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Accept: */*

Request body

{
"snapshotCameraRequestId": "string",
"userEndpointId": "string",
"succeeded": true,
"additionalInformation": "string"
}

Parameters

ParameterInTypeRequiredDescription
bodybodySnapshotCameraRequestRespondWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
204No ContentNo ContentNone
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST http://localhost:8080/rtc-api/snapshots/cameraRequestRespond \
-H 'Content-Type: application/json' \ -H 'Accept: */*' \ -H 'Authorization: Bearer {access-token}'

Approve a snapshot

POST http://localhost:8080/rtc-api/snapshots/approve HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Accept: */*

Request body

{
"snapshotId": "string",
"userEndpointId": "string",
"snapshotType": "string"
}

Parameters

ParameterInTypeRequiredDescription
bodybodySnapshotApproveWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
204No ContentNo ContentNone
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST http://localhost:8080/rtc-api/snapshots/approve \
-H 'Content-Type: application/json' \ -H 'Accept: */*' \ -H 'Authorization: Bearer {access-token}'

Acquire a snapshot

POST http://localhost:8080/rtc-api/snapshots/acquire HTTP/1.1
Host: localhost:8080
Content-Type: multipart/form-data
Accept: */*

Request body

snapshotId: string
userEndpointId: string
snapshotType: string
snapshotSuffix: string
snapshotMimeType: string
image: string

Parameters

ParameterInTypeRequiredDescription
bodybodyobjecttruenone
» snapshotIdbodystringtruenone
» userEndpointIdbodystringtruenone
» snapshotTypebodystringtruenone
» snapshotSuffixbodystringtruenone
» snapshotMimeTypebodystringtruenone
» imagebodystring(binary)truenone

Responses

Overview
StatusMeaningDescriptionSchema
204No ContentNo ContentNone
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST http://localhost:8080/rtc-api/snapshots/acquire \
-H 'Content-Type: multipart/form-data' \ -H 'Accept: */*' \ -H 'Authorization: Bearer {access-token}'

retrieve snapshots

GET http://localhost:8080/rtc-api/snapshots?interactionId=string HTTP/1.1
Host: localhost:8080
Accept: */*

Parameters

ParameterInTypeRequiredDescription
interactionIdquerystringtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKInline
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

200 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X GET http://localhost:8080/rtc-api/snapshots?interactionId=string \
-H 'Accept: */*' \ -H 'Authorization: Bearer {access-token}'

retrieve specific snapshot

GET http://localhost:8080/rtc-api/snapshots/{snapshotId} HTTP/1.1
Host: localhost:8080
Accept: */*

Parameters

ParameterInTypeRequiredDescription
snapshotIdpathstringtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKSnapshot
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

200 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X GET http://localhost:8080/rtc-api/snapshots/{snapshotId} \
-H 'Accept: */*' \ -H 'Authorization: Bearer {access-token}'

get a builtin signed url

GET http://localhost:8080/rtc-api/snapshots/signed/{snapshotId}/{expiration}?signature=string HTTP/1.1
Host: localhost:8080
Accept: */*

Parameters

ParameterInTypeRequiredDescription
snapshotIdpathstringtruenone
expirationpathinteger(int64)truenone
signaturequerystringtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKstring
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

200 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X GET http://localhost:8080/rtc-api/snapshots/signed/{snapshotId}/{expiration}?signature=string \
-H 'Accept: */*' \ -H 'Authorization: Bearer {access-token}'

Ratings

Create a new rating

POST http://localhost:8080/rtc-api/ratings HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Accept: application/json

Request body

{
"userEndpointId": "string",
"sessionType": "UNKNOWN",
"sessionId": "string",
"rating": 0,
"comment": "string",
"interactionId": "string"
}

Parameters

ParameterInTypeRequiredDescription
bodybodyCreateRatingWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKCreatingRatingWebResponse
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

200 Response

{
"id": "string"
}

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST http://localhost:8080/rtc-api/ratings \
-H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Find ratings by interaction id

GET http://localhost:8080/rtc-api/ratings/interactions/{interactionId} HTTP/1.1
Host: localhost:8080
Accept: application/json

Parameters

ParameterInTypeRequiredDescription
interactionIdpathstringtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKInline
400Bad RequestBad RequestInline
Response Schema

Status Code 200

NameTypeRequiredRestrictionsDescription
anonymous[Rating]falsenonenone
» idstringfalsenonerating id
» userIdstringfalsenonethe user who created this rating
» userEndpointIdstringfalsenonethe user endpoint from which the user created this rating
» organizationIdstringfalsenonerelated organization id
» interactionIdstringfalsenonerelated interaction id
» sessionTypestringfalsenonekind of session, CALL or CONFERENCE
» sessionIdstringfalsenonethe call or conference id related with this rating
» scoreinteger(int32)falsenonethe rating the user gave, scale is 1-5, 1 meaning bad and 5 perfect
» commentstringfalsenoneany comment the user gave
» createdAtstring(date-time)falsenonenone
Enumerated Values
PropertyValue
sessionTypeUNKNOWN
sessionTypeCALL
sessionTypeCONFERENCE

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

200 Response

[
{
"id": "string",
"userId": "string",
"userEndpointId": "string",
"organizationId": "string",
"interactionId": "string",
"sessionType": "UNKNOWN",
"sessionId": "string",
"score": 0,
"comment": "string",
"createdAt": "2019-08-24T14:15:22Z"
}
]

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X GET http://localhost:8080/rtc-api/ratings/interactions/{interactionId} \
-H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Find ratings by conference id

GET http://localhost:8080/rtc-api/ratings/conferences/{conferenceId} HTTP/1.1
Host: localhost:8080
Accept: application/json

Parameters

ParameterInTypeRequiredDescription
conferenceIdpathstringtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKInline
400Bad RequestBad RequestInline
Response Schema

Status Code 200

NameTypeRequiredRestrictionsDescription
anonymous[Rating]falsenonenone
» idstringfalsenonerating id
» userIdstringfalsenonethe user who created this rating
» userEndpointIdstringfalsenonethe user endpoint from which the user created this rating
» organizationIdstringfalsenonerelated organization id
» interactionIdstringfalsenonerelated interaction id
» sessionTypestringfalsenonekind of session, CALL or CONFERENCE
» sessionIdstringfalsenonethe call or conference id related with this rating
» scoreinteger(int32)falsenonethe rating the user gave, scale is 1-5, 1 meaning bad and 5 perfect
» commentstringfalsenoneany comment the user gave
» createdAtstring(date-time)falsenonenone
Enumerated Values
PropertyValue
sessionTypeUNKNOWN
sessionTypeCALL
sessionTypeCONFERENCE

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

200 Response

[
{
"id": "string",
"userId": "string",
"userEndpointId": "string",
"organizationId": "string",
"interactionId": "string",
"sessionType": "UNKNOWN",
"sessionId": "string",
"score": 0,
"comment": "string",
"createdAt": "2019-08-24T14:15:22Z"
}
]

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X GET http://localhost:8080/rtc-api/ratings/conferences/{conferenceId} \
-H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

File Transfers

Find file transfers

GET http://localhost:8080/rtc-api/filetransfers HTTP/1.1
Host: localhost:8080
Accept: application/json

Parameters

ParameterInTypeRequiredDescription
interactionIdquerystringfalsefind by interactionId, mutually exclusive with conferenceId
conferenceIdquerystringfalsefind by conferenceId, mutually exclusive with interactionId
allquerybooleanfalseif provided and true, all file transfers will be received, not just the ones sent or received by user calling which is the default behavior

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKInline
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

200 Response

{}

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X GET http://localhost:8080/rtc-api/filetransfers \
-H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Transfer a file

POST http://localhost:8080/rtc-api/filetransfers?targetType=user HTTP/1.1
Host: localhost:8080
Content-Type: multipart/form-data
Accept: */*
X-Auvious-TransactionId: string

Request body

userEndpointId: string
applicationId: string
interactionId: string
conferenceId: string
targetId: string
file: string

Parameters

ParameterInTypeRequiredDescription
X-Auvious-TransactionIdheaderstringfalseused for detecting retries of the same request
targetTypequerystringtruetarget type e.g. USER, affects which users will receive the FileTransferEvent message
bodybodyobjecttruenone
» userEndpointIdbodystringfalsewhich userEndpoint id to link to
» applicationIdbodystringtruewhich application id to use, must match user organization
» interactionIdbodystringfalsewhich integration id to link this transfer to, optional
» conferenceIdbodystringfalsewhich conference id to link this transfer to, optional
» targetIdbodystringtruetarget id e.g. a user id, will be used to send the FileTransferEvent to all user endpoints of user
» filebodystring(binary)truethe actual file
Enumerated Values
ParameterValue
targetTypeuser

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKFileTransferResult
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

200 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST http://localhost:8080/rtc-api/filetransfers?targetType=user \
-H 'Content-Type: multipart/form-data' \ -H 'Accept: */*' \ -H 'X-Auvious-TransactionId: string' \ -H 'Authorization: Bearer {access-token}'

create a signed url

POST http://localhost:8080/rtc-api/filetransfers/{fileTransferId}/signedUrl HTTP/1.1
Host: localhost:8080
Accept: application/json
Referer: string

Parameters

ParameterInTypeRequiredDescription
fileTransferIdpathstringtruenone
Refererheaderstringtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKSignedUrl
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

200 Response

{
"url": "string",
"validUntil": "2019-08-24T14:15:22Z"
}

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST http://localhost:8080/rtc-api/filetransfers/{fileTransferId}/signedUrl \
-H 'Accept: application/json' \ -H 'Referer: string' \ -H 'Authorization: Bearer {access-token}'

get a builtin signed url

GET http://localhost:8080/rtc-api/filetransfers/signed/{fileTransferId}/{expiration}?signature=string HTTP/1.1
Host: localhost:8080
Accept: */*

Parameters

ParameterInTypeRequiredDescription
fileTransferIdpathstringtruenone
expirationpathinteger(int64)truenone
signaturequerystringtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKstring
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

200 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X GET http://localhost:8080/rtc-api/filetransfers/signed/{fileTransferId}/{expiration}?signature=string \
-H 'Accept: */*' \ -H 'Authorization: Bearer {access-token}'

Conferences

View request, when a user receives ConferenceStreamPublishedEvent, the next logical thing to is to view the stream, and to view a stream one needs to start with this request.

POST http://localhost:8080/rtc-api/conferences/viewStream HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Accept: application/json

Request body

{
"conferenceId": "string",
"userEndpointId": "string",
"streamId": "string",
"sdpOffer": "string",
"viewerId": "string",
"metadata": {
"property1": "string",
"property2": "string"
}
}

Parameters

ParameterInTypeRequiredDescription
bodybodyConferenceViewStreamWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKConferenceStreamViewResult
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

200 Response

{
"viewerId": "string",
"sdpAnswer": "string"
}

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST http://localhost:8080/rtc-api/conferences/viewStream \
-H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Updates conference stream metadata

POST http://localhost:8080/rtc-api/conferences/updateStreamMetadata HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Accept: */*

Request body

{
"conferenceId": "string",
"userEndpointId": "string",
"streamId": "string",
"newMetadata": {
"property1": {},
"property2": {}
}
}

Parameters

ParameterInTypeRequiredDescription
bodybodyUpdateConferenceStreamMetadataWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
204No ContentNo ContentNone
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST http://localhost:8080/rtc-api/conferences/updateStreamMetadata \
-H 'Content-Type: application/json' \ -H 'Accept: */*' \ -H 'Authorization: Bearer {access-token}'

Update the bitrate of a conference stream.

POST http://localhost:8080/rtc-api/conferences/updatePublishedStreamBitrate HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Accept: */*

Request body

{
"conferenceId": "string",
"userEndpointId": "string",
"streamId": "string",
"videoBitrate": 30000
}

Parameters

ParameterInTypeRequiredDescription
bodybodyConferenceUpdatePublishedStreamBitrateWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
204No ContentNo ContentNone
400Bad RequestBad RequestInline
404Not FoundNot FoundNone
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST http://localhost:8080/rtc-api/conferences/updatePublishedStreamBitrate \
-H 'Content-Type: application/json' \ -H 'Accept: */*' \ -H 'Authorization: Bearer {access-token}'

Updates conference participant metadata

POST http://localhost:8080/rtc-api/conferences/updateParticipantMetadata HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Accept: */*

Request body

{
"conferenceId": "string",
"userEndpointId": "string",
"newMetadata": {
"property1": {},
"property2": {}
}
}

Parameters

ParameterInTypeRequiredDescription
bodybodyUpdateConferenceParticipantMetadataWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
204No ContentNo ContentNone
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST http://localhost:8080/rtc-api/conferences/updateParticipantMetadata \
-H 'Content-Type: application/json' \ -H 'Accept: */*' \ -H 'Authorization: Bearer {access-token}'

Updates conference metadata

POST http://localhost:8080/rtc-api/conferences/updateMetadata HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Accept: */*

Request body

{
"conferenceId": "string",
"userEndpointId": "string",
"operation": "SET",
"key": "string",
"value": "string"
}

Parameters

ParameterInTypeRequiredDescription
bodybodyUpdateConferenceMetadataWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
204No ContentNo ContentNone
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST http://localhost:8080/rtc-api/conferences/updateMetadata \
-H 'Content-Type: application/json' \ -H 'Accept: */*' \ -H 'Authorization: Bearer {access-token}'

Unpublish a stream from the conference.

POST http://localhost:8080/rtc-api/conferences/unpublishStream HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Accept: */*

Request body

{
"conferenceId": "string",
"userEndpointId": "string",
"streamId": "string"
}

Parameters

ParameterInTypeRequiredDescription
bodybodyConferenceUnpublishStreamWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
204No ContentNo ContentNone
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST http://localhost:8080/rtc-api/conferences/unpublishStream \
-H 'Content-Type: application/json' \ -H 'Accept: */*' \ -H 'Authorization: Bearer {access-token}'

Request to stop viewing a stream. Should be called when leaving, or when ConferenceStreamUnpublishedEvent is received

POST http://localhost:8080/rtc-api/conferences/stopViewStream HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Accept: */*

Request body

{
"conferenceId": "string",
"userEndpointId": "string",
"streamId": "string",
"viewerId": "string"
}

Parameters

ParameterInTypeRequiredDescription
bodybodyConferenceStopViewStreamWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
204No ContentNo ContentNone
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST http://localhost:8080/rtc-api/conferences/stopViewStream \
-H 'Content-Type: application/json' \ -H 'Accept: */*' \ -H 'Authorization: Bearer {access-token}'

Sends event to all user endpoints that are currently joined on conference defined by conferenceId

POST http://localhost:8080/rtc-api/conferences/sendEvent HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Accept: */*

Returns number of messages sent. Only users with 'SERVICE' role allowed

Request body

{
"conferenceId": "string",
"qos": "BEST_EFFORT",
"event": {
"property1": {},
"property2": {}
},
"masks": [
"string"
]
}

Parameters

ParameterInTypeRequiredDescription
bodybodySendEventToConferenceWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKSendEventResponse
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

200 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST http://localhost:8080/rtc-api/conferences/sendEvent \
-H 'Content-Type: application/json' \ -H 'Accept: */*' \ -H 'Authorization: Bearer {access-token}'

Publish a stream to the conference.

POST http://localhost:8080/rtc-api/conferences/publishStream HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Accept: application/json

Request body

{
"conferenceId": "string",
"userEndpointId": "string",
"streamId": "string",
"conferenceStreamType": "MIC",
"sdpOffer": "string",
"metadata": {
"property1": {},
"property2": {}
},
"videoBitrate": 30000
}

Parameters

ParameterInTypeRequiredDescription
bodybodyConferencePublishStreamWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKConferencePublishResult
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

200 Response

{
"streamId": "string",
"sdpAnswer": "string"
}

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST http://localhost:8080/rtc-api/conferences/publishStream \
-H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Leaves a conference.

POST http://localhost:8080/rtc-api/conferences/leave HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Accept: */*

Request body

{
"conferenceId": "string",
"userEndpointId": "string",
"reason": "string"
}

Parameters

ParameterInTypeRequiredDescription
bodybodyLeaveConferenceWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
204No ContentNo ContentNone
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST http://localhost:8080/rtc-api/conferences/leave \
-H 'Content-Type: application/json' \ -H 'Accept: */*' \ -H 'Authorization: Bearer {access-token}'

Joins a conference

POST http://localhost:8080/rtc-api/conferences/join HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Accept: application/json

Request body

{
"conferenceId": "string",
"userEndpointId": "string",
"metadata": {
"property1": {},
"property2": {}
}
}

Parameters

ParameterInTypeRequiredDescription
bodybodyJoinConferenceWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKConferenceSummary
400Bad RequestBad RequestAnotherErrorResponse
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline
422Unprocessable EntityConference Already Joined from same user and endpointInline
Response Schema
Examples

200 Response

{
"id": "string",
"version": 0,
"mode": "P2P"
}
caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST http://localhost:8080/rtc-api/conferences/join \
-H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'
POST http://localhost:8080/rtc-api/conferences/interaction HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Accept: */*

Request body

{
"conferenceId": "string",
"interactionId": "string",
"userEndpointId": "string"
}

Parameters

ParameterInTypeRequiredDescription
bodybodySetInteractionIdWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
204No ContentNo ContentNone
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST http://localhost:8080/rtc-api/conferences/interaction \
-H 'Content-Type: application/json' \ -H 'Accept: */*' \ -H 'Authorization: Bearer {access-token}'

Ends a conference.

POST http://localhost:8080/rtc-api/conferences/end HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Accept: */*

Request body

{
"conferenceId": "string",
"userEndpointId": "string",
"reason": "string"
}

Parameters

ParameterInTypeRequiredDescription
bodybodyEndConferenceWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
204No ContentNo ContentNone
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST http://localhost:8080/rtc-api/conferences/end \
-H 'Content-Type: application/json' \ -H 'Accept: */*' \ -H 'Authorization: Bearer {access-token}'

Creates a conference.

POST http://localhost:8080/rtc-api/conferences/create HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Accept: application/json

Request body

{
"conferenceId": "string",
"mode": "P2P",
"organizationId": "string",
"creatorEndpoint": "string",
"interactionId": "string",
"metadata": {
"property1": "string",
"property2": "string"
}
}

Parameters

ParameterInTypeRequiredDescription
bodybodyCreateConferenceWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKConferenceSummary
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

200 Response

{
"id": "string",
"version": 0,
"mode": "P2P"
}

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST http://localhost:8080/rtc-api/conferences/create \
-H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Adds ice candidates for a view stream request.

POST http://localhost:8080/rtc-api/conferences/addViewStreamIceCandidates HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Accept: */*

Request body

{
"conferenceId": "string",
"userEndpointId": "string",
"streamId": "string",
"viewerId": "string",
"iceCandidates": [
{
"candidate": "string",
"sdpMid": "string",
"sdpMLineIndex": 0
}
]
}

Parameters

ParameterInTypeRequiredDescription
bodybodyConferenceViewStreamIceCandidatesWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
204No ContentNo ContentNone
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST http://localhost:8080/rtc-api/conferences/addViewStreamIceCandidates \
-H 'Content-Type: application/json' \ -H 'Accept: */*' \ -H 'Authorization: Bearer {access-token}'

Adds ice candidates for a published stream. Must be called after publishStream request.

POST http://localhost:8080/rtc-api/conferences/addPublishStreamIceCandidates HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Accept: */*

Request body

{
"conferenceId": "string",
"userEndpointId": "string",
"streamId": "string",
"iceCandidates": [
{
"candidate": "string",
"sdpMid": "string",
"sdpMLineIndex": 0
}
]
}

Parameters

ParameterInTypeRequiredDescription
bodybodyConferencePublishStreamIceCandidatesWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
204No ContentNo ContentNone
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST http://localhost:8080/rtc-api/conferences/addPublishStreamIceCandidates \
-H 'Content-Type: application/json' \ -H 'Accept: */*' \ -H 'Authorization: Bearer {access-token}'

Get conference aggregate.

GET http://localhost:8080/rtc-api/conferences/{id} HTTP/1.1
Host: localhost:8080
Accept: application/json

Parameters

ParameterInTypeRequiredDescription
idpathstringtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKConference
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

200 Response

{
"id": "string",
"mode": "P2P",
"organizationId": "string",
"interactionId": "string",
"creator": "string",
"creatorEndpoint": "string",
"participants": [
{
"id": "string",
"userId": "string",
"state": "HEALTHY",
"streams": [
{
"id": "string",
"type": "MIC",
"metadata": {
"property1": {},
"property2": {}
},
"videoBitrate": 0
}
],
"metadata": {
"property1": {},
"property2": {}
}
}
],
"metadata": {
"property1": {
"value": "string",
"userId": "string",
"userEndpointId": "string",
"lastModified": "2019-08-24T14:15:22Z"
},
"property2": {
"value": "string",
"userId": "string",
"userEndpointId": "string",
"lastModified": "2019-08-24T14:15:22Z"
}
},
"version": 0,
"empty": true
}

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X GET http://localhost:8080/rtc-api/conferences/{id} \
-H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Get a simple view of a conference, similar to full details but more convenient for some ui clients

GET http://localhost:8080/rtc-api/conferences/{id}/simpleView HTTP/1.1
Host: localhost:8080
Accept: application/json

Parameters

ParameterInTypeRequiredDescription
idpathstringtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKConferenceSimpleView
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

200 Response

{
"id": "string",
"mode": "string",
"metadata": {
"property1": {
"value": "string",
"userId": "string",
"userEndpointId": "string",
"lastModified": "2019-08-24T14:15:22Z"
},
"property2": {
"value": "string",
"userId": "string",
"userEndpointId": "string",
"lastModified": "2019-08-24T14:15:22Z"
}
},
"participants": [
{
"id": "string",
"endpoints": [
{
"id": "string",
"state": "HEALTHY",
"streams": [
{
"id": "string",
"type": "string",
"metadata": {
"property1": {},
"property2": {}
}
}
],
"metadata": {
"property1": {},
"property2": {}
}
}
]
}
],
"version": 0
}

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X GET http://localhost:8080/rtc-api/conferences/{id}/simpleView \
-H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Get a list of all events of a conference, optionally since version v(query param). Blocks for a few seconds if no event is available at the time

GET http://localhost:8080/rtc-api/conferences/{id}/events?v=0 HTTP/1.1
Host: localhost:8080
Accept: application/json

Parameters

ParameterInTypeRequiredDescription
idpathstringtruenone
vqueryinteger(int64)truenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKInline
400Bad RequestBad RequestInline
Response Schema

Status Code 200

NameTypeRequiredRestrictionsDescription
anonymous[ConferenceEvent]falsenonenone
» idstringfalsenoneevent unique id
» typestringfalsenoneevent type
» timestampstring(date-time)falsenoneevent time, format is "yyyy-MM-dd'T'HH:mm:ss.SSS'Z'"
» conferenceIdstringfalsenonethe conference which this event belongs to
» organizationIdstringfalsenonethe organizationId
» conferenceVersioninteger(int64)falsenonethe conference version this event was produced- can be used for ordering and or deduplication. It contains the version of the conference when the event was generated or null for creation events

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

200 Response

[
{
"id": "string",
"type": "string",
"timestamp": "2019-08-24T14:15:22Z",
"conferenceId": "string",
"organizationId": "string",
"conferenceVersion": 0
}
]

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X GET http://localhost:8080/rtc-api/conferences/{id}/events?v=0 \
-H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Gets a list of active conferences of the user organization

GET http://localhost:8080/rtc-api/conferences/active HTTP/1.1
Host: localhost:8080
Accept: application/json

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKInline
400Bad RequestBad RequestInline
Response Schema

Status Code 200

NameTypeRequiredRestrictionsDescription
anonymous[Conference]falsenonenone
» idstringfalsenonenone
» modestringfalsenonenone
» organizationIdstringfalsenonenone
» interactionIdstringfalsenonenone
» creatorstringfalsenonenone
» creatorEndpointstringfalsenonenone
» participants[ConferenceParticipant]falsenonenone
»» idstringfalsenonenone
»» userIdstringfalsenonenone
»» statestringfalsenonenone
»» streams[ConferenceStream]falsenonenone
»»» idstringfalsenonenone
»»» typestringfalsenonenone
»»» metadataobjectfalsenonenone
»»»» additionalPropertiesobjectfalsenonenone
»»» videoBitrateinteger(int32)falsenonenone
»» metadataobjectfalsenonenone
»»» additionalPropertiesobjectfalsenonenone
» metadataobjectfalsenonenone
»» additionalPropertiesMetadatafalsenonenone
»»» valuestringfalsenonenone
»»» userIdstringfalsenonenone
»»» userEndpointIdstringfalsenonenone
»»» lastModifiedstring(date-time)falsenonenone
» versioninteger(int64)falsenonenone
» emptybooleanfalsenonenone
Enumerated Values
PropertyValue
modeP2P
modeROUTER
modeUNKNOWN
stateHEALTHY
stateSICK
stateUNKNOWN
typeMIC
typeCAM
typeSCREEN
typeMIC_AND_CAM
typeUNKNOWN

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

200 Response

[
{
"id": "string",
"mode": "P2P",
"organizationId": "string",
"interactionId": "string",
"creator": "string",
"creatorEndpoint": "string",
"participants": [
{
"id": "string",
"userId": "string",
"state": "HEALTHY",
"streams": [
{
"id": "string",
"type": "MIC",
"metadata": {
"property1": {},
"property2": {}
},
"videoBitrate": 0
}
],
"metadata": {
"property1": {},
"property2": {}
}
}
],
"metadata": {
"property1": {
"value": "string",
"userId": "string",
"userEndpointId": "string",
"lastModified": "2019-08-24T14:15:22Z"
},
"property2": {
"value": "string",
"userId": "string",
"userEndpointId": "string",
"lastModified": "2019-08-24T14:15:22Z"
}
},
"version": 0,
"empty": true
}
]

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X GET http://localhost:8080/rtc-api/conferences/active \
-H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Assets

Upload an asset

POST http://localhost:8080/rtc-api/assets/{assetId} HTTP/1.1
Host: localhost:8080
Content-Type: multipart/form-data
Accept: */*
X-Auvious-TransactionId: string

Request body

applicationId: string
category: string
filename: string
rolesAllowedAccess: string
file: string

Parameters

ParameterInTypeRequiredDescription
assetIdpathstringtruenone
X-Auvious-TransactionIdheaderstringfalseused for detecting retries of the same request
bodybodyobjecttruenone
» applicationIdbodystringtruenone
» categorybodystringtruenone
» filenamebodystringfalsenone
» rolesAllowedAccessbodystringtruecomma separated list of roles allowed to access the asset, e.g.: admin,customer
» filebodystring(binary)truenone

Responses

Overview
StatusMeaningDescriptionSchema
204No ContentNo ContentNone
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST http://localhost:8080/rtc-api/assets/{assetId} \
-H 'Content-Type: multipart/form-data' \ -H 'Accept: */*' \ -H 'X-Auvious-TransactionId: string' \ -H 'Authorization: Bearer {access-token}'

Delete an asset

DELETE http://localhost:8080/rtc-api/assets/{assetId} HTTP/1.1
Host: localhost:8080
Accept: */*
X-Auvious-TransactionId: string

Parameters

ParameterInTypeRequiredDescription
assetIdpathstringtrueid of asset to delete
X-Auvious-TransactionIdheaderstringfalseOptional header used for detecting retries of the same request

Responses

Overview
StatusMeaningDescriptionSchema
204No ContentNo ContentNone
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X DELETE http://localhost:8080/rtc-api/assets/{assetId} \
-H 'Accept: */*' \ -H 'X-Auvious-TransactionId: string' \ -H 'Authorization: Bearer {access-token}'

signedUrl_1

POST http://localhost:8080/rtc-api/assets/{assetId}/signedUrl HTTP/1.1
Host: localhost:8080
Accept: application/json
X-Auvious-CreateInternalSignedUrl: true
Referer: string

create a signed url

Parameters

ParameterInTypeRequiredDescription
assetIdpathstringtruenone
X-Auvious-CreateInternalSignedUrlheaderbooleanfalsenone
Refererheaderstringtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKSignedUrl
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

200 Response

{
"url": "string",
"validUntil": "2019-08-24T14:15:22Z"
}

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST http://localhost:8080/rtc-api/assets/{assetId}/signedUrl \
-H 'Accept: application/json' \ -H 'X-Auvious-CreateInternalSignedUrl: true' \ -H 'Referer: string' \ -H 'Authorization: Bearer {access-token}'

Find assets by application id

GET http://localhost:8080/rtc-api/assets?applicationId=string HTTP/1.1
Host: localhost:8080
Accept: application/json

Parameters

ParameterInTypeRequiredDescription
applicationIdquerystringtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKInline
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

200 Response

{}

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X GET http://localhost:8080/rtc-api/assets?applicationId=string \
-H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

get a builtin signed url

GET http://localhost:8080/rtc-api/assets/signed/{assetId}/{expiration}?signature=string HTTP/1.1
Host: localhost:8080
Accept: */*

Parameters

ParameterInTypeRequiredDescription
assetIdpathstringtruenone
expirationpathinteger(int64)truenone
signaturequerystringtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKInline
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

200 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X GET http://localhost:8080/rtc-api/assets/signed/{assetId}/{expiration}?signature=string \
-H 'Accept: */*' \ -H 'Authorization: Bearer {access-token}'

IceSupport

Obtains iceServers for use by WebRTC peers

GET http://localhost:8080/rtc-api/iceServers HTTP/1.1
Host: localhost:8080
Accept: application/json

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKIceServersResult
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

200 Response

{
"iceServers": [
{
"urls": [
"string"
],
"username": "string",
"credential": "string"
}
],
"ttl": 0
}

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X GET http://localhost:8080/rtc-api/iceServers \
-H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

iceServersV2

GET http://localhost:8080/rtc-api/iceServers/v2 HTTP/1.1
Host: localhost:8080
Accept: application/json

Obtains iceServers for use by WebRTC peers

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKIceServersResultV2
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesstringfalsenonenone
Examples

200 Response

{
"stun": "string",
"turn": "string",
"turnUsername": "string",
"turnPassword": "string",
"ttl": 0
}

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X GET http://localhost:8080/rtc-api/iceServers/v2 \
-H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Schemas

UpdateInteractionWebCommand

{
"type": "string",
"data": {
"property1": {},
"property2": {}
},
"version": 0
}

Properties

NameTypeRequiredRestrictionsDescription
typestringfalsenonetype of interaction, e.g. video call if omitted it wont be updated
dataobjectfalsenoneinteraction data, this is the place to store arbitrary data that might be needed later, if omitted it won't be updated. Careful with this, when supplied it all data will be replaced
» additionalPropertiesobjectfalsenoneinteraction data, this is the place to store arbitrary data that might be needed later, if omitted it won't be updated. Careful with this, when supplied it all data will be replaced
versioninteger(int64)falsenoneversion of the interaction, used for optimistic locking, optional, if not provided it will be ignored

RegisterUserEndpointWebCommand

{
"userEndpointId": "string",
"keepAliveSeconds": 5,
"serverKeepAliveReminderOn": true
}

Properties

NameTypeRequiredRestrictionsDescription
userEndpointIdstringfalsenoneSupply the userEndpointId. Take care so this value is unique, otherwise better leave this empty and let the server produce one. Optional.
keepAliveSecondsinteger(int32)truenonehow long before this endpoint expires if no keepalive request is sent. Mandatory.
serverKeepAliveReminderOnbooleanfalsenoneif true, then an Event will be sent to the userEndpoint topic, to remind the client to makea keepalive request. Default is false.

UnregisterUserEndpointWebCommand

{
"userEndpointId": "string",
"reason": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
userEndpointIdstringtruenonenone
reasonstringfalsenonenone

SendEventToUserWebCommand

{
"userId": "string",
"organizationId": "string",
"userEndpointId": "string",
"event": {
"property1": {},
"property2": {}
},
"masks": [
"string"
],
"qos": 0
}

Properties

NameTypeRequiredRestrictionsDescription
userIdstringtruenoneuserId of user that will receive the message
organizationIdstringtruenoneOrganization id of user that sends and must match the user's org who will receive the message. Only applicable to internal services, for normal users their jwt organization_id claim will be used, since theycan only send events to users of their own organization
userEndpointIdstringfalsenoneuserEndpointId of user that will receive the message, if not supplied it will be sent to all user endpoints of user with the specified userId.
eventobjecttruenoneevent attributes, at least type and timestamp must be supplied with correct format. Format for type should begin with capital, end with Event, and use came case of at least a noun and a verb denoting what happened on what. Format for timestamp is ISO-8601 instant format e.g. '2011-12-03T10:15:30Z
» additionalPropertiesobjectfalsenoneevent attributes, at least type and timestamp must be supplied with correct format. Format for type should begin with capital, end with Event, and use came case of at least a noun and a verb denoting what happened on what. Format for timestamp is ISO-8601 instant format e.g. '2011-12-03T10:15:30Z
masks[string]falsenonemasks to apply, each item denotes a json path (https://github.com/json-path/JsonPath) syntax which will be applied on the event when stored or logged. By default no masks are applied. The masked fields must be of type string, and it will be replaced by a string of same length but with strings.
qosinteger(int32)falsenoneqos level 0 = best effort, 1 = at least once, other values best effort. Defaults to 0 (best effort)

RegisterResult

{
"id": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
idstringfalsenoneuser endpoint id

KeepUserEndpointAliveWebCommand

{
"userEndpointId": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
userEndpointIdstringtruenonenone

RequestData

{
"contact_id": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
contact_idstringfalsenonenone

TalkdeskCreateTalkdeskRequest

{
"data": {
"contact_id": "string"
}
}

Properties

NameTypeRequiredRestrictionsDescription
dataRequestDatafalsenonenone

TalkdeskCreateTalkdeskResponse

{
"message": "string",
"contact_external_id": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
messagestringfalsenonenone
contact_external_idstringfalsenonenone

Meta

{
"interaction_types": [
"string"
]
}

Properties

NameTypeRequiredRestrictionsDescription
interaction_types[string]falsenonenone

TalkdeskContactActivityRequest

{
"meta": {
"interaction_types": [
"string"
]
},
"data": {
"contact_id": "string"
}
}

Properties

NameTypeRequiredRestrictionsDescription
metaMetafalsenonenone
dataRequestDatafalsenonenone

TalkdeskContactActivityResponseItem

{
"id": "string",
"subject": "string",
"description": "string",
"date": "string",
"url": "string",
"type": "string",
"priority": "string",
"status": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
idstringfalsenonenone
subjectstringfalsenonenone
descriptionstringfalsenonenone
datestringfalsenonenone
urlstringfalsenonenone
typestringfalsenonenone
prioritystringfalsenonenone
statusstringfalsenonenone

SnapshotUploadResult

{
"snapshotId": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
snapshotIdstringfalsenonenone

CreateSnapshotSignedURLWebCommand

{
"snapshotId": "string",
"createInternalSignedUrl": true
}

Properties

NameTypeRequiredRestrictionsDescription
snapshotIdstringtruenonenone
createInternalSignedUrlbooleanfalsenonenone

SignedUrl

{
"url": "string",
"validUntil": "2019-08-24T14:15:22Z"
}

Properties

NameTypeRequiredRestrictionsDescription
urlstring(url)falsenonenone
validUntilstring(date-time)falsenonenone

SnapshotRequestWebCommand

{
"applicationId": "string",
"userEndpointId": "string",
"targetUserId": "string",
"targetUserEndpointId": "string",
"sessionType": "UNKNOWN",
"sessionId": "string",
"interactionId": "string",
"snapshotType": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
applicationIdstringtruenonethe application to use
userEndpointIdstringtruenonethe requester's userEndpointId
targetUserIdstringtruenonethe request's target userId
targetUserEndpointIdstringtruenonethe request's target userEndpointId
sessionTypestringfalsenonesession type, one of CONFERENCE
sessionIdstringfalsenonesession id, e.g. conference id for conference
interactionIdstringfalsenoneinteraction id, e.g. if provided snapshot will be stored under interactions/{interaction-id} folder in storage
snapshotTypestringfalsenonethe snapshot's type
Enumerated Values
PropertyValue
sessionTypeUNKNOWN
sessionTypeCALL
sessionTypeCONFERENCE

SnapshotRequestResult

{
"snapshotId": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
snapshotIdstringfalsenonenone

SnapshotDiscardWebCommand

{
"snapshotId": "string",
"userEndpointId": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
snapshotIdstringtruenonethe snapshot id
userEndpointIdstringtruenonethe discarder's userEndpointId

SnapshotCameraRequestWebCommand

{
"userEndpointId": "string",
"targetUserId": "string",
"targetUserEndpointId": "string",
"sessionType": "UNKNOWN",
"sessionId": "string",
"cameraRequestType": "CAMERA_SWITCH"
}

Properties

NameTypeRequiredRestrictionsDescription
userEndpointIdstringtruenonethe requester's userEndpointId
targetUserIdstringtruenonethe request's target userId
targetUserEndpointIdstringtruenonethe request's target userEndpointId
sessionTypestringfalsenonesession type, one of CONFERENCE
sessionIdstringfalsenonesession id, e.g. conference id for conference
cameraRequestTypestringtruenonethe request type, feel free to enter what suits you
Enumerated Values
PropertyValue
sessionTypeUNKNOWN
sessionTypeCALL
sessionTypeCONFERENCE
cameraRequestTypeCAMERA_SWITCH
cameraRequestTypeFLASH_ON
cameraRequestTypeFLASH_OFF

SnapshotCameraRequestRespondWebCommand

{
"snapshotCameraRequestId": "string",
"userEndpointId": "string",
"succeeded": true,
"additionalInformation": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
snapshotCameraRequestIdstringtruenonethe request id
userEndpointIdstringtruenonethe responder's userEndpointId
succeededbooleantruenoneindicates if the request succeeded
additionalInformationstringfalsenoneadditional information about the request success or failure

SnapshotApproveWebCommand

{
"snapshotId": "string",
"userEndpointId": "string",
"snapshotType": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
snapshotIdstringtruenonethe snapshot id
userEndpointIdstringtruenonethe requester's userEndpointId
snapshotTypestringfalsenonethe snapshot type (override request snapshot type)

CreateRatingWebCommand

{
"userEndpointId": "string",
"sessionType": "UNKNOWN",
"sessionId": "string",
"rating": 0,
"comment": "string",
"interactionId": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
userEndpointIdstringfalsenoneuser endpoint id, optional
sessionTypestringtruenonetype of session, CALL or CONFERENCE
sessionIdstringtruenonethe call or conference id related with this rating
ratinginteger(int32)truenonethe rating the user gave, scale is 1-5, 1 meaning bad and 5 perfect
commentstringfalsenoneany comment the user gave
interactionIdstringfalsenonerelated interaction id
Enumerated Values
PropertyValue
sessionTypeUNKNOWN
sessionTypeCALL
sessionTypeCONFERENCE

CreatingRatingWebResponse

{
"id": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
idstringfalsenonenone

CreateInteractionWebCommand

{
"interactionId": "string",
"type": "string",
"data": {
"property1": {},
"property2": {}
}
}

Properties

NameTypeRequiredRestrictionsDescription
interactionIdstringfalsenoneinteraction id, can be supplied to match integration party e.g. Genesys Cloud interaction/conversation id
typestringfalsenonetype of interaction, e.g. video call
dataobjectfalsenoneinteraction data, this is the place to store arbitrary data that might be needed later
» additionalPropertiesobjectfalsenoneinteraction data, this is the place to store arbitrary data that might be needed later

CreateInteractionResponse

{
"interactionId": "string",
"version": 0
}

Properties

NameTypeRequiredRestrictionsDescription
interactionIdstringfalsenonenone
versioninteger(int64)falsenonenone

FileTransferResult

{
"fileTransferId": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
fileTransferIdstringfalsenonenone

ConferenceViewStreamWebCommand

{
"conferenceId": "string",
"userEndpointId": "string",
"streamId": "string",
"sdpOffer": "string",
"viewerId": "string",
"metadata": {
"property1": "string",
"property2": "string"
}
}

Properties

NameTypeRequiredRestrictionsDescription
conferenceIdstringtruenoneSupply the conferenceId. Mandatory.
userEndpointIdstringtruenoneSupply the user endpoint id of the viewer. Mandatory.
streamIdstringtruenoneSupply the stream id to view. Mandatory.
sdpOfferstringtruenoneSupply the sdp offer. Mandatory.
viewerIdstringfalsenoneSupply the viewerId. Optional.
metadataobjectfalsenoneStream metadata. Optional.
» additionalPropertiesstringfalsenoneStream metadata. Optional.

ConferenceStreamViewResult

{
"viewerId": "string",
"sdpAnswer": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
viewerIdstringfalsenonenone
sdpAnswerstringfalsenonenone

UpdateConferenceStreamMetadataWebCommand

{
"conferenceId": "string",
"userEndpointId": "string",
"streamId": "string",
"newMetadata": {
"property1": {},
"property2": {}
}
}

Properties

NameTypeRequiredRestrictionsDescription
conferenceIdstringtruenoneSupply the conferenceId. Mandatory.
userEndpointIdstringtruenoneSupply the user endpoint id. Mandatory.
streamIdstringtruenoneSupply the streamId. Optional.
newMetadataobjectfalsenoneSupply the metadata of the stream.
» additionalPropertiesobjectfalsenoneSupply the metadata of the stream.

ConferenceUpdatePublishedStreamBitrateWebCommand

{
"conferenceId": "string",
"userEndpointId": "string",
"streamId": "string",
"videoBitrate": 30000
}

Properties

NameTypeRequiredRestrictionsDescription
conferenceIdstringtruenoneSupply the conferenceId. Mandatory.
userEndpointIdstringtruenoneSupply the user endpoint id. Mandatory.
streamIdstringfalsenoneSupply the streamId. Optional.
videoBitrateinteger(int32)truenoneStream video bitrate. Optional

UpdateConferenceParticipantMetadataWebCommand

{
"conferenceId": "string",
"userEndpointId": "string",
"newMetadata": {
"property1": {},
"property2": {}
}
}

Properties

NameTypeRequiredRestrictionsDescription
conferenceIdstringtruenoneSupply the conferenceId. Mandatory.
userEndpointIdstringtruenoneSupply the user endpoint id. Mandatory.
newMetadataobjecttruenoneSupply the metadata of the user.
» additionalPropertiesobjectfalsenoneSupply the metadata of the user.

UpdateConferenceMetadataWebCommand

{
"conferenceId": "string",
"userEndpointId": "string",
"operation": "SET",
"key": "string",
"value": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
conferenceIdstringtruenoneSupply the conferenceId. Mandatory.
userEndpointIdstringtruenoneSupply the user endpoint id. Mandatory.
operationstringtruenoneSupply the operation, SET or REMOVE. Mandatory.
keystringtruenoneSupply the key. Mandatory
valuestringfalsenoneSupply the value, if the operation is SET. Ignored if operation is REMOVE
Enumerated Values
PropertyValue
operationSET
operationREMOVE
operationUNKNOWN

ConferenceUnpublishStreamWebCommand

{
"conferenceId": "string",
"userEndpointId": "string",
"streamId": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
conferenceIdstringtruenoneSupply the conferenceId. Mandatory.
userEndpointIdstringtruenoneSupply the user endpoint id. Mandatory.
streamIdstringtruenoneSupply the stream id to unpublish. Mandatory.

ConferenceStopViewStreamWebCommand

{
"conferenceId": "string",
"userEndpointId": "string",
"streamId": "string",
"viewerId": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
conferenceIdstringtruenoneSupply the conferenceId. Mandatory.
userEndpointIdstringtruenoneSupply the user endpoint id. Mandatory.
streamIdstringtruenoneSupply the stream id. Mandatory.
viewerIdstringtruenoneSupply the viewer id. Mandatory.

SendEventToConferenceWebCommand

{
"conferenceId": "string",
"qos": "BEST_EFFORT",
"event": {
"property1": {},
"property2": {}
},
"masks": [
"string"
]
}

Properties

NameTypeRequiredRestrictionsDescription
conferenceIdstringtruenoneconference id the members of which will receive the message
qosstringtruenonedefine qos(optional), default is best effort
eventobjecttruenoneevent attributes, at least type and timestamp must be supplied with correct format. Format for type should begin with capital, end with Event, and use came case of at least a noun and a verb denoting what happened on what. Format for timestamp is ISO-8601 instant format e.g. '2011-12-03T10:15:30Z
» additionalPropertiesobjectfalsenoneevent attributes, at least type and timestamp must be supplied with correct format. Format for type should begin with capital, end with Event, and use came case of at least a noun and a verb denoting what happened on what. Format for timestamp is ISO-8601 instant format e.g. '2011-12-03T10:15:30Z
masks[string]falsenonemasks to apply, each item denotes a json path (https://github.com/json-path/JsonPath) syntax which will be applied on the event when stored or logged. By default no masks are applied. The masked fields must be of type string, and it will be replaced by a string of same length but with strings.
Enumerated Values
PropertyValue
qosBEST_EFFORT
qosAT_LEAST_ONCE

SendEventResponse

{
"eventsSent": 0
}

Properties

NameTypeRequiredRestrictionsDescription
eventsSentinteger(int32)falsenonenone

ConferencePublishStreamWebCommand

{
"conferenceId": "string",
"userEndpointId": "string",
"streamId": "string",
"conferenceStreamType": "MIC",
"sdpOffer": "string",
"metadata": {
"property1": {},
"property2": {}
},
"videoBitrate": 30000
}

Properties

NameTypeRequiredRestrictionsDescription
conferenceIdstringtruenoneSupply the conferenceId. Mandatory.
userEndpointIdstringtruenoneSupply the user endpoint id. Mandatory.
streamIdstringfalsenoneSupply the streamId. Optional.
conferenceStreamTypestringtruenoneSupply the stream type. One of MIC, CAM, SCREEN or MIC_AND_CAM. Mandatory.
sdpOfferstringfalsenoneSupply the sdpOffer. Mandatory.
metadataobjectfalsenoneStream metadata. Optional
» additionalPropertiesobjectfalsenoneStream metadata. Optional
videoBitrateinteger(int32)falsenoneStream video bitrate. Optional
Enumerated Values
PropertyValue
conferenceStreamTypeMIC
conferenceStreamTypeCAM
conferenceStreamTypeSCREEN
conferenceStreamTypeMIC_AND_CAM
conferenceStreamTypeUNKNOWN

ConferencePublishResult

{
"streamId": "string",
"sdpAnswer": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
streamIdstringfalsenonenone
sdpAnswerstringfalsenonenone

LeaveConferenceWebCommand

{
"conferenceId": "string",
"userEndpointId": "string",
"reason": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
conferenceIdstringtruenoneSupply the conferenceId. Mandatory.
userEndpointIdstringtruenoneSupply the user endpoint id. Mandatory.
reasonstringfalsenoneSupply a reason for leaving. Optional.

JoinConferenceWebCommand

{
"conferenceId": "string",
"userEndpointId": "string",
"metadata": {
"property1": {},
"property2": {}
}
}

Properties

NameTypeRequiredRestrictionsDescription
conferenceIdstringtruenoneSupply the conferenceId to join. Mandatory.
userEndpointIdstringtruenoneSupply the userEndpointId of the user that wants to join. Mandatory.
metadataobjectfalsenoneSupply the metadata of the user.
» additionalPropertiesobjectfalsenoneSupply the metadata of the user.

ConferenceSummary

{
"id": "string",
"version": 0,
"mode": "P2P"
}

Properties

NameTypeRequiredRestrictionsDescription
idstringfalsenonenone
versioninteger(int64)falsenonenone
modestringfalsenonenone
Enumerated Values
PropertyValue
modeP2P
modeROUTER
modeUNKNOWN

AnotherErrorResponse

{
"error": "string",
"error_description": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
errorstringfalsenonenone
error_descriptionstringfalsenonenone

SetInteractionIdWebCommand

{
"conferenceId": "string",
"interactionId": "string",
"userEndpointId": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
conferenceIdstringtruenonenone
interactionIdstringtruenonenone
userEndpointIdstringfalsenonenone

EndConferenceWebCommand

{
"conferenceId": "string",
"userEndpointId": "string",
"reason": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
conferenceIdstringtruenoneSupply the conferenceId. Mandatory.
userEndpointIdstringtruenoneSupply the user endpoint id. Mandatory.
reasonstringfalsenoneSupply a reason for leaving. Optional.

CreateConferenceWebCommand

{
"conferenceId": "string",
"mode": "P2P",
"organizationId": "string",
"creatorEndpoint": "string",
"interactionId": "string",
"metadata": {
"property1": "string",
"property2": "string"
}
}

Properties

NameTypeRequiredRestrictionsDescription
conferenceIdstringfalsenoneSupply the conferenceId. Take care so this value is unique, otherwise better leave this empty and let the server produce one. Optional.
modestringfalsenoneSupply the conference mode. Currently only ROUTER is supported. Optional.
organizationIdstringfalsenoneorganization id, for internal use only
creatorEndpointstringfalsenoneSupply the creator user endpoint id. Optional.
interactionIdstringfalsenoneInteraction id related to this conference
metadataobjectfalsenoneSupply conference metadata. Optional.
» additionalPropertiesstringfalsenoneSupply conference metadata. Optional.
Enumerated Values
PropertyValue
modeP2P
modeROUTER
modeUNKNOWN

ConferenceViewStreamIceCandidatesWebCommand

{
"conferenceId": "string",
"userEndpointId": "string",
"streamId": "string",
"viewerId": "string",
"iceCandidates": [
{
"candidate": "string",
"sdpMid": "string",
"sdpMLineIndex": 0
}
]
}

Properties

NameTypeRequiredRestrictionsDescription
conferenceIdstringtruenoneSupply the conferenceId. Mandatory.
userEndpointIdstringtruenoneSupply the user endpoint id. Mandatory.
streamIdstringtruenoneSupply the viewing stream id. Mandatory.
viewerIdstringtruenoneSupply the viewer id. Mandatory.
iceCandidates[IceCandidate]truenoneSupply the ice candidates found so far. Mandatory.

IceCandidate

{
"candidate": "string",
"sdpMid": "string",
"sdpMLineIndex": 0
}

Supply the ice candidates found so far. Mandatory.

Properties

NameTypeRequiredRestrictionsDescription
candidatestringfalsenonenone
sdpMidstringfalsenonenone
sdpMLineIndexinteger(int32)falsenonenone

ConferencePublishStreamIceCandidatesWebCommand

{
"conferenceId": "string",
"userEndpointId": "string",
"streamId": "string",
"iceCandidates": [
{
"candidate": "string",
"sdpMid": "string",
"sdpMLineIndex": 0
}
]
}

Properties

NameTypeRequiredRestrictionsDescription
conferenceIdstringtruenoneSupply the conferenceId. Mandatory.
userEndpointIdstringtruenoneSupply the user endpoint id. Mandatory.
streamIdstringtruenoneSupply the published stream id. Mandatory.
iceCandidates[IceCandidate]truenoneSupply the ice candidates found so far. Mandatory.

Snapshot

{
"id": "string",
"relatedSnapshotId": "string",
"organizationId": "string",
"applicationId": "string",
"requesterUserId": "string",
"requesterUserEndpointId": "string",
"userId": "string",
"userEndpointId": "string",
"sessionType": "UNKNOWN",
"sessionId": "string",
"timestamp": "2019-08-24T14:15:22Z",
"interactionId": "string",
"type": "string",
"path": "string",
"state": "UPLOADED",
"requestProcessingResult": {
"snapshotId": "string"
},
"approvalProcessingResult": {
"succeeded": true,
"additionalInformation": "string"
},
"suffix": "string",
"mimeType": "string",
"createdAt": "2019-08-24T14:15:22Z",
"version": 0,
"approved": true
}

Properties

NameTypeRequiredRestrictionsDescription
idstringfalsenonenone
relatedSnapshotIdstringfalsenonenone
organizationIdstringfalsenonenone
applicationIdstringfalsenonenone
requesterUserIdstringfalsenonenone
requesterUserEndpointIdstringfalsenonenone
userIdstringfalsenonenone
userEndpointIdstringfalsenonenone
sessionTypestringfalsenonenone
sessionIdstringfalsenonenone
timestampstring(date-time)falsenonenone
interactionIdstringfalsenonenone
typestringfalsenonenone
pathstringfalsenonenone
statestringfalsenonenone
requestProcessingResultSnapshotRequestResultfalsenonenone
approvalProcessingResultSnapshotApprovalProcessingResultfalsenonenone
suffixstringfalsenonenone
mimeTypestringfalsenonenone
createdAtstring(date-time)falsenonenone
versioninteger(int64)falsenonenone
approvedbooleanfalsenonenone
Enumerated Values
PropertyValue
sessionTypeUNKNOWN
sessionTypeCALL
sessionTypeCONFERENCE
stateUPLOADED
stateAPPROVED
stateDISCARDED

SnapshotApprovalProcessingResult

{
"succeeded": true,
"additionalInformation": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
succeededbooleanfalsenonenone
additionalInformationstringfalsenonenone

Rating

{
"id": "string",
"userId": "string",
"userEndpointId": "string",
"organizationId": "string",
"interactionId": "string",
"sessionType": "UNKNOWN",
"sessionId": "string",
"score": 0,
"comment": "string",
"createdAt": "2019-08-24T14:15:22Z"
}

Properties

NameTypeRequiredRestrictionsDescription
idstringfalsenonerating id
userIdstringfalsenonethe user who created this rating
userEndpointIdstringfalsenonethe user endpoint from which the user created this rating
organizationIdstringfalsenonerelated organization id
interactionIdstringfalsenonerelated interaction id
sessionTypestringfalsenonekind of session, CALL or CONFERENCE
sessionIdstringfalsenonethe call or conference id related with this rating
scoreinteger(int32)falsenonethe rating the user gave, scale is 1-5, 1 meaning bad and 5 perfect
commentstringfalsenoneany comment the user gave
createdAtstring(date-time)falsenonenone
Enumerated Values
PropertyValue
sessionTypeUNKNOWN
sessionTypeCALL
sessionTypeCONFERENCE

Pageable

{
"page": 0,
"size": 1,
"sort": [
"string"
]
}

Properties

NameTypeRequiredRestrictionsDescription
pageinteger(int32)falsenonenone
sizeinteger(int32)falsenonenone
sort[string]falsenonenone

Interaction

{
"id": "string",
"organizationId": "string",
"createdBy": "string",
"createdAt": "2019-08-24T14:15:22Z",
"type": "string",
"data": {
"property1": {},
"property2": {}
},
"version": 0
}

Properties

NameTypeRequiredRestrictionsDescription
idstringfalsenonenone
organizationIdstringfalsenonenone
createdBystringfalsenonenone
createdAtstring(date-time)falsenonenone
typestringfalsenonenone
dataobjectfalsenonenone
» interaction dataobjectfalsenonenone
versioninteger(int64)falsenonenone

PageInteraction

{
"totalPages": 0,
"totalElements": 0,
"size": 0,
"content": [
{
"id": "string",
"organizationId": "string",
"createdBy": "string",
"createdAt": "2019-08-24T14:15:22Z",
"type": "string",
"data": {
"property1": {},
"property2": {}
},
"version": 0
}
],
"number": 0,
"sort": [
{
"direction": "string",
"nullHandling": "string",
"ascending": true,
"property": "string",
"ignoreCase": true
}
],
"first": true,
"last": true,
"numberOfElements": 0,
"pageable": {
"offset": 0,
"sort": [
{
"direction": "string",
"nullHandling": "string",
"ascending": true,
"property": "string",
"ignoreCase": true
}
],
"pageSize": 0,
"paged": true,
"pageNumber": 0,
"unpaged": true
},
"empty": true
}

Properties

NameTypeRequiredRestrictionsDescription
totalPagesinteger(int32)falsenonenone
totalElementsinteger(int64)falsenonenone
sizeinteger(int32)falsenonenone
content[Interaction]falsenonenone
numberinteger(int32)falsenonenone
sort[SortObject]falsenonenone
firstbooleanfalsenonenone
lastbooleanfalsenonenone
numberOfElementsinteger(int32)falsenonenone
pageablePageableObjectfalsenonenone
emptybooleanfalsenonenone

PageableObject

{
"offset": 0,
"sort": [
{
"direction": "string",
"nullHandling": "string",
"ascending": true,
"property": "string",
"ignoreCase": true
}
],
"pageSize": 0,
"paged": true,
"pageNumber": 0,
"unpaged": true
}

Properties

NameTypeRequiredRestrictionsDescription
offsetinteger(int64)falsenonenone
sort[SortObject]falsenonenone
pageSizeinteger(int32)falsenonenone
pagedbooleanfalsenonenone
pageNumberinteger(int32)falsenonenone
unpagedbooleanfalsenonenone

SortObject

{
"direction": "string",
"nullHandling": "string",
"ascending": true,
"property": "string",
"ignoreCase": true
}

Properties

NameTypeRequiredRestrictionsDescription
directionstringfalsenonenone
nullHandlingstringfalsenonenone
ascendingbooleanfalsenonenone
propertystringfalsenonenone
ignoreCasebooleanfalsenonenone

IceServer

{
"urls": [
"string"
],
"username": "string",
"credential": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
urls[string]falsenonenone
usernamestringfalsenonenone
credentialstringfalsenonenone

IceServersResult

{
"iceServers": [
{
"urls": [
"string"
],
"username": "string",
"credential": "string"
}
],
"ttl": 0
}

Properties

NameTypeRequiredRestrictionsDescription
iceServers[IceServer]falsenonenone
ttlinteger(int32)falsenonenone

IceServersResultV2

{
"stun": "string",
"turn": "string",
"turnUsername": "string",
"turnPassword": "string",
"ttl": 0
}

Properties

NameTypeRequiredRestrictionsDescription
stunstringfalsenonenone
turnstringfalsenonenone
turnUsernamestringfalsenonenone
turnPasswordstringfalsenonenone
ttlinteger(int32)falsenonenone

Conference

{
"id": "string",
"mode": "P2P",
"organizationId": "string",
"interactionId": "string",
"creator": "string",
"creatorEndpoint": "string",
"participants": [
{
"id": "string",
"userId": "string",
"state": "HEALTHY",
"streams": [
{
"id": "string",
"type": "MIC",
"metadata": {
"property1": {},
"property2": {}
},
"videoBitrate": 0
}
],
"metadata": {
"property1": {},
"property2": {}
}
}
],
"metadata": {
"property1": {
"value": "string",
"userId": "string",
"userEndpointId": "string",
"lastModified": "2019-08-24T14:15:22Z"
},
"property2": {
"value": "string",
"userId": "string",
"userEndpointId": "string",
"lastModified": "2019-08-24T14:15:22Z"
}
},
"version": 0,
"empty": true
}

Properties

NameTypeRequiredRestrictionsDescription
idstringfalsenonenone
modestringfalsenonenone
organizationIdstringfalsenonenone
interactionIdstringfalsenonenone
creatorstringfalsenonenone
creatorEndpointstringfalsenonenone
participants[ConferenceParticipant]falsenonenone
metadataobjectfalsenonenone
» additionalPropertiesMetadatafalsenonenone
versioninteger(int64)falsenonenone
emptybooleanfalsenonenone
Enumerated Values
PropertyValue
modeP2P
modeROUTER
modeUNKNOWN

ConferenceParticipant

{
"id": "string",
"userId": "string",
"state": "HEALTHY",
"streams": [
{
"id": "string",
"type": "MIC",
"metadata": {
"property1": {},
"property2": {}
},
"videoBitrate": 0
}
],
"metadata": {
"property1": {},
"property2": {}
}
}

Properties

NameTypeRequiredRestrictionsDescription
idstringfalsenonenone
userIdstringfalsenonenone
statestringfalsenonenone
streams[ConferenceStream]falsenonenone
metadataobjectfalsenonenone
» additionalPropertiesobjectfalsenonenone
Enumerated Values
PropertyValue
stateHEALTHY
stateSICK
stateUNKNOWN

ConferenceStream

{
"id": "string",
"type": "MIC",
"metadata": {
"property1": {},
"property2": {}
},
"videoBitrate": 0
}

Properties

NameTypeRequiredRestrictionsDescription
idstringfalsenonenone
typestringfalsenonenone
metadataobjectfalsenonenone
» additionalPropertiesobjectfalsenonenone
videoBitrateinteger(int32)falsenonenone
Enumerated Values
PropertyValue
typeMIC
typeCAM
typeSCREEN
typeMIC_AND_CAM
typeUNKNOWN

Metadata

{
"value": "string",
"userId": "string",
"userEndpointId": "string",
"lastModified": "2019-08-24T14:15:22Z"
}

Properties

NameTypeRequiredRestrictionsDescription
valuestringfalsenonenone
userIdstringfalsenonenone
userEndpointIdstringfalsenonenone
lastModifiedstring(date-time)falsenonenone

ConferenceSimpleView

{
"id": "string",
"mode": "string",
"metadata": {
"property1": {
"value": "string",
"userId": "string",
"userEndpointId": "string",
"lastModified": "2019-08-24T14:15:22Z"
},
"property2": {
"value": "string",
"userId": "string",
"userEndpointId": "string",
"lastModified": "2019-08-24T14:15:22Z"
}
},
"participants": [
{
"id": "string",
"endpoints": [
{
"id": "string",
"state": "HEALTHY",
"streams": [
{
"id": "string",
"type": "string",
"metadata": {
"property1": {},
"property2": {}
}
}
],
"metadata": {
"property1": {},
"property2": {}
}
}
]
}
],
"version": 0
}

Properties

NameTypeRequiredRestrictionsDescription
idstringfalsenonenone
modestringfalsenonenone
metadataobjectfalsenonenone
» additionalPropertiesMetadatafalsenonenone
participants[ConferenceSimpleViewParticipant]falsenonenone
versioninteger(int64)falsenonenone

ConferenceSimpleViewParticipant

{
"id": "string",
"endpoints": [
{
"id": "string",
"state": "HEALTHY",
"streams": [
{
"id": "string",
"type": "string",
"metadata": {
"property1": {},
"property2": {}
}
}
],
"metadata": {
"property1": {},
"property2": {}
}
}
]
}

Properties

NameTypeRequiredRestrictionsDescription
idstringfalsenonenone
endpoints[ConferenceSimpleViewParticipantEndpoint]falsenonenone

ConferenceSimpleViewParticipantEndpoint

{
"id": "string",
"state": "HEALTHY",
"streams": [
{
"id": "string",
"type": "string",
"metadata": {
"property1": {},
"property2": {}
}
}
],
"metadata": {
"property1": {},
"property2": {}
}
}

Properties

NameTypeRequiredRestrictionsDescription
idstringfalsenonenone
statestringfalsenonenone
streams[ConferenceSimpleViewParticipantEndpointStream]falsenonenone
metadataobjectfalsenonenone
» additionalPropertiesobjectfalsenonenone
Enumerated Values
PropertyValue
stateHEALTHY
stateSICK
stateUNKNOWN

ConferenceSimpleViewParticipantEndpointStream

{
"id": "string",
"type": "string",
"metadata": {
"property1": {},
"property2": {}
}
}

Properties

NameTypeRequiredRestrictionsDescription
idstringfalsenonenone
typestringfalsenonenone
metadataobjectfalsenonenone
» additionalPropertiesobjectfalsenonenone

ConferenceEvent

{
"id": "string",
"type": "string",
"timestamp": "2019-08-24T14:15:22Z",
"conferenceId": "string",
"organizationId": "string",
"conferenceVersion": 0
}

Properties

NameTypeRequiredRestrictionsDescription
idstringfalsenoneevent unique id
typestringfalsenoneevent type
timestampstring(date-time)falsenoneevent time, format is "yyyy-MM-dd'T'HH:mm:ss.SSS'Z'"
conferenceIdstringfalsenonethe conference which this event belongs to
organizationIdstringfalsenonethe organizationId
conferenceVersioninteger(int64)falsenonethe conference version this event was produced- can be used for ordering and or deduplication. It contains the version of the conference when the event was generated or null for creation events