🗃️Endpoints - Channels

List channel members

get

List Channel members

Paramètres de chemin

channelIdstringRequis

The id of the channel

Paramètres de requête

pageinteger | nullableOptionnel

The page number in a paginated set of results

limitinteger | nullableOptionnel

The limit of results to be returned per page

email[in]string[]Optionnel

The emails of spot member to include in the result

firstname[in]string[]Optionnel

The firstnames of spot member to include in the result

lastname[in]string[]Optionnel

The lastnames of spot member to include in the result

role[in]string · enum[]Optionnel

The roles of spot member to include in the result

registrationDate[before]integerOptionnel

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

registrationDate[after]integerOptionnel

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

Réponses

application/json

objectOptionnel

get

HTTPcURLJavaScriptPython

GET /v1/channels/{channelId}/spotMembers HTTP/1.1
Host: openapi.meltingspot.io
Accept: */*

{
  "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
}

Add member to a channel

post

Add member to a channel

Paramètres de chemin

channelIdstringRequis

The id of the channel

Corps

spotMemberIdstringRequis

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

Réponses

post

HTTPcURLJavaScriptPython

POST /v1/channels/{channelId}/spotMembers HTTP/1.1
Host: openapi.meltingspot.io
Content-Type: application/json
Accept: */*
Content-Length: 23

{
  "spotMemberId": "text"
}

Aucun contenu

Create a channel

post

Create a channel

Corps

namestringRequis

The name of the channel.

descriptionstringOptionnel

The description of the channel

emojistringOptionnel

The emoji of the channel

autoJoinbooleanRequis

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

showMembersbooleanRequis

Whether the channel should show its members.

privacystring · enumRequis

Privacy setting of the channel

Available options:

Réponses

application/json

objectOptionnel

post

HTTPcURLJavaScriptPython

POST /v1/channels HTTP/1.1
Host: openapi.meltingspot.io
Content-Type: application/json
Accept: */*
Content-Length: 106

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

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

List channels

get

List channels

Paramètres de requête

pageinteger | nullableOptionnel

The page number in a paginated set of results

limitinteger | nullableOptionnel

The limit of results to be returned per page

Réponses

application/json

objectOptionnel

get

HTTPcURLJavaScriptPython

GET /v1/channels HTTP/1.1
Host: openapi.meltingspot.io
Accept: */*

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

Delete a channel

delete

Delete a channel

Paramètres de chemin

channelIdstringRequis

The id of the channel

Réponses

delete

HTTPcURLJavaScriptPython

DELETE /v1/channels/{channelId} HTTP/1.1
Host: openapi.meltingspot.io
Accept: */*

Aucun contenu

Update a channel

put

Update a channel

Paramètres de chemin

channelIdstringRequis

The id of the channel

Corps

namestringOptionnel

The name of the channel.

descriptionstringOptionnel

The description of the channel

emojistringOptionnel

The emoji of the channel

autoJoinbooleanOptionnel

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

showMembersbooleanOptionnel

Whether the channel should show its members.

privacystring · enumOptionnel

Privacy setting of the channel

Available options:

Réponses

application/json

objectOptionnel

put

HTTPcURLJavaScriptPython

PUT /v1/channels/{channelId} HTTP/1.1
Host: openapi.meltingspot.io
Content-Type: application/json
Accept: */*
Content-Length: 106

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

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

Get a channel

get

Get a channel

Paramètres de chemin

channelIdstringRequis

The id of the channel

Réponses

application/json

objectOptionnel

get

HTTPcURLJavaScriptPython

GET /v1/channels/{channelId} HTTP/1.1
Host: openapi.meltingspot.io
Accept: */*

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

Add multiple members to a channel

post

Add members to a channel

Paramètres de chemin

channelIdstringRequis

The id of the channel

Corps

spotMemberIdsstring[]Requis

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

Réponses

application/json

objectOptionnel

post

HTTPcURLJavaScriptPython

POST /v1/channels/{channelId}/spotMembers~bulkAdd HTTP/1.1
Host: openapi.meltingspot.io
Content-Type: application/json
Accept: */*
Content-Length: 26

{
  "spotMemberIds": [
    "text"
  ]
}

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

Remove multiple members from a channel

post

Remove members from a channel

Paramètres de chemin

channelIdstringRequis

The id of the channel

Corps

spotMemberIdsstring[]Requis

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

Réponses

application/json

objectOptionnel

post

HTTPcURLJavaScriptPython

POST /v1/channels/{channelId}/spotMembers~bulkRemove HTTP/1.1
Host: openapi.meltingspot.io
Content-Type: application/json
Accept: */*
Content-Length: 26

{
  "spotMemberIds": [
    "text"
  ]
}

{
  "removedSpotMembersCount": 1
}

Create multiple channels

post

Create multiple channels

Corps

namestringRequis

The name of the channel.

descriptionstringOptionnel

The description of the channel

emojistringOptionnel

The emoji of the channel

autoJoinbooleanRequis

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

showMembersbooleanRequis

Whether the channel should show its members.

privacystring · enumRequis

Privacy setting of the channel

Available options:

Réponses

application/json

objectOptionnel

post

HTTPcURLJavaScriptPython

POST /v1/channels~bulkCreate HTTP/1.1
Host: openapi.meltingspot.io
Content-Type: application/json
Accept: */*
Content-Length: 108

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

{
  "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"
    }
  ]
}

Link a group

post

Link a group

Paramètres de chemin

channelIdstringRequis

The id of the channel

Corps

groupIdstringRequis

The id of the group to link

Réponses

post

HTTPcURLJavaScriptPython

POST /v1/channels/{channelId}/groups HTTP/1.1
Host: openapi.meltingspot.io
Content-Type: application/json
Accept: */*
Content-Length: 18

{
  "groupId": "text"
}

Aucun contenu

List groups linked to a channel

get

list a group

Paramètres de chemin

channelIdstringRequis

The id of the channel

Paramètres de requête

pageinteger | nullableOptionnel

The page number in a paginated set of results

limitinteger | nullableOptionnel

The limit of results to be returned per page

Réponses

application/json

objectOptionnel

get

HTTPcURLJavaScriptPython

GET /v1/channels/{channelId}/groups HTTP/1.1
Host: openapi.meltingspot.io
Accept: */*

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

Unlink a group from a channel

delete

Unlink a group from a channel

Paramètres de chemin

channelIdstringRequis

The id of the channel

groupIdstringRequis

The id of the group

Réponses

delete

HTTPcURLJavaScriptPython

DELETE /v1/channels/{channelId}/groups/{groupId} HTTP/1.1
Host: openapi.meltingspot.io
Accept: */*

Aucun contenu

Link multiple groups to a channel

post

Link groups

Paramètres de chemin

channelIdstringRequis

The id of the channel

Corps

groupIdsstring[]Requis

The ids of the groups to link

Réponses

post

HTTPcURLJavaScriptPython

POST /v1/channels/{channelId}/groups~bulkAdd HTTP/1.1
Host: openapi.meltingspot.io
Content-Type: application/json
Accept: */*
Content-Length: 21

{
  "groupIds": [
    "text"
  ]
}

Aucun contenu

Unlink multiple groups from a channel

post

Unlink groups from a channel

Paramètres de chemin

channelIdstringRequis

The id of the channel

Corps

groupIdsstring[]Requis

The ids of the groups to link

Réponses

post

HTTPcURLJavaScriptPython

POST /v1/channels/{channelId}/groups~bulkRemove HTTP/1.1
Host: openapi.meltingspot.io
Content-Type: application/json
Accept: */*
Content-Length: 21

{
  "groupIds": [
    "text"
  ]
}

Aucun contenu