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",
"tabId": "string",
"version": 0,
"payload": {
"previousId": "string",
"previousEndpointId": "string"
}
}

Parameters​

ParameterInTypeRequiredDescription
bodybodyobjecttruenone
» typebodystringtruenone
» sessionIdbodystringfalsenone
» timestampbodystringtruenone
» userIdbodystringtruenone
» userEndpointIdbodystringtruenone
» tabIdbodystringfalsenone
» 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",
"tabId": "string",
"version": 0,
"payload": {
"takeover": true,
"previousOwnerTabId": "string"
}
}

Parameters​

ParameterInTypeRequiredDescription
bodybodyobjecttruenone
» typebodystringtruenone
» sessionIdbodystringfalsenone
» timestampbodystringtruenone
» userIdbodystringtruenone
» userEndpointIdbodystringtruenone
» tabIdbodystringfalsenone
» versionbodyintegertruenone
» payloadbodyobjectfalsenone
»» takeoverbodybooleanfalsenone
»» previousOwnerTabIdbodystringfalsenone
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
409ConflictSession is active in another tabInline
Response Schema​

Status Code 200

Reconnected to session

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

Status Code 403

Permission denied

NameTypeRequiredRestrictionsDescription

Status Code 404

Sesssion was not found

NameTypeRequiredRestrictionsDescription

Status Code 409

Session is active in another tab

NameTypeRequiredRestrictionsDescription
Examples​

200 Response

{
"status": "string",
"version": 0,
"owner": {
"id": "string",
"endpoint": "string",
"tabId": "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",
"tabId": "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
» tabIdbodystringfalsenone
» 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
409ConflictSession ownership was transferredInline
Response Schema​

Status Code 200

Event posted

NameTypeRequiredRestrictionsDescription
» statusstringfalsenonenone
» versionintegerfalsenonenone

Status Code 403

Permission denied

NameTypeRequiredRestrictionsDescription

Status Code 404

Session not found

NameTypeRequiredRestrictionsDescription

Status Code 409

Session ownership was transferred

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",
"tabId": "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
» tabIdbodystringfalsenone
» 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",
"tabId": "string",
"version": 0,
"payload": {}
}

Parameters​

ParameterInTypeRequiredDescription
bodybodyobjecttruenone
» typebodystringtruenone
» sessionIdbodystringfalsenone
» timestampbodystringtruenone
» userIdbodystringtruenone
» userEndpointIdbodystringtruenone
» tabIdbodystringfalsenone
» 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
409ConflictSession ownership was transferredInline
Response Schema​

Status Code 200

Session terminated

NameTypeRequiredRestrictionsDescription
» statusstringfalsenonenone
» versionintegerfalsenonenone

Status Code 403

Permission denied

NameTypeRequiredRestrictionsDescription

Status Code 404

Session not found

NameTypeRequiredRestrictionsDescription

Status Code 409

Session ownership was transferred

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",
"tabId": "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
» tabIdbodystringfalsenone
» 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",
"tabId": "string",
"version": 0,
"payload": {
"compressionSupport": {
"zstd": {
"compress": true,
"decompress": true
}
}
}
}

Parameters​

ParameterInTypeRequiredDescription
bodybodyobjecttruenone
» typebodystringtruenone
» sessionIdbodystringfalsenone
» timestampbodystringtruenone
» userIdbodystringtruenone
» userEndpointIdbodystringtruenone
» tabIdbodystringfalsenone
» 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",
"tabId": "string",
"version": 0,
"payload": {}
}

Parameters​

ParameterInTypeRequiredDescription
bodybodyobjecttruenone
» typebodystringtruenone
» sessionIdbodystringfalsenone
» timestampbodystringtruenone
» userIdbodystringtruenone
» userEndpointIdbodystringtruenone
» tabIdbodystringfalsenone
» 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",
"tabId": "string",
"version": 0,
"payload": {}
}

Parameters​

ParameterInTypeRequiredDescription
bodybodyobjecttruenone
» typebodystringtruenone
» sessionIdbodystringfalsenone
» timestampbodystringtruenone
» userIdbodystringtruenone
» userEndpointIdbodystringtruenone
» tabIdbodystringfalsenone
» 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",
"tabId": "string",
"version": 0,
"payload": {}
}

Parameters​

ParameterInTypeRequiredDescription
bodybodyobjecttruenone
» typebodystringtruenone
» sessionIdbodystringfalsenone
» timestampbodystringtruenone
» userIdbodystringtruenone
» userEndpointIdbodystringtruenone
» tabIdbodystringfalsenone
» 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",
"tabId": "string",
"version": 0,
"payload": {}
}

Parameters​

ParameterInTypeRequiredDescription
bodybodyobjecttruenone
» typebodystringtruenone
» sessionIdbodystringfalsenone
» timestampbodystringtruenone
» userIdbodystringtruenone
» userEndpointIdbodystringtruenone
» tabIdbodystringfalsenone
» 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",
"tabId": "string",
"version": 0,
"payload": {
"targetId": "string",
"targetEndpointId": "string",
"permission": "view"
}
}

Parameters​

ParameterInTypeRequiredDescription
bodybodyobjecttruenone
» typebodystringtruenone
» sessionIdbodystringfalsenone
» timestampbodystringtruenone
» userIdbodystringtruenone
» userEndpointIdbodystringtruenone
» tabIdbodystringfalsenone
» 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",
"tabId": "string",
"version": 0,
"payload": {
"option": "scroll",
"settings": {}
}
}

Parameters​

ParameterInTypeRequiredDescription
bodybodyobjecttruenone
» typebodystringtruenone
» sessionIdbodystringfalsenone
» timestampbodystringtruenone
» userIdbodystringtruenone
» userEndpointIdbodystringtruenone
» tabIdbodystringfalsenone
» 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",
"tabId": "string",
"version": 0,
"payload": {
"option": "scroll"
}
}

Parameters​

ParameterInTypeRequiredDescription
bodybodyobjecttruenone
» typebodystringtruenone
» sessionIdbodystringfalsenone
» timestampbodystringtruenone
» userIdbodystringtruenone
» userEndpointIdbodystringtruenone
» tabIdbodystringfalsenone
» 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
» namestringfalsenonenone
» usedCountnumberfalsenonenone
» maxCountnumberfalsenonenone
» sessions[object]falsenonenone
»» sessionIdstringfalsenonenone
»» createdAtstring(date-time)falsenonenone
»» files[object]falsenonenone
»»» filenamestringfalsenonenone
»»» pathstringfalsenonenone
»»» sizenumberfalsenonenone
»»» uploadedAtstring(date-time)falsenonenone
» createdAtstring(date-time)falsenonenone

Status Code 404

NameTypeRequiredRestrictionsDescription
» errorstringfalsenonenone
Examples​

200 Response

{
"id": "string",
"name": "string",
"usedCount": 0,
"maxCount": 0,
"sessions": [
{
"sessionId": "string",
"createdAt": "2019-08-24T14:15:22Z",
"files": [
{
"filename": "string",
"path": "string",
"size": 0,
"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
» namestringfalsenonenone
» usedCountnumberfalsenonenone
» maxCountnumberfalsenonenone
» sessions[any]falsenonenone
» createdAtstring(date-time)falsenonenone
Examples​

200 Response

{
"id": "string",
"name": "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 ResponseInline
400Bad RequestDefault Responsestring
403ForbiddenDefault Responsestring
503Service UnavailableDefault Responsestring
Response Schema​

Status Code 200

NameTypeRequiredRestrictionsDescription
» successbooleantruenonenone
Examples​

200 Response

{
"success": true
}
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​