Skip to main content

Cobrowse API v1.0.0

Cobrowse Api of the Fastify server in Nodejs.

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

  • HTTP Authentication, scheme: bearer

cobrowse

Events, Resume, Terminate a session

Resume session after sender has refreshed page

POST http://localhost:4444/cobrowser/api/session/resume HTTP/1.1
Host: localhost:4444
Content-Type: application/json
Accept: application/json

Request body

{
"type": "ReconnectCobrowsingSession",
"sessionId": "string",
"timestamp": "string",
"userId": "string",
"userEndpointId": "string",
"version": 0,
"payload": {
"previousId": "string",
"previousEndpointId": "string"
}
}

Parameters

ParameterInTypeRequiredDescription
bodybodyobjecttruenone
» typebodystringtruenone
» sessionIdbodystringfalsenone
» timestampbodystringtruenone
» userIdbodystringtruenone
» userEndpointIdbodystringtruenone
» versionbodyintegertruenone
» payloadbodyobjectfalsenone
»» previousIdbodystringtruenone
»» previousEndpointIdbodystringtruenone
Enumerated Values
ParameterValue
» typeReconnectCobrowsingSession
» typeResumeCobrowsingSession
» typeEnableCobrowsingOption
» typeDisableCobrowsingOption
» typeRequestCobrowsingView
» typeRequestCobrowsingControl
» typeTerminateCobrowsingSession
» typeAcceptCobrowsingView
» typeAcceptCobrowsingControl
» typeRevokeCobrowsingView
» typeRevokeCobrowsingControl
» typeDenyCobrowsingView
» typeDenyCobrowsingControl
» typeUpdateCobrowsingPage
» typeUpdateCobrowsingCursor
» typeUpdateCobrowsingInput
» typeCreateCobrowsingSession

Responses

Overview
StatusMeaningDescriptionSchema
200OKSession resumed, sender updatedInline
404Not FoundSesssion was not foundInline
Response Schema

Status Code 200

Session resumed, sender updated

NameTypeRequiredRestrictionsDescription
» statusstringtruenonenone
» versionintegertruenonenone
» remotesobjecttruenonenone
»» remoteEndpointIdsobjectfalsenonenone
»»» remoteIdstringfalsenonenone
»»» permissionsobjecttruenonenone
»»»» viewbooleanfalsenonenone
»»»» controlbooleanfalsenonenone
» optionsobjecttruenonenone
»» scrollobjectfalsenonenone
»»» enabledbooleanfalsenonenone

Status Code 404

Sesssion was not found

NameTypeRequiredRestrictionsDescription
Examples

200 Response

{
"status": "string",
"version": 0,
"remotes": {
"remoteEndpointIds": {
"remoteId": "string",
"permissions": {
"view": true,
"control": true
}
}
},
"options": {
"scroll": {
"enabled": true
}
}
}
caution

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

Code samples

curl -X POST http://localhost:4444/cobrowser/api/session/resume \
-H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Reconnect to a session

POST http://localhost:4444/cobrowser/api/session/reconnect HTTP/1.1
Host: localhost:4444
Content-Type: application/json
Accept: application/json

Request body

{
"type": "ReconnectCobrowsingSession",
"sessionId": "string",
"timestamp": "string",
"userId": "string",
"userEndpointId": "string",
"version": 0,
"payload": {
"previousId": "string",
"previousEndpointId": "string"
}
}

Parameters

ParameterInTypeRequiredDescription
bodybodyobjecttruenone
» typebodystringtruenone
» sessionIdbodystringfalsenone
» timestampbodystringtruenone
» userIdbodystringtruenone
» userEndpointIdbodystringtruenone
» versionbodyintegertruenone
» payloadbodyobjectfalsenone
»» previousIdbodystringtruenone
»» previousEndpointIdbodystringtruenone
Enumerated Values
ParameterValue
» typeReconnectCobrowsingSession
» typeResumeCobrowsingSession
» typeEnableCobrowsingOption
» typeDisableCobrowsingOption
» typeRequestCobrowsingView
» typeRequestCobrowsingControl
» typeTerminateCobrowsingSession
» typeAcceptCobrowsingView
» typeAcceptCobrowsingControl
» typeRevokeCobrowsingView
» typeRevokeCobrowsingControl
» typeDenyCobrowsingView
» typeDenyCobrowsingControl
» typeUpdateCobrowsingPage
» typeUpdateCobrowsingCursor
» typeUpdateCobrowsingInput
» typeCreateCobrowsingSession

Responses

Overview
StatusMeaningDescriptionSchema
200OKReconnected to sessionInline
403ForbiddenPermission deniedInline
404Not FoundSesssion was not foundInline
Response Schema

Status Code 200

Reconnected to session

NameTypeRequiredRestrictionsDescription
» statusstringtruenonenone
» versionintegertruenonenone
» ownerobjecttruenonenone
»» idstringfalsenonenone
»» endpointstringfalsenonenone
» remotesobjecttruenonenone
»» remoteEndpointIdsobjectfalsenonenone
»»» remoteIdstringfalsenonenone
»»» permissionsobjecttruenonenone
»»»» viewbooleanfalsenonenone
»»»» controlbooleanfalsenonenone
» optionsobjecttruenonenone
»» scrollobjectfalsenonenone
»»» enabledbooleanfalsenonenone

Status Code 403

Permission denied

NameTypeRequiredRestrictionsDescription

Status Code 404

Sesssion was not found

NameTypeRequiredRestrictionsDescription
Examples

200 Response

{
"status": "string",
"version": 0,
"owner": {
"id": "string",
"endpoint": "string"
},
"remotes": {
"remoteEndpointIds": {
"remoteId": "string",
"permissions": {
"view": true,
"control": true
}
}
},
"options": {
"scroll": {
"enabled": true
}
}
}
caution

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

Code samples

curl -X POST http://localhost:4444/cobrowser/api/session/reconnect \
-H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Create a new session

POST http://localhost:4444/cobrowser/api/session HTTP/1.1
Host: localhost:4444
Content-Type: application/json
Accept: application/json

Request body

{
"type": "ReconnectCobrowsingSession",
"sessionId": "string",
"timestamp": "string",
"userId": "string",
"userEndpointId": "string",
"version": 0,
"payload": {
"isTargetLocal": true,
"targetId": "string",
"targetEndpointId": "string",
"compressionSupport": {
"zstd": {
"compress": true,
"decompress": true
}
},
"record": {
"conversationId": "string",
"instanceId": "string",
"recorderId": "string"
}
}
}

Parameters

ParameterInTypeRequiredDescription
bodybodyobjecttruenone
» typebodystringtruenone
» sessionIdbodystringfalsenone
» timestampbodystringtruenone
» userIdbodystringtruenone
» userEndpointIdbodystringtruenone
» versionbodyintegertruenone
» payloadbodyobjectfalsenone
»» isTargetLocalbodybooleanfalsenone
»» targetIdbodystringfalsenone
»» targetEndpointIdbodystringfalsenone
»» compressionSupportbodyobjectfalsenone
»»» zstdbodyobjectfalsenone
»»»» compressbodybooleanfalsenone
»»»» decompressbodybooleanfalsenone
»» recordbodyobject¦nullfalsenone
»»» conversationIdbodystringfalsenone
»»» instanceIdbodystringfalsenone
»»» recorderIdbodystringfalsenone
Enumerated Values
ParameterValue
» typeReconnectCobrowsingSession
» typeResumeCobrowsingSession
» typeEnableCobrowsingOption
» typeDisableCobrowsingOption
» typeRequestCobrowsingView
» typeRequestCobrowsingControl
» typeTerminateCobrowsingSession
» typeAcceptCobrowsingView
» typeAcceptCobrowsingControl
» typeRevokeCobrowsingView
» typeRevokeCobrowsingControl
» typeDenyCobrowsingView
» typeDenyCobrowsingControl
» typeUpdateCobrowsingPage
» typeUpdateCobrowsingCursor
» typeUpdateCobrowsingInput
» typeCreateCobrowsingSession

Responses

Overview
StatusMeaningDescriptionSchema
200OKCreated new session and share with targetInline
400Bad RequestBad RequestInline
Response Schema

Status Code 200

Created new session and share with target

NameTypeRequiredRestrictionsDescription
» statusstringfalsenonenone
» versionintegerfalsenonenone
» dataobjectfalsenonenone
»» sessionIdstringfalsenonenone

Status Code 400

Bad Request

NameTypeRequiredRestrictionsDescription
Examples

200 Response

{
"status": "string",
"version": 0,
"data": {
"sessionId": "string"
}
}
caution

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

Code samples

curl -X POST http://localhost:4444/cobrowser/api/session \
-H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Get session info

GET http://localhost:4444/cobrowser/api/session/{id} HTTP/1.1
Host: localhost:4444
Accept: application/json

Parameters

ParameterInTypeRequiredDescription
idpathstringtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKSession infoInline
403ForbiddenPermission deniedInline
404Not FoundSession not foundInline
Response Schema

Status Code 200

Session info

NameTypeRequiredRestrictionsDescription
» statusstringfalsenonenone
» payloadobjectfalsenonenone

Status Code 403

Permission denied

NameTypeRequiredRestrictionsDescription

Status Code 404

Session not found

NameTypeRequiredRestrictionsDescription
Examples

200 Response

{
"status": "string",
"payload": {}
}
caution

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

Code samples

curl -X GET http://localhost:4444/cobrowser/api/session/{id} \
-H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Post dom event as document's owner

POST http://localhost:4444/cobrowser/api/session/owner/update HTTP/1.1
Host: localhost:4444
Accept: application/json

Responses

Overview
StatusMeaningDescriptionSchema
200OKEvent postedInline
403ForbiddenPermission deniedInline
404Not FoundSession not foundInline
Response Schema

Status Code 200

Event posted

NameTypeRequiredRestrictionsDescription
» statusstringfalsenonenone
» versionintegerfalsenonenone

Status Code 403

Permission denied

NameTypeRequiredRestrictionsDescription

Status Code 404

Session not found

NameTypeRequiredRestrictionsDescription
Examples

200 Response

{
"status": "string",
"version": 0
}
caution

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

Code samples

curl -X POST http://localhost:4444/cobrowser/api/session/owner/update \
-H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Post dom event as viewer

POST http://localhost:4444/cobrowser/api/session/remote/update HTTP/1.1
Host: localhost:4444
Content-Type: application/json
Accept: application/json

Request body

{
"type": "ReconnectCobrowsingSession",
"sessionId": "string",
"timestamp": "string",
"userId": "string",
"userEndpointId": "string",
"version": 0,
"payload": {
"type": "string",
"users": [
{
"userId": "string",
"userEndpointId": "string"
}
],
"count": 0,
"payload": {
"events": [
{
"type": "string",
"time": 0,
"payload": {},
"user": {
"userId": "string",
"userEndpointId": "string"
}
}
]
}
}
}

Parameters

ParameterInTypeRequiredDescription
bodybodyobjecttruenone
» typebodystringtruenone
» sessionIdbodystringfalsenone
» timestampbodystringtruenone
» userIdbodystringtruenone
» userEndpointIdbodystringtruenone
» versionbodyintegertruenone
» payloadbodyobjectfalsenone
»» typebodystringtruenone
»» usersbody[object]falsenone
»»» userIdbodystringfalsenone
»»» userEndpointIdbodystringfalsenone
»» countbodyintegertruenone
»» payloadbodyobjecttruenone
»»» eventsbody[object]falsenone
»»»» typebodystringtruenone
»»»» timebodyintegerfalsenone
»»»» payloadbodyobjectfalsenone
»»»» userbodyobjectfalsenone
»»»»» userIdbodystringfalsenone
»»»»» userEndpointIdbodystringfalsenone
Enumerated Values
ParameterValue
» typeReconnectCobrowsingSession
» typeResumeCobrowsingSession
» typeEnableCobrowsingOption
» typeDisableCobrowsingOption
» typeRequestCobrowsingView
» typeRequestCobrowsingControl
» typeTerminateCobrowsingSession
» typeAcceptCobrowsingView
» typeAcceptCobrowsingControl
» typeRevokeCobrowsingView
» typeRevokeCobrowsingControl
» typeDenyCobrowsingView
» typeDenyCobrowsingControl
» typeUpdateCobrowsingPage
» typeUpdateCobrowsingCursor
» typeUpdateCobrowsingInput
» typeCreateCobrowsingSession

Responses

Overview
StatusMeaningDescriptionSchema
200OKEvent postedInline
403ForbiddenPermission deniedInline
404Not FoundSession not foundInline
Response Schema

Status Code 200

Event posted

NameTypeRequiredRestrictionsDescription
» statusstringfalsenonenone
» versionintegerfalsenonenone

Status Code 403

Permission denied

NameTypeRequiredRestrictionsDescription

Status Code 404

Session not found

NameTypeRequiredRestrictionsDescription
Examples

200 Response

{
"status": "string",
"version": 0
}
caution

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

Code samples

curl -X POST http://localhost:4444/cobrowser/api/session/remote/update \
-H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Terminate a cobrowse session

POST http://localhost:4444/cobrowser/api/session/terminate HTTP/1.1
Host: localhost:4444
Content-Type: application/json
Accept: application/json

Request body

{
"type": "ReconnectCobrowsingSession",
"sessionId": "string",
"timestamp": "string",
"userId": "string",
"userEndpointId": "string",
"version": 0,
"payload": {}
}

Parameters

ParameterInTypeRequiredDescription
bodybodyobjecttruenone
» typebodystringtruenone
» sessionIdbodystringfalsenone
» timestampbodystringtruenone
» userIdbodystringtruenone
» userEndpointIdbodystringtruenone
» versionbodyintegertruenone
» payloadbodyobjectfalsenone
Enumerated Values
ParameterValue
» typeReconnectCobrowsingSession
» typeResumeCobrowsingSession
» typeEnableCobrowsingOption
» typeDisableCobrowsingOption
» typeRequestCobrowsingView
» typeRequestCobrowsingControl
» typeTerminateCobrowsingSession
» typeAcceptCobrowsingView
» typeAcceptCobrowsingControl
» typeRevokeCobrowsingView
» typeRevokeCobrowsingControl
» typeDenyCobrowsingView
» typeDenyCobrowsingControl
» typeUpdateCobrowsingPage
» typeUpdateCobrowsingCursor
» typeUpdateCobrowsingInput
» typeCreateCobrowsingSession

Responses

Overview
StatusMeaningDescriptionSchema
200OKSession terminatedInline
403ForbiddenPermission deniedInline
404Not FoundSession not foundInline
Response Schema

Status Code 200

Session terminated

NameTypeRequiredRestrictionsDescription
» statusstringfalsenonenone
» versionintegerfalsenonenone

Status Code 403

Permission denied

NameTypeRequiredRestrictionsDescription

Status Code 404

Session not found

NameTypeRequiredRestrictionsDescription
Examples

200 Response

{
"status": "string",
"version": 0
}
caution

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

Code samples

curl -X POST http://localhost:4444/cobrowser/api/session/terminate \
-H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

permissions

Request, Accept, Revoke and Deny

Request to view remote page

POST http://localhost:4444/cobrowser/api/session/permissions/view/request HTTP/1.1
Host: localhost:4444
Content-Type: application/json
Accept: application/json

Request body

{
"type": "ReconnectCobrowsingSession",
"sessionId": "string",
"timestamp": "string",
"userId": "string",
"userEndpointId": "string",
"version": 0,
"payload": {
"compressionSupport": {
"zstd": {
"compress": true,
"decompress": true
}
},
"record": {
"conversationId": "string",
"instanceId": "string",
"recorderId": "string"
}
}
}

Parameters

ParameterInTypeRequiredDescription
bodybodyobjecttruenone
» typebodystringtruenone
» sessionIdbodystringfalsenone
» timestampbodystringtruenone
» userIdbodystringtruenone
» userEndpointIdbodystringtruenone
» versionbodyintegertruenone
» payloadbodyobjectfalsenone
»» compressionSupportbodyobjectfalsenone
»»» zstdbodyobjectfalsenone
»»»» compressbodybooleanfalsenone
»»»» decompressbodybooleanfalsenone
»» recordbodyobjectfalsenone
»»» conversationIdbodystringfalsenone
»»» instanceIdbodystringfalsenone
»»» recorderIdbodystringfalsenone
Enumerated Values
ParameterValue
» typeReconnectCobrowsingSession
» typeResumeCobrowsingSession
» typeEnableCobrowsingOption
» typeDisableCobrowsingOption
» typeRequestCobrowsingView
» typeRequestCobrowsingControl
» typeTerminateCobrowsingSession
» typeAcceptCobrowsingView
» typeAcceptCobrowsingControl
» typeRevokeCobrowsingView
» typeRevokeCobrowsingControl
» typeDenyCobrowsingView
» typeDenyCobrowsingControl
» typeUpdateCobrowsingPage
» typeUpdateCobrowsingCursor
» typeUpdateCobrowsingInput
» typeCreateCobrowsingSession

Responses

Overview
StatusMeaningDescriptionSchema
200OKCreated new session and requested view access from targetInline
400Bad RequestBad RequestInline
Response Schema

Status Code 200

Created new session and requested view access from target

NameTypeRequiredRestrictionsDescription
» statusstringfalsenonenone
» versionintegerfalsenonenone
» dataobjectfalsenonenone
»» sessionIdstringfalsenonenone

Status Code 400

Bad Request

NameTypeRequiredRestrictionsDescription
Examples

200 Response

{
"status": "string",
"version": 0,
"data": {
"sessionId": "string"
}
}
caution

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

Code samples

curl -X POST http://localhost:4444/cobrowser/api/session/permissions/view/request \
-H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Accept request to view page

POST http://localhost:4444/cobrowser/api/session/permissions/view/accept HTTP/1.1
Host: localhost:4444
Content-Type: application/json
Accept: application/json

Request body

{
"type": "ReconnectCobrowsingSession",
"sessionId": "string",
"timestamp": "string",
"userId": "string",
"userEndpointId": "string",
"version": 0,
"payload": {
"compressionSupport": {
"zstd": {
"compress": true,
"decompress": true
}
}
}
}

Parameters

ParameterInTypeRequiredDescription
bodybodyobjecttruenone
» typebodystringtruenone
» sessionIdbodystringfalsenone
» timestampbodystringtruenone
» userIdbodystringtruenone
» userEndpointIdbodystringtruenone
» versionbodyintegertruenone
» payloadbodyobjectfalsenone
»» compressionSupportbodyobjectfalsenone
»»» zstdbodyobjectfalsenone
»»»» compressbodybooleanfalsenone
»»»» decompressbodybooleanfalsenone
Enumerated Values
ParameterValue
» typeReconnectCobrowsingSession
» typeResumeCobrowsingSession
» typeEnableCobrowsingOption
» typeDisableCobrowsingOption
» typeRequestCobrowsingView
» typeRequestCobrowsingControl
» typeTerminateCobrowsingSession
» typeAcceptCobrowsingView
» typeAcceptCobrowsingControl
» typeRevokeCobrowsingView
» typeRevokeCobrowsingControl
» typeDenyCobrowsingView
» typeDenyCobrowsingControl
» typeUpdateCobrowsingPage
» typeUpdateCobrowsingCursor
» typeUpdateCobrowsingInput
» typeCreateCobrowsingSession

Responses

Overview
StatusMeaningDescriptionSchema
200OKView request was acceptedInline
404Not FoundSession not foundInline
409ConflictState mismatchInline
Response Schema

Status Code 200

View request was accepted

NameTypeRequiredRestrictionsDescription
» statusstringfalsenonenone
» versionintegerfalsenonenone

Status Code 404

Session not found

NameTypeRequiredRestrictionsDescription

Status Code 409

State mismatch

NameTypeRequiredRestrictionsDescription
Examples

200 Response

{
"status": "string",
"version": 0
}
caution

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

Code samples

curl -X POST http://localhost:4444/cobrowser/api/session/permissions/view/accept \
-H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Revoke view access of participant

POST http://localhost:4444/cobrowser/api/session/permissions/view/revoke HTTP/1.1
Host: localhost:4444
Content-Type: application/json
Accept: application/json

Request body

{
"type": "ReconnectCobrowsingSession",
"sessionId": "string",
"timestamp": "string",
"userId": "string",
"userEndpointId": "string",
"version": 0,
"payload": {}
}

Parameters

ParameterInTypeRequiredDescription
bodybodyobjecttruenone
» typebodystringtruenone
» sessionIdbodystringfalsenone
» timestampbodystringtruenone
» userIdbodystringtruenone
» userEndpointIdbodystringtruenone
» versionbodyintegertruenone
» payloadbodyobjectfalsenone
Enumerated Values
ParameterValue
» typeReconnectCobrowsingSession
» typeResumeCobrowsingSession
» typeEnableCobrowsingOption
» typeDisableCobrowsingOption
» typeRequestCobrowsingView
» typeRequestCobrowsingControl
» typeTerminateCobrowsingSession
» typeAcceptCobrowsingView
» typeAcceptCobrowsingControl
» typeRevokeCobrowsingView
» typeRevokeCobrowsingControl
» typeDenyCobrowsingView
» typeDenyCobrowsingControl
» typeUpdateCobrowsingPage
» typeUpdateCobrowsingCursor
» typeUpdateCobrowsingInput
» typeCreateCobrowsingSession

Responses

Overview
StatusMeaningDescriptionSchema
200OKView access was revokedInline
403ForbiddenPermission deniedInline
Response Schema

Status Code 200

View access was revoked

NameTypeRequiredRestrictionsDescription
» statusstringfalsenonenone
» versionintegerfalsenonenone

Status Code 403

Permission denied

NameTypeRequiredRestrictionsDescription
Examples

200 Response

{
"status": "string",
"version": 0
}
caution

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

Code samples

curl -X POST http://localhost:4444/cobrowser/api/session/permissions/view/revoke \
-H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Request to control page

POST http://localhost:4444/cobrowser/api/session/permissions/control/request HTTP/1.1
Host: localhost:4444
Content-Type: application/json
Accept: application/json

Request body

{
"type": "ReconnectCobrowsingSession",
"sessionId": "string",
"timestamp": "string",
"userId": "string",
"userEndpointId": "string",
"version": 0,
"payload": {}
}

Parameters

ParameterInTypeRequiredDescription
bodybodyobjecttruenone
» typebodystringtruenone
» sessionIdbodystringfalsenone
» timestampbodystringtruenone
» userIdbodystringtruenone
» userEndpointIdbodystringtruenone
» versionbodyintegertruenone
» payloadbodyobjectfalsenone
Enumerated Values
ParameterValue
» typeReconnectCobrowsingSession
» typeResumeCobrowsingSession
» typeEnableCobrowsingOption
» typeDisableCobrowsingOption
» typeRequestCobrowsingView
» typeRequestCobrowsingControl
» typeTerminateCobrowsingSession
» typeAcceptCobrowsingView
» typeAcceptCobrowsingControl
» typeRevokeCobrowsingView
» typeRevokeCobrowsingControl
» typeDenyCobrowsingView
» typeDenyCobrowsingControl
» typeUpdateCobrowsingPage
» typeUpdateCobrowsingCursor
» typeUpdateCobrowsingInput
» typeCreateCobrowsingSession

Responses

Overview
StatusMeaningDescriptionSchema
200OKControl access was requestedInline
400Bad RequestMissing target propertyInline
403ForbiddenPermission deniedInline
404Not FoundSession not foundInline
Response Schema

Status Code 200

Control access was requested

NameTypeRequiredRestrictionsDescription
» statusstringfalsenonenone
» versionintegerfalsenonenone

Status Code 400

Missing target property

NameTypeRequiredRestrictionsDescription

Status Code 403

Permission denied

NameTypeRequiredRestrictionsDescription

Status Code 404

Session not found

NameTypeRequiredRestrictionsDescription
Examples

200 Response

{
"status": "string",
"version": 0
}
caution

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

Code samples

curl -X POST http://localhost:4444/cobrowser/api/session/permissions/control/request \
-H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Accept request to control page

POST http://localhost:4444/cobrowser/api/session/permissions/control/accept HTTP/1.1
Host: localhost:4444
Content-Type: application/json
Accept: application/json

Request body

{
"type": "ReconnectCobrowsingSession",
"sessionId": "string",
"timestamp": "string",
"userId": "string",
"userEndpointId": "string",
"version": 0,
"payload": {}
}

Parameters

ParameterInTypeRequiredDescription
bodybodyobjecttruenone
» typebodystringtruenone
» sessionIdbodystringfalsenone
» timestampbodystringtruenone
» userIdbodystringtruenone
» userEndpointIdbodystringtruenone
» versionbodyintegertruenone
» payloadbodyobjectfalsenone
Enumerated Values
ParameterValue
» typeReconnectCobrowsingSession
» typeResumeCobrowsingSession
» typeEnableCobrowsingOption
» typeDisableCobrowsingOption
» typeRequestCobrowsingView
» typeRequestCobrowsingControl
» typeTerminateCobrowsingSession
» typeAcceptCobrowsingView
» typeAcceptCobrowsingControl
» typeRevokeCobrowsingView
» typeRevokeCobrowsingControl
» typeDenyCobrowsingView
» typeDenyCobrowsingControl
» typeUpdateCobrowsingPage
» typeUpdateCobrowsingCursor
» typeUpdateCobrowsingInput
» typeCreateCobrowsingSession

Responses

Overview
StatusMeaningDescriptionSchema
200OKControl access was acceptedInline
403ForbiddenPermission deniedInline
404Not FoundSession not foundInline
Response Schema

Status Code 200

Control access was accepted

NameTypeRequiredRestrictionsDescription
» statusstringfalsenonenone
» versionintegerfalsenonenone

Status Code 403

Permission denied

NameTypeRequiredRestrictionsDescription

Status Code 404

Session not found

NameTypeRequiredRestrictionsDescription
Examples

200 Response

{
"status": "string",
"version": 0
}
caution

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

Code samples

curl -X POST http://localhost:4444/cobrowser/api/session/permissions/control/accept \
-H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Revoke control access for participant

POST http://localhost:4444/cobrowser/api/session/permissions/control/revoke HTTP/1.1
Host: localhost:4444
Content-Type: application/json
Accept: application/json

Request body

{
"type": "ReconnectCobrowsingSession",
"sessionId": "string",
"timestamp": "string",
"userId": "string",
"userEndpointId": "string",
"version": 0,
"payload": {}
}

Parameters

ParameterInTypeRequiredDescription
bodybodyobjecttruenone
» typebodystringtruenone
» sessionIdbodystringfalsenone
» timestampbodystringtruenone
» userIdbodystringtruenone
» userEndpointIdbodystringtruenone
» versionbodyintegertruenone
» payloadbodyobjectfalsenone
Enumerated Values
ParameterValue
» typeReconnectCobrowsingSession
» typeResumeCobrowsingSession
» typeEnableCobrowsingOption
» typeDisableCobrowsingOption
» typeRequestCobrowsingView
» typeRequestCobrowsingControl
» typeTerminateCobrowsingSession
» typeAcceptCobrowsingView
» typeAcceptCobrowsingControl
» typeRevokeCobrowsingView
» typeRevokeCobrowsingControl
» typeDenyCobrowsingView
» typeDenyCobrowsingControl
» typeUpdateCobrowsingPage
» typeUpdateCobrowsingCursor
» typeUpdateCobrowsingInput
» typeCreateCobrowsingSession

Responses

Overview
StatusMeaningDescriptionSchema
200OKControl access was revokedInline
403ForbiddenPermission deniedInline
404Not FoundSession not foundInline
Response Schema

Status Code 200

Control access was revoked

NameTypeRequiredRestrictionsDescription
» statusstringfalsenonenone
» versionintegerfalsenonenone

Status Code 403

Permission denied

NameTypeRequiredRestrictionsDescription

Status Code 404

Session not found

NameTypeRequiredRestrictionsDescription
Examples

200 Response

{
"status": "string",
"version": 0
}
caution

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

Code samples

curl -X POST http://localhost:4444/cobrowser/api/session/permissions/control/revoke \
-H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Deny permission request

POST http://localhost:4444/cobrowser/api/session/permissions/deny HTTP/1.1
Host: localhost:4444
Content-Type: application/json
Accept: application/json

Request body

{
"type": "ReconnectCobrowsingSession",
"sessionId": "string",
"timestamp": "string",
"userId": "string",
"userEndpointId": "string",
"version": 0,
"payload": {
"targetId": "string",
"targetEndpointId": "string",
"permission": "view"
}
}

Parameters

ParameterInTypeRequiredDescription
bodybodyobjecttruenone
» typebodystringtruenone
» sessionIdbodystringfalsenone
» timestampbodystringtruenone
» userIdbodystringtruenone
» userEndpointIdbodystringtruenone
» versionbodyintegertruenone
» payloadbodyobjectfalsenone
»» targetIdbodystringtruenone
»» targetEndpointIdbodystringtruenone
»» permissionbodystringtruenone
Enumerated Values
ParameterValue
» typeReconnectCobrowsingSession
» typeResumeCobrowsingSession
» typeEnableCobrowsingOption
» typeDisableCobrowsingOption
» typeRequestCobrowsingView
» typeRequestCobrowsingControl
» typeTerminateCobrowsingSession
» typeAcceptCobrowsingView
» typeAcceptCobrowsingControl
» typeRevokeCobrowsingView
» typeRevokeCobrowsingControl
» typeDenyCobrowsingView
» typeDenyCobrowsingControl
» typeUpdateCobrowsingPage
» typeUpdateCobrowsingCursor
» typeUpdateCobrowsingInput
» typeCreateCobrowsingSession
»» permissionview
»» permissioncontrol

Responses

Overview
StatusMeaningDescriptionSchema
200OKPermission request deniedInline
403ForbiddenPermission deniedInline
404Not FoundSession not foundInline
Response Schema

Status Code 200

Permission request denied

NameTypeRequiredRestrictionsDescription
» statusstringfalsenonenone
» versionintegerfalsenonenone

Status Code 403

Permission denied

NameTypeRequiredRestrictionsDescription

Status Code 404

Session not found

NameTypeRequiredRestrictionsDescription
Examples

200 Response

{
"status": "string",
"version": 0
}
caution

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

Code samples

curl -X POST http://localhost:4444/cobrowser/api/session/permissions/deny \
-H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

options

Enable and Disable options

Enable an option

POST http://localhost:4444/cobrowser/api/session/options/enable HTTP/1.1
Host: localhost:4444
Content-Type: application/json
Accept: application/json

Request body

{
"type": "ReconnectCobrowsingSession",
"sessionId": "string",
"timestamp": "string",
"userId": "string",
"userEndpointId": "string",
"version": 0,
"payload": {
"option": "scroll",
"settings": {}
}
}

Parameters

ParameterInTypeRequiredDescription
bodybodyobjecttruenone
» typebodystringtruenone
» sessionIdbodystringfalsenone
» timestampbodystringtruenone
» userIdbodystringtruenone
» userEndpointIdbodystringtruenone
» versionbodyintegertruenone
» payloadbodyobjectfalsenone
»» optionbodystringfalsenone
»» settingsbodyobjectfalsenone
Enumerated Values
ParameterValue
» typeReconnectCobrowsingSession
» typeResumeCobrowsingSession
» typeEnableCobrowsingOption
» typeDisableCobrowsingOption
» typeRequestCobrowsingView
» typeRequestCobrowsingControl
» typeTerminateCobrowsingSession
» typeAcceptCobrowsingView
» typeAcceptCobrowsingControl
» typeRevokeCobrowsingView
» typeRevokeCobrowsingControl
» typeDenyCobrowsingView
» typeDenyCobrowsingControl
» typeUpdateCobrowsingPage
» typeUpdateCobrowsingCursor
» typeUpdateCobrowsingInput
» typeCreateCobrowsingSession
»» optionscroll
»» optionrecord

Responses

Overview
StatusMeaningDescriptionSchema
200OKOption was enabledInline
403ForbiddenPermission deniedInline
404Not FoundSession not foundInline
Response Schema

Status Code 200

Option was enabled

NameTypeRequiredRestrictionsDescription
» statusstringfalsenonenone
» versionintegerfalsenonenone

Status Code 403

Permission denied

NameTypeRequiredRestrictionsDescription

Status Code 404

Session not found

NameTypeRequiredRestrictionsDescription
Examples

200 Response

{
"status": "string",
"version": 0
}
caution

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

Code samples

curl -X POST http://localhost:4444/cobrowser/api/session/options/enable \
-H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

Disable an option

POST http://localhost:4444/cobrowser/api/session/options/disable HTTP/1.1
Host: localhost:4444
Content-Type: application/json
Accept: application/json

Request body

{
"type": "ReconnectCobrowsingSession",
"sessionId": "string",
"timestamp": "string",
"userId": "string",
"userEndpointId": "string",
"version": 0,
"payload": {
"option": "scroll"
}
}

Parameters

ParameterInTypeRequiredDescription
bodybodyobjecttruenone
» typebodystringtruenone
» sessionIdbodystringfalsenone
» timestampbodystringtruenone
» userIdbodystringtruenone
» userEndpointIdbodystringtruenone
» versionbodyintegertruenone
» payloadbodyobjectfalsenone
»» optionbodystringfalsenone
Enumerated Values
ParameterValue
» typeReconnectCobrowsingSession
» typeResumeCobrowsingSession
» typeEnableCobrowsingOption
» typeDisableCobrowsingOption
» typeRequestCobrowsingView
» typeRequestCobrowsingControl
» typeTerminateCobrowsingSession
» typeAcceptCobrowsingView
» typeAcceptCobrowsingControl
» typeRevokeCobrowsingView
» typeRevokeCobrowsingControl
» typeDenyCobrowsingView
» typeDenyCobrowsingControl
» typeUpdateCobrowsingPage
» typeUpdateCobrowsingCursor
» typeUpdateCobrowsingInput
» typeCreateCobrowsingSession
»» optionscroll
»» optionrecord

Responses

Overview
StatusMeaningDescriptionSchema
200OKOption was disabledInline
403ForbiddenPermission deniedInline
404Not FoundSession not foundInline
Response Schema

Status Code 200

Option was disabled

NameTypeRequiredRestrictionsDescription
» statusstringfalsenonenone
» versionintegerfalsenonenone

Status Code 403

Permission denied

NameTypeRequiredRestrictionsDescription

Status Code 404

Session not found

NameTypeRequiredRestrictionsDescription
Examples

200 Response

{
"status": "string",
"version": 0
}
caution

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

Code samples

curl -X POST http://localhost:4444/cobrowser/api/session/options/disable \
-H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}'

logs

Get extension version

GET http://localhost:4444/cobrowser/extension HTTP/1.1
Host: localhost:4444
Accept: application/json

Responses

Overview
StatusMeaningDescriptionSchema
200OKDefault ResponseInline
Response Schema

Status Code 200

NameTypeRequiredRestrictionsDescription
» versionstringfalsenonenone
Examples

200 Response

{
"version": "string"
}
tip

This operation does not require authentication

Code samples

curl -X GET http://localhost:4444/cobrowser/extension \
-H 'Accept: application/json'

Get log ticket by ID

GET http://localhost:4444/cobrowser/extension/tickets/{id} HTTP/1.1
Host: localhost:4444
Accept: application/json

Parameters

ParameterInTypeRequiredDescription
idpathstringtrueLog ticket ID

Responses

Overview
StatusMeaningDescriptionSchema
200OKDefault ResponseInline
404Not FoundDefault ResponseInline
Response Schema

Status Code 200

NameTypeRequiredRestrictionsDescription
» idstringfalsenonenone
» usedCountnumberfalsenonenone
» maxCountnumberfalsenonenone
» sessions[object]falsenonenone
»» sessionIdstringfalsenonenone
»» createdAtstring(date-time)falsenonenone
»» files[object]falsenonenone
»»» filenamestringfalsenonenone
»»» pathstringfalsenonenone
»»» uploadedAtstring(date-time)falsenonenone
» createdAtstring(date-time)falsenonenone

Status Code 404

NameTypeRequiredRestrictionsDescription
» errorstringfalsenonenone
Examples

200 Response

{
"id": "string",
"usedCount": 0,
"maxCount": 0,
"sessions": [
{
"sessionId": "string",
"createdAt": "2019-08-24T14:15:22Z",
"files": [
{
"filename": "string",
"path": "string",
"uploadedAt": "2019-08-24T14:15:22Z"
}
]
}
],
"createdAt": "2019-08-24T14:15:22Z"
}
tip

This operation does not require authentication

Code samples

curl -X GET http://localhost:4444/cobrowser/extension/tickets/{id} \
-H 'Accept: application/json'

Create new log ticket, origin dependent

POST http://localhost:4444/cobrowser/extension/tickets HTTP/1.1
Host: localhost:4444
Content-Type: application/json
Accept: application/json

Request body

{
"maxCount": 10,
"name": "string"
}

Parameters

ParameterInTypeRequiredDescription
bodybodyobjectfalsenone
» maxCountbodynumberfalseMaximum number of sessions allowed
» namebodystringfalseName of who requested the ticket (e.g., company name)

Responses

Overview
StatusMeaningDescriptionSchema
200OKDefault ResponseInline
Response Schema

Status Code 200

NameTypeRequiredRestrictionsDescription
» idstringfalsenonenone
» usedCountnumberfalsenonenone
» maxCountnumberfalsenonenone
» sessions[any]falsenonenone
» createdAtstring(date-time)falsenonenone
Examples

200 Response

{
"id": "string",
"usedCount": 0,
"maxCount": 0,
"sessions": [
null
],
"createdAt": "2019-08-24T14:15:22Z"
}
tip

This operation does not require authentication

Code samples

curl -X POST http://localhost:4444/cobrowser/extension/tickets \
-H 'Content-Type: application/json' \ -H 'Accept: application/json'

Upload log file

POST http://localhost:4444/cobrowser/extension/uploads/logs HTTP/1.1
Host: localhost:4444
Accept: application/json
x-log-id: string

Upload a log file with filename format: type_domain_session-id_date.ext

Parameters

ParameterInTypeRequiredDescription
x-log-idheaderstringtrueLog ticket ID

Responses

Overview
StatusMeaningDescriptionSchema
200OKDefault Responsestring
400Bad RequestDefault Responsestring
403ForbiddenDefault Responsestring
Examples

200 Response

"OK"
tip

This operation does not require authentication

Code samples

curl -X POST http://localhost:4444/cobrowser/extension/uploads/logs \
-H 'Accept: application/json' \ -H 'x-log-id: string'

Download file from ticket session

GET http://localhost:4444/cobrowser/extension/files/{ticketId}/{sessionId}/{filename} HTTP/1.1
Host: localhost:4444
Accept: application/json

Parameters

ParameterInTypeRequiredDescription
ticketIdpathstringtrueLog ticket ID
sessionIdpathstringtrueSession ID
filenamepathstringtrueFile name

Responses

Overview
StatusMeaningDescriptionSchema
200OKFile contentstring
404Not FoundDefault ResponseInline
Response Schema

Status Code 404

NameTypeRequiredRestrictionsDescription
» errorstringfalsenonenone
Examples

200 Response

"string"
tip

This operation does not require authentication

Code samples

curl -X GET http://localhost:4444/cobrowser/extension/files/{ticketId}/{sessionId}/{filename} \
-H 'Accept: application/json'

Schemas