logo
API docs by Redocly

Messenger API specification (14cae69bf6d4fb17aab5a2b194109b39d92a70d3)

Download OpenAPI specification:

The chat service manages chatrooms for our mobile messenger app.

chatrooms

GetRooms

Returns a paginated list of all organization chatrooms

Authorizations:
API-TOKENPersonal-Access-Token
query Parameters
organization_id
required
integer

id of the organization

all
boolean
Default: false

returns all entries, ignoring limit and offset parameters

limit
integer [ 1 .. 50 ]
Default: 10

max. amount of chatrooms in paginated list

offset
integer
Default: 0

skipped chatrooms in paginated list

Responses

Response samples

Content type
application/json
{
  • "entries": [
    ],
  • "total": 0
}

Creates a new custom chatroom for an organization.

Authorizations:
API-TOKENPersonal-Access-Token
Request Body schema: application/json
required
admins
Array of integers <int64> [ items <int64 > ]
assignedUsers
Array of integers <int64> [ items <int64 > ]
avatar
Array of integers <uint8> [ items <uint8 > ]
moderators
Array of integers <int64> [ items <int64 > ]
name
string
organizationID
integer <int64>
scheduledDeletion
any

Responses

Request samples

Content type
application/json
{
  • "admins": [
    ],
  • "assignedUsers": [
    ],
  • "avatar": [
    ],
  • "moderators": [
    ],
  • "name": "string",
  • "organizationID": 0,
  • "scheduledDeletion": null
}

Response samples

Content type
application/json
{
  • "admins": [
    ],
  • "assignedUsers": [
    ],
  • "avatarURL": "string",
  • "eventID": 0,
  • "matrixRoomID": "string",
  • "moderators": [
    ],
  • "name": "string",
  • "organizationID": 0,
  • "scheduledDeletion": null,
  • "type": "string"
}

Creates the default chatroom for an organization.

Authorizations:
API-TOKENPersonal-Access-Token
Request Body schema: application/json
required
organizationID
integer <int64>

Responses

Request samples

Content type
application/json
{
  • "organizationID": 0
}

Response samples

Content type
application/json
{
  • "admins": [
    ],
  • "assignedUsers": [
    ],
  • "avatarURL": "string",
  • "eventID": 0,
  • "matrixRoomID": "string",
  • "moderators": [
    ],
  • "name": "string",
  • "organizationID": 0,
  • "scheduledDeletion": null,
  • "type": "string"
}

Removes the default chatroom for an organization.

Authorizations:
API-TOKENPersonal-Access-Token
path Parameters
organizationID
required
integer

id of the organization

Responses

Returns a specific chatroom.

Authorizations:
API-TOKENPersonal-Access-Token
path Parameters
roomID
required
integer

unique identifier of the chatroom

Responses

Response samples

Content type
application/json
{
  • "admins": [
    ],
  • "assignedUsers": [
    ],
  • "avatarURL": "string",
  • "eventID": 0,
  • "matrixRoomID": "string",
  • "moderators": [
    ],
  • "name": "string",
  • "organizationID": 0,
  • "scheduledDeletion": null,
  • "type": "string"
}

Deletes an existing custom chatroom for an organization.

Authorizations:
API-TOKENPersonal-Access-Token
path Parameters
roomID
required
integer

unique identifier of the chatroom

Responses

Updates chatroom details.

Authorizations:
API-TOKENPersonal-Access-Token
path Parameters
roomID
required
string

unique identifier of the chatroom

Request Body schema: application/json
required
admins
Array of integers <int64> [ items <int64 > ]
assignedUsers
Array of integers <int64> [ items <int64 > ]
avatar
Array of integers <uint8> [ items <uint8 > ]
moderators
Array of integers <int64> [ items <int64 > ]
name
string

Responses

Request samples

Content type
application/json
{
  • "admins": [
    ],
  • "assignedUsers": [
    ],
  • "avatar": [
    ],
  • "moderators": [
    ],
  • "name": "string"
}