api-docs v5.116.0

API Docs

Table of contents


Chat_Session

Chat Session - Find

Back to top

Get list of chat sessions

GET /chat-sessions

Headers - Header

Name Type Description
Authorization string

key to place the API token to using the grant 'Bearer'

Header examples

Authorization-Example

{
  "Authorization": "Bearer <your-api-token>"
}

Examples

Example usage:

curl "https://yourdomain.com/chat-sessions" \
  -X GET \
  -H "Authorization: Bearer <your-api-token>"

Success response

Success response - Success 200

Name Type Description
chatSessions[] object[]

array of chatSession

chatSessions.id string
chatSessions.createdAt number

timestamp

Default value: currentTime
chatSessions.type string Allowed values: telemed
chatSessions.room string
chatSessions.startedAt number

timestamp

chatSessions.startedBy string

account uid

chatSessions.acceptedAt number

timestamp

chatSessions.acceptedBy string

account uid

chatSessions.rejectedAt number

timestamp

chatSessions.rejectedBy string

account uid

chatSessions.rejectReason string
chatSessions.finishedAt number

timestamp

chatSessions.finishedBy string

account uid

chatSessions.participants string[]

account ids

Success response example

Success response example - Success-Response:

HTTP/1.1 200 OK
[
  {
    "id": "id-1",
    "createdAt": 1564661697125,
    "createdBy": "some-uid"
  },
  {
    "id": "id-2",
    "createdAt": 1564661697125,
    "createdBy": "some-uid"
  }
]

Chat Session - Get

Back to top

Get a specific chat session

GET /chat-sessions/:id

Headers - Header

Name Type Description
Authorization string

key to place the API token to using the grant 'Bearer'

Header examples

Authorization-Example

{
  "Authorization": "Bearer <your-api-token>"
}

Examples

Example usage:

curl "https://yourdomain.com/chat-sessions/<chat-session-id>" \
  -X GET \
  -H "Authorization: Bearer <your-api-token>"

Success response

Success response - Success 200

Name Type Description
id string
createdAt number

timestamp

Default value: currentTime
type string Allowed values: telemed
room string
startedAt number

timestamp

startedBy string

account uid

acceptedAt number

timestamp

acceptedBy string

account uid

rejectedAt number

timestamp

rejectedBy string

account uid

rejectReason string
finishedAt number

timestamp

finishedBy string

account uid

participants string[]

account ids

Success response example

Success response example - Success-Response:

HTTP/1.1 200 OK
{
  "id": "id-1",
  "createdAt": 1564661697125,
  "createdBy": "some-uid"
}

Chat Session - Patch

Back to top

Update chat session

PATCH /chat-sessions/:id

Headers - Header

Name Type Description
Authorization string

key to place the API token to using the grant 'Bearer'

Header examples

Authorization-Example

{
  "Authorization": "Bearer <your-api-token>"
}

Parameters - Parameter

Name Type Description
type string optional Allowed values: telemed
room string optional
startedAt number optional

timestamp

startedBy string optional

account uid

acceptedAt number optional

timestamp

acceptedBy string optional

account uid

rejectedAt number optional

timestamp

rejectedBy string optional

account uid

rejectReason string optional
finishedAt number optional

timestamp

finishedBy string optional

account uid

participants string[]
createdAt number optional

timestamp

Default value: currentTime
start boolean optional

directive

accept boolean optional

directive

reject boolean/string optional

directive

finish boolean/string optional

directive

Examples

Example usage:

curl "https://yourdomain.com/chat-sessions/<chat-session-id>" \
  -X PATCH \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <your-api-token>" \
  -d '{
    "seen": true
  }'

Parameters examples

json - Request-Example

{
  "seen": true
}

Success response

Success response - Success 200

Name Type Description
id string
createdAt number

timestamp

Default value: currentTime
type string Allowed values: telemed
room string
startedAt number

timestamp

startedBy string

account uid

acceptedAt number

timestamp

acceptedBy string

account uid

rejectedAt number

timestamp

rejectedBy string

account uid

rejectReason string
finishedAt number

timestamp

finishedBy string

account uid

participants string[]

account ids

Success response example

Success response example - Success-Response:

HTTP/1.1 200 OK
{
  "id": "id-1",
  "createdAt": 1564661697125,
  "createdBy": "some-uid"
}

Chat Session - Post

Back to top

Create chat session

POST /chat-sessions

Headers - Header

Name Type Description
Authorization string

key to place the API token to using the grant 'Bearer'

Header examples

Authorization-Example

{
  "Authorization": "Bearer <your-api-token>"
}

Parameters - Parameter

Name Type Description
type string optional Allowed values: telemed
room string optional
startedAt number optional

timestamp

startedBy string optional

account uid

acceptedAt number optional

timestamp

acceptedBy string optional

account uid

rejectedAt number optional

timestamp

rejectedBy string optional

account uid

rejectReason string optional
finishedAt number optional

timestamp

finishedBy string optional

account uid

participants string[]
createdAt number optional

timestamp

Default value: currentTime

Examples

Example usage:

curl "https://yourdomain.com/chat-sessions" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <your-api-token>" \
  -d '{
    "participants": ["account-id1", "account-id2"],
    "title": "Hello"
  }'

Parameters examples

json - Request-Example

{
  "participants": ["account-id1", "account-id2"],
  "title": "Hello"
}

Success response

Success response - Success 200

Name Type Description
id string
createdAt number

timestamp

Default value: currentTime
type string Allowed values: telemed
room string
startedAt number

timestamp

startedBy string

account uid

acceptedAt number

timestamp

acceptedBy string

account uid

rejectedAt number

timestamp

rejectedBy string

account uid

rejectReason string
finishedAt number

timestamp

finishedBy string

account uid

participants string[]

account ids

Success response example

Success response example - Success-Response:

HTTP/1.1 200 OK
{
  "id": "id-1",
  "createdAt": 1564661697125,
  "createdBy": "some-uid"
}

results matching ""

    No results matching ""