Q&A

Create a new Topic

Meeting role required: owner, presenter or ideas-manager.

post/v1/meetings/{meetingId}/ideas/sessions

Request

  • Base URL: https://app.meet.ps/api
  • URL: https://app.meet.ps/api/v1/meetings/{meetingId}/ideas/sessions
  • Auth: HTTP bearer

Path parameters

meetingIdstring required

A canonical meeting ID string that's generated automatically for new meetings. Normally consists of just alphanumericals; legacy meetings can have dashes and underscores.

Example:kr9gui27

Meeting name string

Request body

OCCstring

Pin a Topic to the meeting navbar.

anonymousboolean

Anonymize the name of the contribution submitter.

calloutstring

Custom CTA for attendee to submit item

commentableboolean

Defines whether comments can be posted on contributions.

descriptionstring

Description of the topic.

downvotableboolean

Allow downvote to submitted contributions.

emailstring

Setting up email notification when new contributions arrive.

emailOffsetinteger

Timezone offset in minutes from UTC, to be applied to timestamps used in the email template.

endscreenMessagestring

Thank you message to show when attendee has submitted their contribution.

endscreenMessageEnabledboolean

Enable thank you message.

maxLengthinteger nullable

Maximum number of characters per attendee submission. Empty means no limit.

maxLengthEnabledboolean

Enable the submission length limit.

hidePublicboolean

Hide the contribution voting result.

hideSubmissionsboolean

Hide all submitted contributions in a topic.

icon'connect' | 'lightbulb-thick' | 'heart' | 'message-bubble-ellipsis' | 'message-bubble-pop' | 'chart-columns' | 'bookmark' | 'star'

Icon to represent a topic.

moderatedboolean

All submitted contributions will be added to moderation state.

newestLastboolean

Show new contribution at the end of the list.

numChildreninteger

Number of contribution that have been posted in a topic session

speakerboolean

Show the topic to speaker navbar.

textstring

Topic title

timestampinteger

Creation timestamp, in millisecond.

upvotableboolean

Allow upvote on to submitted contributions.

visibleboolean

Show the topic to meeting participants.

readonlyboolean

Whether new contributions and comments can be posted under this topic.

votingMode0 | 1 | 2 | 3

Mode of voting 0 - No voting, 1 - 5-star rating, 2 - Upvoting only, 3 - Upvoting & downvoting

idstring

Topic ID

Example request

{
  "OCC": "Topic A",
  "callout": "Submit your contribution here",
  "commentable": true,
  "description": "This is a description about Topic A",
  "downvotable": true,
  "email": "john.doe@example.com",
  "emailOffset": -420,
  "endscreenMessage": "Thank you for your contribution! We appreciate your feedback.",
  "endscreenMessageEnabled": true,
  "maxLength": 280,
  "icon": "message-bubble-pop",
  "moderated": true,
  "numChildren": 3,
  "speaker": true,
  "text": "Q&A about Topic A",
  "timestamp": 1640794623587,
  "upvotable": true,
  "visible": true,
  "votingMode": 3,
  "id": "-MJ313d7pNPpxTtbP35F"
}

Response

Example response

{
  "result": {
    "OCC": "Topic A",
    "callout": "Submit your contribution here",
    "commentable": true,
    "description": "This is a description about Topic A",
    "downvotable": true,
    "email": "john.doe@example.com",
    "emailOffset": -420,
    "endscreenMessage": "Thank you for your contribution! We appreciate your feedback.",
    "endscreenMessageEnabled": true,
    "maxLength": 280,
    "icon": "message-bubble-pop",
    "moderated": true,
    "numChildren": 3,
    "speaker": true,
    "text": "Q&A about Topic A",
    "timestamp": 1640794623587,
    "upvotable": true,
    "visible": true,
    "votingMode": 3,
    "id": "-MJ313d7pNPpxTtbP35F"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.