Helpdesk
RoadmapGo to MeltingSpot
English
English
  • To begin
    • 📝Introduction
    • 🗝️Key concepts
    • 👋Join a Spot
    • 🎯Create a Spot
  • Content of a Spot
    • 🏠Home page
    • ▶️Lives
      • ➕Create a live
      • ➕Create a replay
      • 👣Accessing the live's settings
      • ⚙️General settings
      • 🔓Privacy
      • 🎥Video Settings
      • ⚙️Live room settings
      • 💌Invitations & participants
      • 👥Manage guest groups
      • 🎙️Speakers
      • 📩Notifications
      • 🏷️Tags on lives
      • ✔️Register to a live
      • 📋Before starting a live
      • ⏸️Start a live
      • ⏯️Ending a live
      • 📊Live performance metrics
    • 🎓Courses
      • 📂Module
      • ➕Create a course
      • 👣Configuring steps
      • ⁉️Quiz
      • 🛣️Access course parameters
      • ⚙️General settings
      • 💌Invitations & participants
      • 👥Manage guest groups
      • 📩Notifications
      • ✏️Draft mode
      • 📋Take a course
    • 💬Discussions
      • 🔉Creating a channel
      • ⚙️Channel settings
      • ➕Adding and removing members of a channel
      • 🧰Forum
      • 👉Topics in Forums
      • ➕Adding and removing members of a secret forum
      • ⬆️Voting, sorting and searching in Topics
      • 📌Sharing, pinning and marking topic as closed
      • ⬇️Voting, sorting and pinning replies to a Topic
      • 🔔Forum notifications
      • 🖍️Writing a message
      • 👋Mentioning a member
      • ❌Editing or deleting a message
      • 🗣️Replying to a message
      • ❤️Reacting to a message
    • 📚Collections
      • 🆕Manage a collection
      • 🔐Managing members/groups of a private collection
      • 📃Create and delete a page
      • 🔗Add & remove a link
      • ✏️Draft mode
      • 🏷️Tags on documents
    • 👥Members directory
      • 📰Public profile of a member
      • 🤸‍♂️Members' activities
      • 🏷️Tags on members
    • 🗣️Direct messages
    • 🔍Search in Spot
  • Managing a Spot
    • ⚙️Accessing the settings
    • 📊Dashboard
      • 📈Overview
      • 🤿Activities
      • ▶️Lives
    • 👥Audience
      • 👥Members
        • 🎭Member's role
        • 🎓Member's status
        • 📩Invite new members
        • 🗃️Import members
        • 👀Track Registration Sources
        • 💬Bulk Message
        • 🌠Last activity date
        • 👾Custom properties
      • 🧑‍🤝‍🧑Groups
        • ✍️Static Group
        • 🤖Smart Group
      • 👤User rights
        • ⚙️Manage roles
        • 🧢Assign roles to members
        • 🤝Permissions
    • 🏷️Tags
    • 👀Moderation
    • ⚙️General settings
    • 🎨Customization
      • ✨Theme
      • 🏗️Modular Spot
      • 🧑‍💻Scripts
    • 📨Email notifications
    • ❓Registration form
    • 🔗Integrations
      • 🪝Webhooks
      • 🤖API Access
        • 🧑‍🏫REST API
        • 🔦Configuration
        • 🗃️Endpoints - Spot Members
        • 🗃️Endpoints - Lives
        • 🗃️Endpoints - Courses
        • 🗃️Endpoints - Channels
        • 🗃️Endpoints - Forums
        • 🗃️Endpoints - Topics
        • 🗃️Endpoints - Groups
        • 🗃️Endpoints - Tags
        • 🗃️Endpoints - Custom properties
        • 🗃️Endpoints - Search
        • 🗃️Endpoints - Notifications
    • 🧡HubSpot integration
    • 🔑Single Sign-On
    • 🧩Embed
    • 💁‍♂️Widget
      • 📚List of contents
      • 🎓Course
      • 📃Document
      • Page
      • 🧑‍🏫Implementation
  • User Settings
    • 🔔Notification management
      • 💌Email Digest
    • 👤Manage my profiles
    • 🙌Belonging to several Spots
    • 🔔Notification Center
  • Guides
    • 🧐Access MeltingSpot
    • ⏹️Add MeltingSpot to your phone/computer home screen
    • 🔥Create a HubSpot contact for each new Spot registration
    • ✨Notify the start of a live on Slack
    • 📅Send a google calendar invitation to new live participants
    • 🗒️Add new members of your Spot to a Google Sheet
    • ❔How to use the webhook Registration form answered
    • 🔗Embed a Google Form in a page of your Spot
    • 🐞Troubleshooting lives
    • 🐝Accessing your billing space
    • ❓FAQ
Propulsé par GitBook
Sur cette page

Cet article vous a-t-il été utile ?

  1. Managing a Spot
  2. Integrations
  3. API Access

Endpoints - Lives

PrécédentEndpoints - Spot MembersSuivantEndpoints - Courses

Dernière mise à jour il y a 5 mois

Cet article vous a-t-il été utile ?

List lives

Create a live

Delete a live

Update a live

Get a live

Unlike a group from a live

Unlike multiple groups from a live

List groups

Link a group

Link multiple groups

Invite a member as live speaker

Liste live speaker

Invite a member as live participant

List live participants

Invite multiple members as live speaker

Invite multiple members as live participants

🔗
🤖
🗃️
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

Valeurs possibles:
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[eq]string · enumOptionnel

Search Lives with a specific solution

Valeurs possibles:
replay[eq]stringOptionnel

Search Lives with or without replay

builtInType[eq]string · enumOptionnel

Search Lives with a specific BuiltInType

Valeurs possibles:
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
200
Lives returned successfully
application/json
400
Malformed payload
get
GET /v1/lives HTTP/1.1
Host: openapi.meltingspot.io
Accept: */*
{
  "items": [
    {
      "id": "text",
      "title": "text",
      "startDate": "2025-05-15T01:22:21.411Z",
      "endDate": "2025-05-15T01:22:21.411Z",
      "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-05-15T01:22:21.411Z",
      "spotId": "text",
      "builtInConfig": {
        "isRecorded": true,
        "recordAvailable": true,
        "videos": {
          "url": "text",
          "quality": "text",
          "encoding": "hls",
          "createdAt": "2025-05-15T01:22:21.411Z"
        },
        "replayVideo": {}
      }
    }
  ],
  "total": 1
}
delete

Delete a Live

Paramètres de chemin
liveIdstringRequis

The id of the Live

Réponses
204
Live successfully deleted
400
Malformed payload
404
Live not found
delete
DELETE /v1/lives/{liveId} HTTP/1.1
Host: openapi.meltingspot.io
Accept: */*

Aucun contenu

get

Get a Live

Paramètres de chemin
liveIdstringRequis

The id of the Live

Réponses
200
Live found and returned successfully
application/json
400
Malformed payload
404
Live not found
get
GET /v1/lives/{liveId} HTTP/1.1
Host: openapi.meltingspot.io
Accept: */*
{
  "id": "text",
  "title": "text",
  "startDate": "2025-05-15T01:22:21.411Z",
  "endDate": "2025-05-15T01:22:21.411Z",
  "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-05-15T01:22:21.411Z",
  "spotId": "text",
  "builtInConfig": {
    "isRecorded": true,
    "recordAvailable": true,
    "videos": {
      "url": "text",
      "quality": "text",
      "encoding": "hls",
      "createdAt": "2025-05-15T01:22:21.411Z"
    },
    "replayVideo": {}
  }
}
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
204
Group successfully unlink
400
Malformed payload
404
Live or Group not found
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
200
Group returned successfully
application/json
400
Malformed payload
404
Live not found
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

Valeurs possibles:
hasReplayed[eq]stringOptionnel

Search for participants who replayed the Live

hasParticipated[eq]stringOptionnel

Search for participants who participated to the Live

Réponses
200
Live speakers returned successfully
application/json
400
Malformed payload
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-05-15T01:22:21.411Z",
      "registeredAt": "2025-05-15T01:22:21.411Z",
      "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

Valeurs possibles:
status[eq]string · enumOptionnel

Search participants with a specific status

Valeurs possibles:
hasReplayed[eq]stringOptionnel

Search for participants who replayed the Live

hasParticipated[eq]stringOptionnel

Search for participants who participated to the Live

Réponses
200
Live participants returned successfully
application/json
400
Malformed payload
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-05-15T01:22:21.411Z",
      "registeredAt": "2025-05-15T01:22:21.411Z",
      "isHighlighted": true,
      "metrics": {
        "viewTime": 1,
        "hasReplayed": true,
        "hasParticipated": true
      }
    }
  ],
  "total": 1
}
  • List lives
  • GET/v1/lives
  • Create a live
  • POST/v1/lives
  • Delete a live
  • DELETE/v1/lives/{liveId}
  • Update a live
  • PUT/v1/lives/{liveId}
  • Get a live
  • GET/v1/lives/{liveId}
  • Unlike a group from a live
  • DELETE/v1/lives/{liveId}/groups/{groupId}
  • Unlike multiple groups from a live
  • POST/v1/lives/{liveId}/groups~bulkRemove
  • List groups
  • GET/v1/lives/{liveId}/groups
  • Link a group
  • POST/v1/lives/{liveId}/groups
  • Link multiple groups
  • POST/v1/channels/{channelId}/groups~bulkAdd
  • Invite a member as live speaker
  • POST/v1/lives/{liveId}/speakers
  • Liste live speaker
  • GET/v1/lives/{liveId}/speakers
  • Invite a member as live participant
  • POST/v1/lives/{liveId}/participants
  • List live participants
  • GET/v1/lives/{liveId}/participants
  • Invite multiple members as live speaker
  • POST/v1/lives/{liveId}/speakers~bulkInvite
  • Invite multiple members as live participants
  • POST/v1/lives/{liveId}/participants~bulkInvite
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

Valeurs possibles:
builtInTypestring · enum | nullableOptionnel

BuiltIn type of the Live (if solution is BuiltIn)

Valeurs possibles:
videoUrlobject | nullableOptionnel

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

chatVisibilitystring · enumOptionnel

The chat visibility on the Live

Valeurs possibles:
participantsVisibilitystring · enumOptionnel

The participant list visibility on the Live

Valeurs possibles:
visibilitystring · enumOptionnel

The Live visibility

Valeurs possibles:
participationstring · enumOptionnel

Who kind of members can participate to the Live

Valeurs possibles:
recordbooleanOptionnel

Active the record on the Live

Réponses
201
Live has been successfully created
application/json
400
Malformed payload
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-05-15T01:22:21.411Z",
  "endDate": "2025-05-15T01:22:21.411Z",
  "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-05-15T01:22:21.411Z",
  "spotId": "text",
  "builtInConfig": {
    "isRecorded": true,
    "recordAvailable": true,
    "videos": {
      "url": "text",
      "quality": "text",
      "encoding": "hls",
      "createdAt": "2025-05-15T01:22:21.411Z"
    },
    "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

Valeurs possibles:
participantsVisibilitystring · enumOptionnel

The participant list visibility on the Live

Valeurs possibles:
visibilitystring · enumOptionnel

The Live visibility

Valeurs possibles:
participationstring · enumOptionnel

Who kind of members can participate to the Live

Valeurs possibles:
solutionstring · enumRequis

Solution of the Live

Valeurs possibles:
builtInTypestring · enumOptionnel

BuiltIn type of the Live (if solution is BuiltIn)

Valeurs possibles:
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
200
Live successfully updated
application/json
400
Malformed payload
404
Live not found
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-05-15T01:22:21.411Z",
  "endDate": "2025-05-15T01:22:21.411Z",
  "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-05-15T01:22:21.411Z",
  "spotId": "text",
  "builtInConfig": {
    "isRecorded": true,
    "recordAvailable": true,
    "videos": {
      "url": "text",
      "quality": "text",
      "encoding": "hls",
      "createdAt": "2025-05-15T01:22:21.411Z"
    },
    "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
204
Groups successfully unlink
400
Malformed payload
404
Live not found
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
liveIdstringRequis

The id of the Live

Corps
groupIdstringRequis

The id of the group to link

withEmailNotificationbooleanOptionnel

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

Réponses
204
Group linked successfully
400
Malformed payload
404
Live not found
post
POST /v1/lives/{liveId}/groups HTTP/1.1
Host: openapi.meltingspot.io
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "groupId": "text",
  "withEmailNotification": true
}

Aucun contenu

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
204
Groups linked successfully
400
Malformed payload
404
Channel not found
post
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

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

ou
stringOptionnel
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
200
Member already invited & ignored because invalid status
201
Member has been successfully invited
application/json
400
Malformed payload
post
POST /v1/lives/{liveId}/speakers HTTP/1.1
Host: openapi.meltingspot.io
Content-Type: application/json
Accept: */*
Content-Length: 203

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

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
200
Member already invited
201
Member has been successfully invited
application/json
400
Malformed payload
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 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
200
Members has been successfully invited
application/json
400
Malformed payload
413
Payload is too large
post
POST /v1/lives/{liveId}/speakers~bulkInvite HTTP/1.1
Host: openapi.meltingspot.io
Content-Type: application/json
Accept: */*
Content-Length: 131

{
  "invitedBySpotMemberId": "text",
  "highlighted": false,
  "grantHostRights": false,
  "withEmailNotification": false,
  "spotMemberIds": [
    "text"
  ]
}
[
  {
    "id": "text",
    "liveId": "text",
    "spotMemberId": "text",
    "spotMemberEmail": "text",
    "spotMemberFirstname": {},
    "spotMemberLastname": {},
    "status": "Accepted",
    "type": "Participant",
    "invitedAt": "2025-05-15T01:22:21.411Z",
    "registeredAt": "2025-05-15T01:22:21.411Z",
    "isHighlighted": true,
    "metrics": {
      "viewTime": 1,
      "hasReplayed": true,
      "hasParticipated": true
    }
  }
]
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
200
Members has been successfully invited
application/json
400
Malformed payload
413
Payload is too large
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-05-15T01:22:21.411Z",
    "registeredAt": "2025-05-15T01:22:21.411Z",
    "isHighlighted": true,
    "metrics": {
      "viewTime": 1,
      "hasReplayed": true,
      "hasParticipated": true
    }
  }
]