🗃️Endpoints - Channels

List channel members

get

List Channel members

Path parameters

channelIdstringrequired

The id of the channel

Query parameters

pageinteger | nullableoptional

The page number in a paginated set of results

limitinteger | nullableoptional

The limit of results to be returned per page

email[in]string[]optional

The emails of spot member to include in the result

firstname[in]string[]optional

The firstnames of spot member to include in the result

lastname[in]string[]optional

The lastnames of spot member to include in the result

role[in]string · enum[]optional

The roles of spot member to include in the result

registrationDate[before]integeroptional

Spot members where registration date is before a specific date (Unix timestamp format)

registrationDate[after]integeroptional

Spot members where registration date is after a specific date (Unix timestamp format)

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://openapi.meltingspot.io/v1/channels/{channelId}/spotMembers'

200

400

200

{
  "items": [
    {
      "id": "text",
      "spotId": "text",
      "userId": "text",
      "email": "text",
      "title": "text",
      "role": "Member",
      "customRoleId": "text",
      "status": "Accepted",
      "firstname": "text",
      "lastname": "text",
      "warnings": 1,
      "embedBaseUrls": {
        "default": "text",
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ],
  "total": 1
}

Channel members returned successfully

Add member to a channel

post

Add member to a channel

Path parameters

channelIdstringrequired

The id of the channel

Body

spotMemberIdstringrequired

An uuid representing the unique identifier of the spot member to add to channel

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://openapi.meltingspot.io/v1/channels/{channelId}/spotMembers' \
  --header 'Content-Type: application/json' \
  --data '{
    "spotMemberId": "text"
  }'

204

400

404

204

No body

Member successfully added

Create a channel

post

Create a channel

Body

namestringrequired

The name of the channel.

descriptionstringoptional

The description of the channel

emojistringoptional

The emoji of the channel

autoJoinbooleanrequired

Whether the channel should be auto-joined by new members.

showMembersbooleanrequired

Whether the channel should show its members.

privacystring · enumrequired

Privacy setting of the channel

Available options:

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://openapi.meltingspot.io/v1/channels' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "text",
    "description": "text",
    "emoji": "text",
    "autoJoin": true,
    "showMembers": true,
    "privacy": "Private"
  }'

201

400

201

{
  "id": "text",
  "name": "text",
  "emoji": "text",
  "description": {},
  "privacy": "Private",
  "autoJoin": true,
  "showMembers": true
}

Channel has been successfully created

List channels

get

List channels

Query parameters

pageinteger | nullableoptional

The page number in a paginated set of results

limitinteger | nullableoptional

The limit of results to be returned per page

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://openapi.meltingspot.io/v1/channels'

200

400

200

{
  "items": [
    {
      "id": "text",
      "name": "text",
      "emoji": "text",
      "description": {},
      "privacy": "Private",
      "autoJoin": true,
      "showMembers": true
    }
  ],
  "total": 1
}

Channels returned successfully

Delete a channel

delete

Delete a channel

Path parameters

channelIdstringrequired

The id of the channel

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url 'https://openapi.meltingspot.io/v1/channels/{channelId}'

204

400

404

204

No body

Channel successfully deleted

Update a channel

put

Update a channel

Path parameters

channelIdstringrequired

The id of the channel

Body

namestringoptional

The name of the channel.

descriptionstringoptional

The description of the channel

emojistringoptional

The emoji of the channel

autoJoinbooleanoptional

Whether the channel should be auto-joined by new members.

showMembersbooleanoptional

Whether the channel should show its members.

privacystring · enumoptional

Privacy setting of the channel

Available options:

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://openapi.meltingspot.io/v1/channels/{channelId}' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "text",
    "description": "text",
    "emoji": "text",
    "autoJoin": true,
    "showMembers": true,
    "privacy": "Private"
  }'

200

400

404

200

{
  "id": "text",
  "name": "text",
  "emoji": "text",
  "description": {},
  "privacy": "Private",
  "autoJoin": true,
  "showMembers": true
}

Channel successfully updated

Get a channel

get

Get a channel

Path parameters

channelIdstringrequired

The id of the channel

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://openapi.meltingspot.io/v1/channels/{channelId}'

200

400

404

200

{
  "id": "text",
  "name": "text",
  "emoji": "text",
  "description": {},
  "privacy": "Private",
  "autoJoin": true,
  "showMembers": true
}

Channel found and returned successfully

Add multiple members to a channel

post

Add members to a channel

Path parameters

channelIdstringrequired

The id of the channel

Body

spotMemberIdsstring[]required

An array of strings representing the unique identifiers of spot members to add to channel

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://openapi.meltingspot.io/v1/channels/{channelId}/spotMembers~bulkAdd' \
  --header 'Content-Type: application/json' \
  --data '{
    "spotMemberIds": [
      "text"
    ]
  }'

200

400

404

200

{
  "addedSpotMemberIds": [
    "text"
  ],
  "failedSpotMemberIds": [
    "text"
  ]
}

Members successfully added

Remove multiple members from a channel

post

Remove members from a channel

Path parameters

channelIdstringrequired

The id of the channel

Body

spotMemberIdsstring[]required

An array of strings representing the unique identifiers of spot members to remove from channel

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://openapi.meltingspot.io/v1/channels/{channelId}/spotMembers~bulkRemove' \
  --header 'Content-Type: application/json' \
  --data '{
    "spotMemberIds": [
      "text"
    ]
  }'

200

400

404

200

{
  "removedSpotMembersCount": 1
}

Members successfully removed

Create multiple channels

post

Create multiple channels

Body

namestringrequired

The name of the channel.

descriptionstringoptional

The description of the channel

emojistringoptional

The emoji of the channel

autoJoinbooleanrequired

Whether the channel should be auto-joined by new members.

showMembersbooleanrequired

Whether the channel should show its members.

privacystring · enumrequired

Privacy setting of the channel

Available options:

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://openapi.meltingspot.io/v1/channels~bulkCreate' \
  --header 'Content-Type: application/json' \
  --data '[
    {
      "name": "text",
      "description": "text",
      "emoji": "text",
      "autoJoin": true,
      "showMembers": true,
      "privacy": "Private"
    }
  ]'

201

400

413

201

{
  "created": [
    {
      "id": "text",
      "name": "text",
      "emoji": "text",
      "description": {},
      "privacy": "Private",
      "autoJoin": true,
      "showMembers": true
    }
  ],
  "failed": [
    {
      "name": "text",
      "description": "text",
      "emoji": "text",
      "autoJoin": true,
      "showMembers": true,
      "privacy": "Private"
    }
  ]
}

Channels has been successfully created

Link a group

post

Link a group

Path parameters

channelIdstringrequired

The id of the channel

Body

groupIdstringrequired

The id of the group to link

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://openapi.meltingspot.io/v1/channels/{channelId}/groups' \
  --header 'Content-Type: application/json' \
  --data '{
    "groupId": "text"
  }'

204

400

404

204

No body

Group linked successfully

List groups linked to a channel

get

list a group

Path parameters

channelIdstringrequired

The id of the channel

Query parameters

pageinteger | nullableoptional

The page number in a paginated set of results

limitinteger | nullableoptional

The limit of results to be returned per page

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://openapi.meltingspot.io/v1/channels/{channelId}/groups'

200

400

404

200

{
  "items": [
    {
      "id": "text",
      "name": "text",
      "description": "text",
      "emoji": "text",
      "icon": "text"
    }
  ],
  "total": 1
}

Group returned successfully

Unlink a group from a channel

delete

Unlink a group from a channel

Path parameters

channelIdstringrequired

The id of the channel

groupIdstringrequired

The id of the group

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url 'https://openapi.meltingspot.io/v1/channels/{channelId}/groups/{groupId}'

204

400

404

204

No body

Group successfully unlink

Link multiple groups to a channel

post

Link groups

Path parameters

channelIdstringrequired

The id of the channel

Body

groupIdsstring[]required

The ids of the groups to link

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://openapi.meltingspot.io/v1/channels/{channelId}/groups~bulkAdd' \
  --header 'Content-Type: application/json' \
  --data '{
    "groupIds": [
      "text"
    ]
  }'

204

400

404

204

No body

Groups linked successfully

Unlink multiple groups from a channel

post

Unlink groups from a channel

Path parameters

channelIdstringrequired

The id of the channel

Body

groupIdsstring[]required

The ids of the groups to link

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://openapi.meltingspot.io/v1/channels/{channelId}/groups~bulkRemove' \
  --header 'Content-Type: application/json' \
  --data '{
    "groupIds": [
      "text"
    ]
  }'

204

400

404

204

No body

Groups successfully unlink