Endpoints - Les lives

Helpdesk

Roadmap Go to MeltingSpot

get

List Lives

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

title[eq]stringOptionnel

Search Lives with a specific title

title[contains]stringOptionnel

Search Lives that contains this in the title

status[eq]string · enumOptionnel

Search Lives with a specific status

Available options:

startDate[lt]integerOptionnel

Return elements with date before than this

startDate[lte]integerOptionnel

Return elements with date before than or equal to this

startDate[gt]integerOptionnel

Return elements with date after than this

startDate[gte]integerOptionnel

Return elements with date after than or equal to this

startDate[eq]integerOptionnel

Return elements with date equal to this

solution[in]string · enum[]Optionnel

Search Lives with theses types of solution

solution[eq]string · enumOptionnel

Search Lives with a specific solution

Available options:

replay[eq]stringOptionnel

Search Lives with or without replay

builtInType[in]string · enum[]Optionnel

Search Lives with theses types of BuiltInType

builtInType[eq]string · enumOptionnel

Search Lives with a specific BuiltInType

Available options:

averageViewTime[lt]integerOptionnel

Return elements with value lower than this

averageViewTime[lte]integerOptionnel

Return elements with value lower than or equal to this

averageViewTime[gt]integerOptionnel

Return elements with value greater than this

averageViewTime[gte]integerOptionnel

Return elements with value greater than or equal to this

averageViewTime[eq]integerOptionnel

Return elements with value equal to this

invited[lt]integerOptionnel

Return elements with value lower than this

invited[lte]integerOptionnel

Return elements with value lower than or equal to this

invited[gt]integerOptionnel

Return elements with value greater than this

invited[gte]integerOptionnel

Return elements with value greater than or equal to this

invited[eq]integerOptionnel

Return elements with value equal to this

registrant[lt]integerOptionnel

Return elements with value lower than this

registrant[lte]integerOptionnel

Return elements with value lower than or equal to this

registrant[gt]integerOptionnel

Return elements with value greater than this

registrant[gte]integerOptionnel

Return elements with value greater than or equal to this

registrant[eq]integerOptionnel

Return elements with value equal to this

attendee[lt]integerOptionnel

Return elements with value lower than this

attendee[lte]integerOptionnel

Return elements with value lower than or equal to this

attendee[gt]integerOptionnel

Return elements with value greater than this

attendee[gte]integerOptionnel

Return elements with value greater than or equal to this

attendee[eq]integerOptionnel

Return elements with value equal to this

attendanceRate[lt]integerOptionnel

Return elements with value lower than this

attendanceRate[lte]integerOptionnel

Return elements with value lower than or equal to this

attendanceRate[gt]integerOptionnel

Return elements with value greater than this

attendanceRate[gte]integerOptionnel

Return elements with value greater than or equal to this

attendanceRate[eq]integerOptionnel

Return elements with value equal to this

totalReplayView[lt]integerOptionnel

Return elements with value lower than this

totalReplayView[lte]integerOptionnel

Return elements with value lower than or equal to this

totalReplayView[gt]integerOptionnel

Return elements with value greater than this

totalReplayView[gte]integerOptionnel

Return elements with value greater than or equal to this

totalReplayView[eq]integerOptionnel

Return elements with value equal to this

Réponses

application/json

objectOptionnel

get

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

{
  "items": [
    {
      "id": "text",
      "title": "text",
      "startDate": "2025-04-24T08:25:13.078Z",
      "endDate": "2025-04-24T08:25:13.078Z",
      "metrics": {
        "averageViewTime": 1,
        "noShow": 1,
        "totalReplayView": 1,
        "registrant": 1,
        "attendee": 1,
        "attendanceRate": 1,
        "invited": 1
      },
      "description": [
        {
          "type": "p",
          "children": [
            {
              "text": "My new live"
            }
          ]
        }
      ],
      "status": "Ended",
      "computedStatus": "Ended",
      "solution": "Youtube",
      "privacy": {
        "visibility": "AnyOne",
        "participation": "AnySpotMembers"
      },
      "config": {
        "chatVisibility": "Display",
        "participantsVisibility": "Ended"
      },
      "builtInType": "Workshop",
      "videoUrl": {},
      "createdAt": "2025-04-24T08:25:13.078Z",
      "spotId": "text",
      "builtInConfig": {
        "isRecorded": true,
        "recordAvailable": true,
        "videos": {
          "url": "text",
          "quality": "text",
          "encoding": "hls",
          "createdAt": "2025-04-24T08:25:13.078Z"
        },
        "replayVideo": {}
      }
    }
  ],
  "total": 1
}

get

Get a Live

Paramètres de chemin

liveIdstringRequis

The id of the Live

Réponses

application/json

objectOptionnel

get

GET /v1/lives/{liveId} HTTP/1.1
Host: openapi.meltingspot.io
Accept: */*

{
  "id": "text",
  "title": "text",
  "startDate": "2025-04-24T08:25:13.078Z",
  "endDate": "2025-04-24T08:25:13.078Z",
  "metrics": {
    "averageViewTime": 1,
    "noShow": 1,
    "totalReplayView": 1,
    "registrant": 1,
    "attendee": 1,
    "attendanceRate": 1,
    "invited": 1
  },
  "description": [
    {
      "type": "p",
      "children": [
        {
          "text": "My new live"
        }
      ]
    }
  ],
  "status": "Ended",
  "computedStatus": "Ended",
  "solution": "Youtube",
  "privacy": {
    "visibility": "AnyOne",
    "participation": "AnySpotMembers"
  },
  "config": {
    "chatVisibility": "Display",
    "participantsVisibility": "Ended"
  },
  "builtInType": "Workshop",
  "videoUrl": {},
  "createdAt": "2025-04-24T08:25:13.078Z",
  "spotId": "text",
  "builtInConfig": {
    "isRecorded": true,
    "recordAvailable": true,
    "videos": {
      "url": "text",
      "quality": "text",
      "encoding": "hls",
      "createdAt": "2025-04-24T08:25:13.078Z"
    },
    "replayVideo": {}
  }
}

delete

Delete a Live

Paramètres de chemin

liveIdstringRequis

The id of the Live

Réponses

delete

DELETE /v1/lives/{liveId} HTTP/1.1
Host: openapi.meltingspot.io
Accept: */*

Aucun contenu

delete

Unlink a group from a live

Paramètres de chemin

liveIdstringRequis

The id of the Live

groupIdstringRequis

The id of the group

Réponses

delete

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

Aucun contenu

get

Link a group

Paramètres de chemin

liveIdstringRequis

The id of the Live

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

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

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

get

List Live speakers

Paramètres de chemin

liveIdstringRequis

The id of the Live

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

firstname[eq]stringOptionnel

Search participants with a specific firstname

firstname[contains]stringOptionnel

Search participants that contains this in the firstname

lastname[eq]stringOptionnel

Search participants with a specific lastname

lastname[contains]stringOptionnel

Search participants that contains this in the lastname

email[eq]stringOptionnel

Search participants with a specific email

email[contains]stringOptionnel

Search participants that contains this in the email

status[eq]string · enumOptionnel

Search participants with a specific status

Available options:

status[in]string · enum[]Optionnel

Search participants with one of theses status

hasReplayed[eq]stringOptionnel

Search for participants who replayed the Live

hasParticipated[eq]stringOptionnel

Search for participants who participated to the Live

Réponses

application/json

objectOptionnel

get

GET /v1/lives/{liveId}/speakers HTTP/1.1
Host: openapi.meltingspot.io
Accept: */*

{
  "items": [
    {
      "id": "text",
      "liveId": "text",
      "spotMemberId": "text",
      "spotMemberEmail": "text",
      "spotMemberFirstname": {},
      "spotMemberLastname": {},
      "status": "Accepted",
      "type": "Participant",
      "invitedAt": "2025-04-24T08:25:13.078Z",
      "registeredAt": "2025-04-24T08:25:13.078Z",
      "isHighlighted": true,
      "metrics": {
        "viewTime": 1,
        "hasReplayed": true,
        "hasParticipated": true
      }
    }
  ],
  "total": 1
}

get

List Live participants

Paramètres de chemin

liveIdstringRequis

The id of the Live

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

firstname[eq]stringOptionnel

Search participants with a specific firstname

firstname[contains]stringOptionnel

Search participants that contains this in the firstname

lastname[eq]stringOptionnel

Search participants with a specific lastname

lastname[contains]stringOptionnel

Search participants that contains this in the lastname

email[eq]stringOptionnel

Search participants with a specific email

email[contains]stringOptionnel

Search participants that contains this in the email

type[eq]string · enumOptionnel

Search participants with a specific type

Available options:

type[in]string · enum[]Optionnel

Search participants with one of theses types

status[eq]string · enumOptionnel

Search participants with a specific status

Available options:

status[in]string · enum[]Optionnel

Search participants with one of theses status

hasReplayed[eq]stringOptionnel

Search for participants who replayed the Live

hasParticipated[eq]stringOptionnel

Search for participants who participated to the Live

Réponses

application/json

objectOptionnel

get

GET /v1/lives/{liveId}/participants HTTP/1.1
Host: openapi.meltingspot.io
Accept: */*

{
  "items": [
    {
      "id": "text",
      "liveId": "text",
      "spotMemberId": "text",
      "spotMemberEmail": "text",
      "spotMemberFirstname": {},
      "spotMemberLastname": {},
      "status": "Accepted",
      "type": "Participant",
      "invitedAt": "2025-04-24T08:25:13.078Z",
      "registeredAt": "2025-04-24T08:25:13.078Z",
      "isHighlighted": true,
      "metrics": {
        "viewTime": 1,
        "hasReplayed": true,
        "hasParticipated": true
      }
    }
  ],
  "total": 1
}

post

Create a Live

Corps

titlestringRequis

The title of the Live

descriptionstringOptionnel

Description of the Live (in Markdown)

spotMemberHostIdstringRequis

The Spot member host of the Live

startDateintegerRequis

Start date of the Live (Unix timestamp format)

endDateintegerRequis

End date of the Live (Unix timestamp format)

solutionstring · enumRequis

Solution of the Live

Available options:

builtInTypestring · enum | nullableOptionnel

BuiltIn type of the Live (if solution is BuiltIn)

Available options:

videoUrlobject | nullableOptionnel

Video URL of the Live (if solution is Youtube or Vimeo)

chatVisibilitystring · enumOptionnel

The chat visibility on the Live

Available options:

participantsVisibilitystring · enumOptionnel

The participant list visibility on the Live

Available options:

visibilitystring · enumOptionnel

The Live visibility

Available options:

participationstring · enumOptionnel

Who kind of members can participate to the Live

Available options:

recordbooleanOptionnel

Active the record on the Live

Réponses

application/json

objectOptionnel

post

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

{
  "title": "text",
  "description": "text",
  "spotMemberHostId": "text",
  "startDate": 1,
  "endDate": 1,
  "solution": "Youtube",
  "builtInType": "Workshop",
  "videoUrl": {},
  "chatVisibility": "Display",
  "participantsVisibility": "Display",
  "visibility": "AnyOne",
  "participation": "AnySpotMembers",
  "record": true
}

{
  "id": "text",
  "title": "text",
  "startDate": "2025-04-24T08:25:13.078Z",
  "endDate": "2025-04-24T08:25:13.078Z",
  "metrics": {
    "averageViewTime": 1,
    "noShow": 1,
    "totalReplayView": 1,
    "registrant": 1,
    "attendee": 1,
    "attendanceRate": 1,
    "invited": 1
  },
  "description": [
    {
      "type": "p",
      "children": [
        {
          "text": "My new live"
        }
      ]
    }
  ],
  "status": "Ended",
  "computedStatus": "Ended",
  "solution": "Youtube",
  "privacy": {
    "visibility": "AnyOne",
    "participation": "AnySpotMembers"
  },
  "config": {
    "chatVisibility": "Display",
    "participantsVisibility": "Ended"
  },
  "builtInType": "Workshop",
  "videoUrl": {},
  "createdAt": "2025-04-24T08:25:13.078Z",
  "spotId": "text",
  "builtInConfig": {
    "isRecorded": true,
    "recordAvailable": true,
    "videos": {
      "url": "text",
      "quality": "text",
      "encoding": "hls",
      "createdAt": "2025-04-24T08:25:13.078Z"
    },
    "replayVideo": {}
  }
}

put

Update a Live

Paramètres de chemin

liveIdstringRequis

The id of the Live

Corps

titlestringRequis

The title of the Live

descriptionstringOptionnel

Description of the Live (in Markdown)

startDateintegerRequis

Start date of the Live (Unix timestamp format)

endDateintegerRequis

End date of the Live (Unix timestamp format)

chatVisibilitystring · enumOptionnel

The chat visibility on the Live

Available options:

participantsVisibilitystring · enumOptionnel

The participant list visibility on the Live

Available options:

visibilitystring · enumOptionnel

The Live visibility

Available options:

participationstring · enumOptionnel

Who kind of members can participate to the Live

Available options:

solutionstring · enumRequis

Solution of the Live

Available options:

builtInTypestring · enumOptionnel

BuiltIn type of the Live (if solution is BuiltIn)

Available options:

recordbooleanOptionnel

Active the record on the Live

recordAvailablebooleanOptionnel

Make available the record of the Live

videoUrlstringOptionnel

Video URL of the Live (if solution is Youtube or Vimeo)

replayVideoUrlobject | nullableOptionnel

Video URL of the Live (if solution is Youtube or Vimeo)

Réponses

application/json

objectOptionnel

put

PUT /v1/lives/{liveId} HTTP/1.1
Host: openapi.meltingspot.io
Content-Type: application/json
Accept: */*
Content-Length: 301

{
  "title": "text",
  "description": "text",
  "startDate": 1,
  "endDate": 1,
  "chatVisibility": "Display",
  "participantsVisibility": "Display",
  "visibility": "AnyOne",
  "participation": "AnySpotMembers",
  "solution": "Youtube",
  "builtInType": "Workshop",
  "record": true,
  "recordAvailable": true,
  "videoUrl": "text",
  "replayVideoUrl": {}
}

{
  "id": "text",
  "title": "text",
  "startDate": "2025-04-24T08:25:13.078Z",
  "endDate": "2025-04-24T08:25:13.078Z",
  "metrics": {
    "averageViewTime": 1,
    "noShow": 1,
    "totalReplayView": 1,
    "registrant": 1,
    "attendee": 1,
    "attendanceRate": 1,
    "invited": 1
  },
  "description": [
    {
      "type": "p",
      "children": [
        {
          "text": "My new live"
        }
      ]
    }
  ],
  "status": "Ended",
  "computedStatus": "Ended",
  "solution": "Youtube",
  "privacy": {
    "visibility": "AnyOne",
    "participation": "AnySpotMembers"
  },
  "config": {
    "chatVisibility": "Display",
    "participantsVisibility": "Ended"
  },
  "builtInType": "Workshop",
  "videoUrl": {},
  "createdAt": "2025-04-24T08:25:13.078Z",
  "spotId": "text",
  "builtInConfig": {
    "isRecorded": true,
    "recordAvailable": true,
    "videos": {
      "url": "text",
      "quality": "text",
      "encoding": "hls",
      "createdAt": "2025-04-24T08:25:13.078Z"
    },
    "replayVideo": {}
  }
}

post

Unlink groups from a live

Paramètres de chemin

liveIdstringRequis

The id of the Live

Corps

groupIdsstring[]Requis

The ids of the groups to link

Réponses

post

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

{
  "groupIds": [
    "text"
  ]
}

Aucun contenu

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

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

{
  "groupId": "text"
}

Aucun contenu

post

Link groups

Paramètres de chemin

liveIdstringRequis

The id of the Live

Corps

groupIdsstring[]Requis

The ids of the groups to link

withEmailNotificationbooleanOptionnel

To send an email notification to each added member. Disable by default.

Réponses

post

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

{
  "groupIds": [
    "text"
  ],
  "withEmailNotification": true
}

Aucun contenu

post

Invite a member as Live participant

Paramètres de chemin

liveIdstringRequis

The id of the Live

Corps

memberstringRequis

Member to invite as Live participant from email address or existing Spot member ID

invitedBySpotMemberIdstringOptionnel

The Spot member ID on the initiative of the invitation

withEmailNotificationbooleanOptionnel

Set to true to send notification mail to each invited members

Réponses

application/json

post

POST /v1/lives/{liveId}/participants HTTP/1.1
Host: openapi.meltingspot.io
Content-Type: application/json
Accept: */*
Content-Length: 77

{
  "member": "text",
  "invitedBySpotMemberId": "text",
  "withEmailNotification": true
}

Aucun contenu

post

Invite multiple members as Live participant

Paramètres de chemin

liveIdstringRequis

The id of the Live

Corps

invitedBySpotMemberIdstringOptionnel

The Spot member ID on the initiative of the invitation

withEmailNotificationbooleanOptionnel

Set to true to send notification mail to each invited members

membersall ofRequis

Members to invite

Réponses

application/json

object[]Optionnel

post

POST /v1/lives/{liveId}/participants~bulkInvite HTTP/1.1
Host: openapi.meltingspot.io
Content-Type: application/json
Accept: */*
Content-Length: 116

{
  "invitedBySpotMemberId": "text",
  "withEmailNotification": true,
  "members": {
    "spotMemberIds": [
      "text"
    ],
    "emails": [
      "text"
    ]
  }
}

[
  {
    "id": "text",
    "liveId": "text",
    "spotMemberId": "text",
    "spotMemberEmail": "text",
    "spotMemberFirstname": {},
    "spotMemberLastname": {},
    "status": "Accepted",
    "type": "Participant",
    "invitedAt": "2025-04-24T08:25:13.078Z",
    "registeredAt": "2025-04-24T08:25:13.078Z",
    "isHighlighted": true,
    "metrics": {
      "viewTime": 1,
      "hasReplayed": true,
      "hasParticipated": true
    }
  }
]

post

Invite a member as Live speaker

Paramètres de chemin

liveIdstringRequis

The id of the Live

Corps

memberone ofRequis

Member to invite as Live participant from email address or existing Spot member ID

invitedBySpotMemberIdstringOptionnel

The Spot member ID on the initiative of the invitation

highlightedbooleanOptionnel

Set to true to highlight the Speaker.

Default: false

grantHostRightsbooleanOptionnel

Set to true to grant Host rights to the Speaker.

Default: false

withEmailNotificationbooleanOptionnel

Set to true to send notification mail to each invited members

Default: false

Réponses

application/json

post

POST /v1/lives/{liveId}/speakers HTTP/1.1
Host: openapi.meltingspot.io
Content-Type: application/json
Accept: */*
Content-Length: 200

{
  "member": {
    "email": "text",
    "firstName": "text",
    "lastName": "text",
    "title": "text",
    "biography": "text"
  },
  "invitedBySpotMemberId": "text",
  "highlighted": true,
  "grantHostRights": true,
  "withEmailNotification": true
}

Aucun contenu

post

Invite multiple members as Live speaker

Paramètres de chemin

liveIdstringRequis

The id of the Live

Corps

invitedBySpotMemberIdstringOptionnel

The Spot member ID on the initiative of the invitation

highlightedbooleanOptionnel

Set to true to highlight the Speaker.

Default: false

grantHostRightsbooleanOptionnel

Set to true to grant Host rights to the Speaker.

Default: false

withEmailNotificationbooleanOptionnel

Set to true to send notification mail to each invited members

Default: false

spotMemberIdsstring[]Requis

Spot members to invite as Live speaker

Réponses

application/json

object[]Optionnel

post

POST /v1/lives/{liveId}/speakers~bulkInvite HTTP/1.1
Host: openapi.meltingspot.io
Content-Type: application/json
Accept: */*
Content-Length: 128

{
  "invitedBySpotMemberId": "text",
  "highlighted": true,
  "grantHostRights": true,
  "withEmailNotification": true,
  "spotMemberIds": [
    "text"
  ]
}

[
  {
    "id": "text",
    "liveId": "text",
    "spotMemberId": "text",
    "spotMemberEmail": "text",
    "spotMemberFirstname": {},
    "spotMemberLastname": {},
    "status": "Accepted",
    "type": "Participant",
    "invitedAt": "2025-04-24T08:25:13.078Z",
    "registeredAt": "2025-04-24T08:25:13.078Z",
    "isHighlighted": true,
    "metrics": {
      "viewTime": 1,
      "hasReplayed": true,
      "hasParticipated": true
    }
  }
]

Endpoints - Les lives

Lister les lives du Spot

Créer un Live

Récupérer un live du Spot

Modifier un live du Spot

Supprimer un live du Spot

Désassocier un groupe d'un live

Désassocier plusieurs groupes d'un live

Lister les groupes d'un live

Associer un groupe à un live

Associer plusieurs groupes à un live

Lister les speakers d'un live

Lister les participants d'un live

Inviter un membre au live

Inviter plusieurs membres à un live

Inviter un speaker à un live

Inviter plusieurs speakers à un live

Lister les lives du Spot

Créer un Live

Récupérer un live du Spot

Modifier un live du Spot

Supprimer un live du Spot

Désassocier un groupe d'un live

Désassocier plusieurs groupes d'un live

Lister les groupes d'un live

Associer un groupe à un live

Associer plusieurs groupes à un live

Lister les speakers d'un live

Lister les participants d'un live

Inviter un membre au live

Inviter plusieurs membres à un live

Inviter un speaker à un live

Inviter plusieurs speakers à un live