Messenger API specification (887cf3d4f37487346e33ee5d2c4aee5e8f74aa6e)

Download OpenAPI specification:Download

The chat service manages chatrooms for our mobile messenger app.

Authentication

API_Token

You can generate an API-Token in the permissions-settings of your organization. All requests will be performed in the scope of this organization. Requests regarding users will fail.

Security Scheme Type API Key
Header parameter name: API-TOKEN

Personal-Access-Token

You can generate a Personal Access Token in your profile settings. All requests will be performed as the user who created the token, with permissions as configured in each organization.

Security Scheme Type API Key
Header parameter name: Personal-Access-Token

chatroom

Returns a specific chatroom searched by eventID in a specific organization.

query Parameters
organization_id
required
integer

id of an organization the chatroom belongs to

event_id
required
integer

id of an organization the chatroom belongs to

Responses

Response samples

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

chatrooms

Returns either a paginated list of all organization chatrooms or a complete list of all assigned chatrooms for a user.

query Parameters
organization_id
integer

optional organization id, returns all chatrooms for the organization if set

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.

Request Body schema: application/json
assignedUsers
Array of integers <int64> [ items <int64 > ]
name
string
organizationID
integer <int64>

Responses

Request samples

Content type
application/json
{
  • "assignedUsers": [
    ],
  • "name": "string",
  • "organizationID": 0
}

Response samples

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

Creates the default chatroom for an organization.

path Parameters
organizationID
required
integer

id of the organization

Responses

Response samples

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

Removes the default chatroom for an organization.

path Parameters
organizationID
required
integer

id of the organization

Responses

Returns a specific chatroom.

path Parameters
roomID
required
integer

unique identifier of the chatroom

Responses

Response samples

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

Updates an existing custom chatroom for an organization.

path Parameters
roomID
required
integer

unique identifier of the chatroom

Request Body schema: application/json
assignedUsers
Array of integers <int64> [ items <int64 > ]
name
string
organizationID
integer <int64>

Responses

Request samples

Content type
application/json
{
  • "assignedUsers": [
    ],
  • "name": "string",
  • "organizationID": 0
}

Deletes an existing custom chatroom for an organization.

path Parameters
roomID
required
integer

unique identifier of the chatroom

Responses

Sets a new avatar for an existing custom chatroom for an organization.

Send an empty body to remove the avatar.

path Parameters
roomID
required
integer

unique identifier of the chatroom

Request Body schema: application/json
string <binary>

Responses

Request samples

Content type
application/json
"string"

Sends a text message to a chatroom.

path Parameters
roomID
required
integer

unique identifier of the chatroom

Request Body schema: application/json
message
string

Responses

Request samples

Content type
application/json
{
  • "message": "string"
}