api-docs v5.45.0

API Docs

Chat_Session

Chat Session - Post

Back to top

Create chat session

POST /chat-sessions

Headers

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
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
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 - Find

Back to top

Get list of chat sessions

GET /chat-sessions

Headers

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.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

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
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

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
participants string[]
createdAt number optional

timestamp

Default value: currentTime
start boolean optional

directive
accept boolean optional

directive
reject 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
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 ""