Skip to main content

Auvious Auth Server API v1.8.8-beta.1.unchecked

Auvious Auth Server provides the core security related services.

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

Tickets

Get a ticket.

GET http://auvious.video/security/ticket/{ticketId} HTTP/1.1
Host: auvious.video
Accept: */*

Get a ticket.

Parameters

ParameterInTypeRequiredDescription
ticketIdpathstringtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKTicket
400Bad RequestBad RequestInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline
Response Schema
Examples

200 Response

400 Response

"{\"error\": \"description\"}"
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://auvious.video/security/ticket/{ticketId} \
-H 'Accept: */*' \ -H 'Authorization: Bearer {access-token}'

Update a ticket

PUT http://auvious.video/security/ticket/{ticketId} HTTP/1.1
Host: auvious.video
Content-Type: application/json
Accept: */*

Update a ticket with new properties. The ticket will be modified according to the provided properties.

Request body

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

Parameters

ParameterInTypeRequiredDescription
ticketIdpathstringtruenone
bodybodyUpdateTicketWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKTicket
400Bad RequestBad RequestInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline
Response Schema
Examples

200 Response

400 Response

"{\"error\": \"description\"}"
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://auvious.video/security/ticket/{ticketId} \
-H 'Content-Type: application/json' \ -H 'Accept: */*' \ -H 'Authorization: Bearer {access-token}'

Delete a ticket.

DELETE http://auvious.video/security/ticket/{ticketId} HTTP/1.1
Host: auvious.video
Accept: application/json

Delete a ticket. Optional operation, use it to delete a token early, before it's used or expired

Parameters

ParameterInTypeRequiredDescription
ticketIdpathstringtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKNone
400Bad RequestBad RequestInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline
Response Schema
Examples

400 Response

"{\"error\": \"description\"}"
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://auvious.video/security/ticket/{ticketId} \
-H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Create a ticket

POST http://auvious.video/security/ticket HTTP/1.1
Host: auvious.video
Content-Type: application/json
Accept: */*

Create a new ticket. It defines what will be the username and to which conference the user will have access to. The ticket will be deleted once it's used once to obtain a token

Request body

{
"type": "GENESYS_SINGLE_USE_TICKET",
"organizationId": "string",
"properties": {
"property1": {},
"property2": {}
},
"length": 6,
"disabled": true
}

Parameters

ParameterInTypeRequiredDescription
bodybodyCreateTicketWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKTicket
400Bad RequestBad RequestInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline
Response Schema
Examples

200 Response

400 Response

"{\"error\": \"description\"}"
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://auvious.video/security/ticket \
-H 'Content-Type: application/json' \ -H 'Accept: */*' \ -H 'Authorization: Bearer {access-token}'

Revoke a ticket

POST http://auvious.video/security/ticket/{ticketId}/revoke HTTP/1.1
Host: auvious.video
Accept: application/json

Revoke a ticket. If someone tries to use this ticket he will get 'error_description'='REVOKED'

Parameters

ParameterInTypeRequiredDescription
ticketIdpathstringtruenone

Responses

Overview
StatusMeaningDescriptionSchema
204No ContentNo ContentNone
400Bad RequestBad RequestInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline
Response Schema
Examples

400 Response

"{\"error\": \"description\"}"
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://auvious.video/security/ticket/{ticketId}/revoke \
-H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Enable a ticket

POST http://auvious.video/security/ticket/{ticketId}/enable HTTP/1.1
Host: auvious.video
Accept: application/json

Enable a ticket.

Parameters

ParameterInTypeRequiredDescription
ticketIdpathstringtruenone

Responses

Overview
StatusMeaningDescriptionSchema
204No ContentNo ContentNone
400Bad RequestBad RequestInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline
Response Schema
Examples

400 Response

"{\"error\": \"description\"}"
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://auvious.video/security/ticket/{ticketId}/enable \
-H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Disable a ticket

POST http://auvious.video/security/ticket/{ticketId}/disable HTTP/1.1
Host: auvious.video
Accept: application/json

Disable a ticket. If someone tries to use this ticket he will get 'error_description'='DISABLED'

Parameters

ParameterInTypeRequiredDescription
ticketIdpathstringtruenone

Responses

Overview
StatusMeaningDescriptionSchema
204No ContentNo ContentNone
400Bad RequestBad RequestInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline
Response Schema
Examples

400 Response

"{\"error\": \"description\"}"
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://auvious.video/security/ticket/{ticketId}/disable \
-H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Add to calendar

GET http://auvious.video/security/ticket/{ticketId}/event HTTP/1.1
Host: auvious.video
Accept: text/calendar
X-Forwarded-Proto: https
Host: string

Add to calendar

Parameters

ParameterInTypeRequiredDescription
ticketIdpathstringtruenone
calendarquerystringfalsenone
X-Forwarded-Protoheaderstringfalsenone
Hostheaderstringtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKstring
400Bad RequestBad RequestInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline
Response Schema
Examples

200 Response

400 Response

"{\"error\": \"description\"}"
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://auvious.video/security/ticket/{ticketId}/event \
-H 'Accept: text/calendar' \ -H 'X-Forwarded-Proto: https' \ -H 'Host: string' \ -H 'Authorization: Bearer {access-token}'

Clients

Update a client

PUT http://auvious.video/security/clients/{clientId} HTTP/1.1
Host: auvious.video
Content-Type: application/json
Accept: application/json

Use this to update description and/or roles of a new client

Request body

{
"description": "string",
"roles": [
"string"
]
}

Parameters

ParameterInTypeRequiredDescription
clientIdpathClientIdtruenone
bodybodyUpdateClientWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKClientResponseValue
400Bad RequestBad RequestInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline
Response Schema
Examples

200 Response

{
"clientId": "string",
"clientSecret": "string",
"description": "string",
"roles": [
"string"
]
}
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://auvious.video/security/clients/{clientId} \
-H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Delete client of user organization

DELETE http://auvious.video/security/clients/{clientId} HTTP/1.1
Host: auvious.video
Accept: application/json

Use this to delete a client for your organization

Parameters

ParameterInTypeRequiredDescription
clientIdpathClientIdtruenone

Responses

Overview
StatusMeaningDescriptionSchema
204No ContentNo ContentNone
400Bad RequestBad RequestInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline
Response Schema
Examples

400 Response

"{\"error\": \"description\"}"
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://auvious.video/security/clients/{clientId} \
-H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

List clients of user organization

GET http://auvious.video/security/clients HTTP/1.1
Host: auvious.video
Accept: application/json

Use this to retrieve all clients for your organization

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKInline
400Bad RequestBad RequestInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline
Response Schema

Status Code 200

NameTypeRequiredRestrictionsDescription
anonymous[ClientResponseValue]falsenonenone
» clientIdstringfalsenonenone
» clientSecretstringfalsenonenone
» descriptionstringfalsenonenone
» roles[string]falsenonenone
Examples

200 Response

[
{
"clientId": "string",
"clientSecret": "string",
"description": "string",
"roles": [
"string"
]
}
]
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://auvious.video/security/clients \
-H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Create a client

POST http://auvious.video/security/clients HTTP/1.1
Host: auvious.video
Content-Type: application/json
Accept: application/json

Use this to create a new client

Request body

{
"description": "string",
"roles": [
"string"
]
}

Parameters

ParameterInTypeRequiredDescription
bodybodyCreateClientWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKClientResponseValue
400Bad RequestBad RequestInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline
Response Schema
Examples

200 Response

{
"clientId": "string",
"clientSecret": "string",
"description": "string",
"roles": [
"string"
]
}
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://auvious.video/security/clients \
-H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Rotate client secret

POST http://auvious.video/security/clients/{clientId}/rotate HTTP/1.1
Host: auvious.video
Accept: application/json

Use this to create new secret for client - USE WITH CAUTION

Parameters

ParameterInTypeRequiredDescription
clientIdpathClientIdtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKClientResponseValue
400Bad RequestBad RequestInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline
Response Schema
Examples

200 Response

{
"clientId": "string",
"clientSecret": "string",
"description": "string",
"roles": [
"string"
]
}
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://auvious.video/security/clients/{clientId}/rotate \
-H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Applications

Get Application.

GET http://auvious.video/security/applications/{id} HTTP/1.1
Host: auvious.video
Accept: application/json

Use this operation to get configuration. For type GENESYS apps, if you are an integration admin user you will have 'integrations:integration:view' permission which is what this method will check in order to return all configuration entries. Otherwise, if the user is a microservice it will get back only serviceParameters, if the user is a customer he will only get back customerParameters while if the user is a non-admin agent he will get only agentParameters back

Parameters

ParameterInTypeRequiredDescription
idpathstringtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKApplication
400Bad RequestBad RequestInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline
Response Schema
Examples

200 Response

{
"version": 0,
"id": "string",
"organizationId": "string",
"type": "GENESYS",
"config": {
"property1": {},
"property2": {}
},
"createdAt": "2019-08-24T14:15:22Z",
"visible": true,
"expiresAt": "2019-08-24T14:15:22Z"
}
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://auvious.video/security/applications/{id} \
-H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Update an application

PUT http://auvious.video/security/applications/{id} HTTP/1.1
Host: auvious.video
Content-Type: application/json
Accept: application/json

Use this operation to update an existing application. For GENESYS type applications you should include your organizationId and pcEnvironment values. This operation will be denied if the user doesn't have the 'integrations:integration:edit' permission.

Request body

{
"organizationId": "string",
"type": "GENESYS",
"config": {
"property1": {},
"property2": {}
}
}

Parameters

ParameterInTypeRequiredDescription
idpathstringtruenone
bodybodyUpdateApplicationWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
204No ContentUpdatedNone
400Bad RequestBad RequestInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline
Response Schema
Examples

400 Response

"{\"error\": \"description\"}"
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://auvious.video/security/applications/{id} \
-H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Delete application.

DELETE http://auvious.video/security/applications/{id} HTTP/1.1
Host: auvious.video
Accept: application/json

Use this if you want to delete an application. If the app is GENESYS type, the user must have the permission integrations:integration:delete permission, otherwise this call will fail.

Parameters

ParameterInTypeRequiredDescription
idpathstringtruenone

Responses

Overview
StatusMeaningDescriptionSchema
204No ContentNo ContentNone
400Bad RequestBad RequestInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline
Response Schema
Examples

400 Response

"{\"error\": \"description\"}"
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://auvious.video/security/applications/{id} \
-H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Get all available visible applications.

GET http://auvious.video/security/applications?pageable=page,0,size,1,sort,string HTTP/1.1
Host: auvious.video
Accept: application/json

Parameters

ParameterInTypeRequiredDescription
pageablequeryPageabletruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKInline
400Bad RequestBad RequestInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline
Response Schema

Status Code 200

NameTypeRequiredRestrictionsDescription
anonymous[Application]falsenonenone
» versioninteger(int64)falsenonenone
» idstringfalsenonenone
» organizationIdstringfalsenonenone
» typestringfalsenonenone
» configobjectfalsenonenone
»» additionalPropertiesobjectfalsenonenone
» createdAtstring(date-time)falsenonenone
» visiblebooleanfalsenonenone
» expiresAtstring(date-time)falsenonenone
Enumerated Values
PropertyValue
typeGENESYS
typeSTANDALONE_OPENID
typeTALKDESK_OPENID
typeNICE_CXONE_OPENID
typeTEST
typeSETUP_TEST
Examples

200 Response

[
{
"version": 0,
"id": "string",
"organizationId": "string",
"type": "GENESYS",
"config": {
"property1": {},
"property2": {}
},
"createdAt": "2019-08-24T14:15:22Z",
"visible": true,
"expiresAt": "2019-08-24T14:15:22Z"
}
]
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://auvious.video/security/applications?pageable=page,0,size,1,sort,string \
-H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Create an application

POST http://auvious.video/security/applications HTTP/1.1
Host: auvious.video
Content-Type: application/json
Accept: application/json

Use this operation to create a new application. For GENESYS type applications you should include at least your 'organizationId' and 'pcEnvironment' entries in the 'config' otherwise creation will be denied. It is also recommended to include 'integrationId' entry. Again for GENESYS type applications, this operation will check that the user has integrations:integration:add permission. Once more, for GENESYS type apps, you should include your parameters in three main entries: serviceParameters, agentParameters and customerParameters. You can include other parameters, but they will be visible to all members of the same organization as well as internal auvious services. Internal Services can create any application.

Request body

{
"id": "string",
"organizationId": "string",
"type": "GENESYS",
"config": {
"property1": {},
"property2": {}
}
}

Parameters

ParameterInTypeRequiredDescription
bodybodyCreateApplicationWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKCreateApplicationResponseValue
400Bad RequestBad RequestInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline
Response Schema
Examples

200 Response

{
"id": "string"
}
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://auvious.video/security/applications \
-H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Talkdesk Service

Refresh a talkdesk access token.

POST http://auvious.video/security/talkdesk/refresh_token HTTP/1.1
Host: auvious.video
Content-Type: application/json
Accept: application/json

Refresh a Talkdesk access token. You need to provide a valid auvious bearer token in the Authorization header. The response will contain a new Talkdesk access token. The response is a typical oauth2 token response and is described at https://docs.talkdesk.com/reference/refresh-token-basic.

Request body

{
"refresh_token": "string"
}

Parameters

ParameterInTypeRequiredDescription
bodybodyTalkdeskRefreshTokenRequesttruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKstring
400Bad RequestBad RequestInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline
Response Schema
Examples

200 Response

"string"
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://auvious.video/security/talkdesk/refresh_token \
-H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Otp Verification Service

Request an otp

POST http://auvious.video/security/otp HTTP/1.1
Host: auvious.video
Content-Type: application/json
Accept: */*

Request a otp verification code. Returns an otp verification id which should be passed on calls that are protected with otp.

Request body

{
"to": "+306957206309",
"channel": "SMS",
"customName": "hello, world",
"locale": "en"
}

Parameters

ParameterInTypeRequiredDescription
bodybodyRequestOtpCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKOtpRequestResult
400Bad RequestBad RequestInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline
Response Schema
Examples

200 Response

400 Response

"{\"error\": \"description\"}"
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://auvious.video/security/otp \
-H 'Content-Type: application/json' \ -H 'Accept: */*' \ -H 'Authorization: Bearer {access-token}'

Verify an otp

POST http://auvious.video/security/otp/verify HTTP/1.1
Host: auvious.video
Content-Type: application/json
Accept: application/json

Verify an otp verification code.

Request body

{
"to": "+306957206309",
"code": "123456",
"verificationId": "1234567890"
}

Parameters

ParameterInTypeRequiredDescription
bodybodyVerifyOtpCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
204No ContentNo ContentNone
400Bad RequestBad RequestInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline
Response Schema
Examples

400 Response

"{\"error\": \"description\"}"
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://auvious.video/security/otp/verify \
-H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Nice Service

Refresh a nice access token.

POST http://auvious.video/security/nice/refresh_token HTTP/1.1
Host: auvious.video
Content-Type: application/json
Accept: application/json

Refresh a Nice CxOne access token. You need to provide a valid auvious bearer token in the Authorization header. The response will contain a new Nice access token and refresh token. The response is a typical oauth2 token response and is described at https://developer.niceincontact.com/Documentation/OpenIDConnectIntegration.

Request body

{
"refresh_token": "string"
}

Parameters

ParameterInTypeRequiredDescription
bodybodyNiceRefreshTokenRequesttruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKstring
400Bad RequestBad RequestInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline
Response Schema
Examples

200 Response

"string"
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://auvious.video/security/nice/refresh_token \
-H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Keys

Create a key

POST http://auvious.video/security/keys HTTP/1.1
Host: auvious.video
Content-Type: application/json
Accept: application/json

Use this to create a new key

Request body

{
"type": "SSH_RSA",
"organizationId": "string",
"privateKey": "string",
"publicKey": "string",
"key": "string",
"comment": "string"
}

Parameters

ParameterInTypeRequiredDescription
bodybodyCreateKeyWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKCreateKeyResult
400Bad RequestBad RequestInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline
Response Schema
Examples

200 Response

{
"id": "string",
"publicKey": "string",
"key": "string"
}
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://auvious.video/security/keys \
-H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Retrieve a key

GET http://auvious.video/security/keys/{id} HTTP/1.1
Host: auvious.video
Accept: application/json

Use this to retrieve a key, only services and admins are allowed, but private parts are hidden if not a service

Parameters

ParameterInTypeRequiredDescription
idpathstringtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKKey
400Bad RequestBad RequestInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline
Response Schema
Examples

200 Response

{
"id": "string",
"userId": "string",
"organizationId": "string",
"type": "SSH_RSA",
"keySize": 0,
"privateKey": "string",
"publicKey": "string",
"key": "string",
"comment": "string",
"createdAt": "2019-08-24T14:15:22Z"
}
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://auvious.video/security/keys/{id} \
-H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Facades Service

Create room,ticket and return ticket and agent urls

POST http://auvious.video/security/facades/room HTTP/1.1
Host: auvious.video
Content-Type: application/json
Accept: application/json

Create a new room, ticket and return the urls. Allowed from trusted clients that have authenticated using client credentials. Ticket url expires by default after 4 hours.

Request body

{
"organizationId": "string",
"applicationId": "string",
"urlBase": "string",
"customerId": "string",
"interactionId": "string",
"cdestination": "mobile-office, interaction-widget, standalone, embedded, premise, callback",
"ticketExpirationSeconds": 0,
"ticketLength": 0
}

Parameters

ParameterInTypeRequiredDescription
bodybodyCreateRoomWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKCreateRoomResult
400Bad RequestBad RequestInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline
Response Schema
Examples

200 Response

{
"agentUrl": "string",
"ticketUrl": "string",
"recordingUrl": "string"
}
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://auvious.video/security/facades/room \
-H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Create a genesys callback (schedule)

POST http://auvious.video/security/facades/callback HTTP/1.1
Host: auvious.video
Content-Type: application/json
Accept: */*
X-OtpVerificationId: string
X-OtpCode: string
X-ApplicationId: string
X-UrlBase: string
X-Ticket-Expiration-Seconds: 0

Create a new genesys callback. Allowed with a valid otp code,verification id, or with client credentials. For request body schema check https://developer.genesys.cloud/api/rest/v2/conversations/#postConversationsCallbacks, with queueName added for convenience.

Request body

{
"scriptId": "string",
"queueId": "string",
"queueName": "string",
"routingData": {
"queueId": "string",
"queueName": "string",
"languageId": "string",
"priority": 0,
"skillIds": [
"string"
],
"preferredAgentIds": [
"string"
]
},
"callbackUserName": "string",
"callbackNumbers": [
"string"
],
"callbackScheduledTime": "string",
"countryCode": "string",
"validateCallbackNumbers": true,
"data": {
"property1": "string",
"property2": "string"
}
}

Parameters

ParameterInTypeRequiredDescription
X-OtpVerificationIdheaderstringfalseonly for otp authentication
X-OtpCodeheaderstringfalseonly for otp authentication
X-ApplicationIdheaderstringtruemandatory, can be found at application settings page
X-UrlBaseheaderstringfalsemandatory when using client credentials, e.g. https://auvious.video
X-Ticket-Expiration-Secondsheaderinteger(int32)falseexpiration seconds for ticket url (since the scheduled time). 4 hours (14400) is the default
bodybodyCreateGenesysCallbackCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKCallbackResult
400Bad RequestBad RequestInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline
Response Schema
Examples

200 Response

400 Response

"{\"error\": \"description\"}"
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://auvious.video/security/facades/callback \
-H 'Content-Type: application/json' \ -H 'Accept: */*' \ -H 'X-OtpVerificationId: string' \ -H 'X-OtpCode: string' \ -H 'X-ApplicationId: string' \ -H 'X-UrlBase: string' \ -H 'X-Ticket-Expiration-Seconds: 0' \ -H 'Authorization: Bearer {access-token}'

Users

Find user

GET http://auvious.video/security/users/{userId} HTTP/1.1
Host: auvious.video
Accept: application/json

Use this to retrieve user by id (only allowed from internal services)

Parameters

ParameterInTypeRequiredDescription
userIdpathstringtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKUser
400Bad RequestBad RequestInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline
Response Schema
Examples

200 Response

{
"id": "string",
"password": "string",
"expiresAt": "2019-08-24T14:15:22Z",
"locked": true,
"credentialsExpireAt": "2019-08-24T14:15:22Z",
"disabled": true,
"roles": [
"string"
],
"createdAt": "2019-08-24T14:15:22Z",
"lastSeenAt": "2019-08-24T14:15:22Z",
"personalDataEntityId": "string",
"version": 0,
"enabled": true,
"authorities": [
{
"authority": "string"
}
],
"username": "string",
"accountNonExpired": true,
"accountNonLocked": true,
"credentialsNonExpired": true
}
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://auvious.video/security/users/{userId} \
-H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Schemas

UpdateTicketWebCommand

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

Properties

NameTypeRequiredRestrictionsDescription
organizationIdstringfalsenonenone
propertiesobjecttruenonenone
» additionalPropertiesobjectfalsenonenone

Ticket

{
"id": "string",
"userId": "string",
"organizationId": "string",
"type": "GENESYS_SINGLE_USE_TICKET",
"properties": {
"property1": {},
"property2": {}
},
"disabled": "2019-08-24T14:15:22Z",
"revoked": "2019-08-24T14:15:22Z",
"createdAt": "2019-08-24T14:15:22Z",
"expiresAt": "2019-08-24T14:15:22Z",
"version": 0,
"expired": true
}

Properties

NameTypeRequiredRestrictionsDescription
idstringfalsenonenone
userIdstringfalsenonenone
organizationIdstringfalsenonenone
typestringfalsenonenone
propertiesobjectfalsenonenone
» additionalPropertiesobjectfalsenonenone
disabledstring(date-time)falsenonenone
revokedstring(date-time)falsenonenone
createdAtstring(date-time)falsenonenone
expiresAtstring(date-time)falsenonenone
versioninteger(int64)falsenonenone
expiredbooleanfalsenonenone
Enumerated Values
PropertyValue
typeGENESYS_SINGLE_USE_TICKET
typeGENESYS_MULTI_USE_TICKET
typeGENESYS_SCHEDULE_TICKET
typeMULTI_USE_TICKET
typeSCHEDULE_TICKET
typeAPPOINTMENTS_SCHEDULE_TICKET
typeSINGLE_USE_TICKET
typeSINGLE_USE_SCHEDULE_TICKET
typeSINGLE_USE_APPOINTMENTS_SCHEDULE_TICKET

UpdateClientWebCommand

{
"description": "string",
"roles": [
"string"
]
}

Properties

NameTypeRequiredRestrictionsDescription
descriptionstringfalsenonenew client description text (Optional - if not provided old one will remain).
roles[string]falsenonenew client roles (Optional - if not provided old ones will remain). Valid values are: ClientService, Agent, Supervisor, Admin

ClientId

{
"id": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
idstringfalsenonenone

ClientResponseValue

{
"clientId": "string",
"clientSecret": "string",
"description": "string",
"roles": [
"string"
]
}

Properties

NameTypeRequiredRestrictionsDescription
clientIdstringfalsenonenone
clientSecretstringfalsenonenone
descriptionstringfalsenonenone
roles[string]falsenonenone

UpdateApplicationWebCommand

{
"organizationId": "string",
"type": "GENESYS",
"config": {
"property1": {},
"property2": {}
}
}

Properties

NameTypeRequiredRestrictionsDescription
organizationIdstringfalsenoneonly for access from internal service
typestringtruenonenone
configobjecttruenoneThe application configuration object. For GENESYS apps, serviceParameters will be shown only to service accounts and admins, agentParameters will only be shown to agents and customerParameters will be shown only to customers
» additionalPropertiesobjectfalsenoneThe application configuration object. For GENESYS apps, serviceParameters will be shown only to service accounts and admins, agentParameters will only be shown to agents and customerParameters will be shown only to customers
Enumerated Values
PropertyValue
typeGENESYS
typeSTANDALONE_OPENID
typeTALKDESK_OPENID
typeNICE_CXONE_OPENID
typeTEST
typeSETUP_TEST

CreateTicketWebCommand

{
"type": "GENESYS_SINGLE_USE_TICKET",
"organizationId": "string",
"properties": {
"property1": {},
"property2": {}
},
"length": 6,
"disabled": true
}

Properties

NameTypeRequiredRestrictionsDescription
typestringtruenonenone
organizationIdstringfalsenonenone
propertiesobjecttruenonenone
» additionalPropertiesobjectfalsenonenone
lengthinteger(int32)falsenonenone
disabledbooleanfalsenonenone
Enumerated Values
PropertyValue
typeGENESYS_SINGLE_USE_TICKET
typeGENESYS_MULTI_USE_TICKET
typeGENESYS_SCHEDULE_TICKET
typeMULTI_USE_TICKET
typeSCHEDULE_TICKET
typeAPPOINTMENTS_SCHEDULE_TICKET
typeSINGLE_USE_TICKET
typeSINGLE_USE_SCHEDULE_TICKET
typeSINGLE_USE_APPOINTMENTS_SCHEDULE_TICKET

TalkdeskRefreshTokenRequest

{
"refresh_token": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
refresh_tokenstringfalsenonenone

RequestOtpCommand

{
"to": "+306957206309",
"channel": "SMS",
"customName": "hello, world",
"locale": "en"
}

Request OTP command

Properties

NameTypeRequiredRestrictionsDescription
tostringtruenoneWhere to?
channelstringfalsenoneChannel to use
customNamestringfalsenonecustom name to use instead of default
localestringfalsenonelocale to use
Enumerated Values
PropertyValue
toany phone number, or email if supported
channelUNKNOWN
channelSMS
channelVOICE
channelEMAIL
channelSMS
customNameany string, but keep it short
localeaf, ar, ca, cs, da, de, el, en, en-GB, es, fi, fr, he, hi, hr, hu, id, it, ja, ko, ms, nb, nl, pl, pt, pr-BR, ro, ru, sv, th, tl, tr, vi, zh, zh-CN, or zh-HK.

OtpRequestResult

{
"id": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
idstringfalsenonenone

VerifyOtpCommand

{
"to": "+306957206309",
"code": "123456",
"verificationId": "1234567890"
}

Properties

NameTypeRequiredRestrictionsDescription
tostringtruenoneUser msisdn or email
codestringtruenoneThe otp code
verificationIdstringtruenoneVerification id
Enumerated Values
PropertyValue
toany phone number, or email if supported

NiceRefreshTokenRequest

{
"refresh_token": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
refresh_tokenstringfalsenonenone

CreateKeyWebCommand

{
"type": "SSH_RSA",
"organizationId": "string",
"privateKey": "string",
"publicKey": "string",
"key": "string",
"comment": "string"
}

create key web command model

Properties

NameTypeRequiredRestrictionsDescription
typestringtruenonekey type, mandatory
organizationIdstringfalsenoneorganizationId, optional, only supplied by internal services
privateKeystringfalsenoneprivate key, include at least this if you want to import a key
publicKeystringfalsenonepublic key, include this optionally if you want to import a key
keystringfalsenonekey include this if you want to import a symmetric type key
commentstringfalsenonekey comment, supply this to include more information about the key
Enumerated Values
PropertyValue
typeSSH_RSA

CreateKeyResult

{
"id": "string",
"publicKey": "string",
"key": "string"
}

Result of keypair create operation

Properties

NameTypeRequiredRestrictionsDescription
idstringfalsenonekeypair id
publicKeystringfalsenonepublic key for asymmetric keys
keystringfalsenonekey value, for symmetric keys

CreateRoomWebCommand

{
"organizationId": "string",
"applicationId": "string",
"urlBase": "string",
"customerId": "string",
"interactionId": "string",
"cdestination": "mobile-office, interaction-widget, standalone, embedded, premise, callback",
"ticketExpirationSeconds": 0,
"ticketLength": 0
}

Properties

NameTypeRequiredRestrictionsDescription
organizationIdstringfalsenoneonly for access from internal service
applicationIdstringtruenonewhich application to use
urlBasestringtruenonewhich url base to use, e.g. https://auvious.video
customerIdstringfalsenonecustomer id, e.g. interaction or conversation id
interactionIdstringfalsenoneconversation/interaction id
cdestinationstringfalsenone${swagger.api.facades.commands.create-room.notes}
ticketExpirationSecondsinteger(int32)falsenoneticket url expiration in seconds, 4 hours if not defined.
ticketLengthinteger(int32)falsenoneticket length override
Enumerated Values
PropertyValue
cdestinationmobile-office, interaction-widget, standalone, embedded, premise, callback

CreateRoomResult

{
"agentUrl": "string",
"ticketUrl": "string",
"recordingUrl": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
agentUrlstringfalsenonenone
ticketUrlstringfalsenonenone
recordingUrlstringfalsenonenone

CreateGenesysCallbackCommand

{
"scriptId": "string",
"queueId": "string",
"queueName": "string",
"routingData": {
"queueId": "string",
"queueName": "string",
"languageId": "string",
"priority": 0,
"skillIds": [
"string"
],
"preferredAgentIds": [
"string"
]
},
"callbackUserName": "string",
"callbackNumbers": [
"string"
],
"callbackScheduledTime": "string",
"countryCode": "string",
"validateCallbackNumbers": true,
"data": {
"property1": "string",
"property2": "string"
}
}

check https://developer.genesys.cloud/api/rest/v2/conversations/#postConversationsCallbacks

Properties

NameTypeRequiredRestrictionsDescription
scriptIdstringfalsenonenone
queueIdstringfalsenoneId of queue where the callback will take place. You can omit this and use queueName if you find it difficult to locate the queue id.
queueNamestringfalsenoneCan be used instead of queueId, which is more convenient
routingDataRoutingDatafalsenonenone
callbackUserNamestringtruenonename of customer, which will be displayed on the agent workspace
callbackNumbers[string]truenonephone number(s) of customer
callbackScheduledTimestringfalsenoneThe scheduled date-time for the callback as an ISO-8601 string yyyy-MM-ddTHH:mm:ss.SSSZ
countryCodestringfalsenonenone
validateCallbackNumbersbooleanfalsenonenone
dataobjectfalsenonenone
» additionalPropertiesstringfalsenonenone

RoutingData

{
"queueId": "string",
"queueName": "string",
"languageId": "string",
"priority": 0,
"skillIds": [
"string"
],
"preferredAgentIds": [
"string"
]
}

Properties

NameTypeRequiredRestrictionsDescription
queueIdstringfalsenonenone
queueNamestringfalsenonenone
languageIdstringfalsenonenone
priorityinteger(int32)falsenonenone
skillIds[string]falsenonenone
preferredAgentIds[string]falsenonenone

CallbackIndentifier

{
"type": "string",
"id": "string"
}

The list of communication identifiers for the callback participants.

Properties

NameTypeRequiredRestrictionsDescription
typestringfalsenoneThe type of the associated callback participant.Valid values: ACD, EXTERNAL.
idstringfalsenoneThe identifier of the callback.

CallbackResult

{
"conferenceId": "string",
"ticketId": "string",
"agentUrl": "string",
"ticketUrl": "string",
"genesys": {
"conversation": {
"id": "string",
"name": "string",
"selfUri": "string"
},
"callbackIdentifiers": [
{
"type": "string",
"id": "string"
}
]
}
}

Properties

NameTypeRequiredRestrictionsDescription
conferenceIdstringfalsenonethe id of the conference created
ticketIdstringfalsenonea ticket id which can be used to join the conference
agentUrlstringfalsenonea url for the agent to join
ticketUrlstringfalsenonea url for the customer to join
genesysGenesysCreateCallbackResponsefalsenoneGenesys create callback response

Conversation

{
"id": "string",
"name": "string",
"selfUri": "string"
}

The conversation associated with the callback

Properties

NameTypeRequiredRestrictionsDescription
idstringfalsenonenone
namestringfalsenonenone
selfUristringfalsenonenone

GenesysCreateCallbackResponse

{
"conversation": {
"id": "string",
"name": "string",
"selfUri": "string"
},
"callbackIdentifiers": [
{
"type": "string",
"id": "string"
}
]
}

Genesys create callback response

Properties

NameTypeRequiredRestrictionsDescription
conversationConversationfalsenoneThe conversation associated with the callback
callbackIdentifiers[CallbackIndentifier]falsenoneThe list of communication identifiers for the callback participants.

CreateClientWebCommand

{
"description": "string",
"roles": [
"string"
]
}

Properties

NameTypeRequiredRestrictionsDescription
descriptionstringfalsenoneclient description text
roles[string]falsenoneclient roles (Optional). Valid values are: ClientService, Agent, Supervisor, Admin

CreateApplicationWebCommand

{
"id": "string",
"organizationId": "string",
"type": "GENESYS",
"config": {
"property1": {},
"property2": {}
}
}

Properties

NameTypeRequiredRestrictionsDescription
idstringfalsenoneonly for access from internal service
organizationIdstringfalsenoneonly for access from internal service
typestringtruenonenone
configobjecttruenoneThe application configuration object. For GENESYS apps, serviceParameters will be shown only to service accounts and admins, agentParameters will only be shown to agents and customerParameters will be shown only to customers
» additionalPropertiesobjectfalsenoneThe application configuration object. For GENESYS apps, serviceParameters will be shown only to service accounts and admins, agentParameters will only be shown to agents and customerParameters will be shown only to customers
Enumerated Values
PropertyValue
typeGENESYS
typeSTANDALONE_OPENID
typeTALKDESK_OPENID
typeNICE_CXONE_OPENID
typeTEST
typeSETUP_TEST

CreateApplicationResponseValue

{
"id": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
idstringfalsenonenone

GrantedAuthority

{
"authority": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
authoritystringfalsenonenone

User

{
"id": "string",
"password": "string",
"expiresAt": "2019-08-24T14:15:22Z",
"locked": true,
"credentialsExpireAt": "2019-08-24T14:15:22Z",
"disabled": true,
"roles": [
"string"
],
"createdAt": "2019-08-24T14:15:22Z",
"lastSeenAt": "2019-08-24T14:15:22Z",
"personalDataEntityId": "string",
"version": 0,
"enabled": true,
"authorities": [
{
"authority": "string"
}
],
"username": "string",
"accountNonExpired": true,
"accountNonLocked": true,
"credentialsNonExpired": true
}

Properties

NameTypeRequiredRestrictionsDescription
idstringfalsenonenone
passwordstringfalsenonenone
expiresAtstring(date-time)falsenonenone
lockedbooleanfalsenonenone
credentialsExpireAtstring(date-time)falsenonenone
disabledbooleanfalsenonenone
roles[string]falsenonenone
createdAtstring(date-time)falsenonenone
lastSeenAtstring(date-time)falsenonenone
personalDataEntityIdstringfalsenonenone
versioninteger(int64)falsenonenone
enabledbooleanfalsenonenone
authorities[GrantedAuthority]falsenonenone
usernamestringfalsenonenone
accountNonExpiredbooleanfalsenonenone
accountNonLockedbooleanfalsenonenone
credentialsNonExpiredbooleanfalsenonenone

Key

{
"id": "string",
"userId": "string",
"organizationId": "string",
"type": "SSH_RSA",
"keySize": 0,
"privateKey": "string",
"publicKey": "string",
"key": "string",
"comment": "string",
"createdAt": "2019-08-24T14:15:22Z"
}

key entity

Properties

NameTypeRequiredRestrictionsDescription
idstringfalsenonekey reference id
userIdstringfalsenoneuser id of creator
organizationIdstringfalsenoneorganization id of creator
typestringfalsenonekey type
keySizeinteger(int32)falsenonekey size
privateKeystringfalsenoneprivate part of key, if assymetric type
publicKeystringfalsenonepublic part of key, if assymetric type
keystringfalsenonekey part for non assymetric keys
commentstringfalsenonekey comment
createdAtstring(date-time)falsenonecreation timestamp
Enumerated Values
PropertyValue
typeSSH_RSA

Pageable

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

Properties

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

Application

{
"version": 0,
"id": "string",
"organizationId": "string",
"type": "GENESYS",
"config": {
"property1": {},
"property2": {}
},
"createdAt": "2019-08-24T14:15:22Z",
"visible": true,
"expiresAt": "2019-08-24T14:15:22Z"
}

Properties

NameTypeRequiredRestrictionsDescription
versioninteger(int64)falsenonenone
idstringfalsenonenone
organizationIdstringfalsenonenone
typestringfalsenonenone
configobjectfalsenonenone
» additionalPropertiesobjectfalsenonenone
createdAtstring(date-time)falsenonenone
visiblebooleanfalsenonenone
expiresAtstring(date-time)falsenonenone
Enumerated Values
PropertyValue
typeGENESYS
typeSTANDALONE_OPENID
typeTALKDESK_OPENID
typeNICE_CXONE_OPENID
typeTEST
typeSETUP_TEST