API

Create spot member custom role

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://help-api.meltingspot.io/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "API MCP server": {
    "url": "https://help-api.meltingspot.io/mcp"
  }
}
Close
POST /v1/spotMemberCustomRole

Create spot member custom role

application/json

Body Required

  • label string Required

    The label of the custom role, 20 characters at most.

  • description string

    The description of the custom role, 100 characters at most.

  • permissions array[string] Required

    The permissions of the custom role, at least one.

    Values are live.*, live.full.*, live.limited.*, moderation.*, spot.member.invite.*, course.limited.*, course.full.*, collection.full.*, or collection.limited.*.

Responses

  • 201 application/json

    Spot member custom role been successfully created

    Hide response attributes Show response attributes object
    • id string Required

      The id of the custom role.

    • label string Required

      The label of the custom role.

    • description string Required

      The description of the custom role.

    • permissions array[string] Required

      The permissions of the custom role.

      Values are live.*, live.full.*, live.limited.*, moderation.*, spot.member.invite.*, course.limited.*, course.full.*, collection.full.*, or collection.limited.*.

    • audienceScope string Required

      The members the permissions of the custom role apply to: all the members of the Spot, or only those of some groups. Read only.

      Values are All or GroupsLimited.

    • audienceScopeGroupIds array[string] Required

      The ids of the groups the permissions are limited to when audienceScope is GroupsLimited, empty otherwise. Read only.
  • 400

    Malformed payload

  • 401

    Unauthorized

  • 403

    Forbidden

POST /v1/spotMemberCustomRole 
curl \
 --request POST 'https://openapi.meltingspot.io/v1/spotMemberCustomRole' \
 --header "Content-Type: application/json" \
 --data '{
  "label": "string",
  "description": "string",
  "permissions": [
    "live.*"
  ]
}'
Request examples 
{
  "label": "string",
  "description": "string",
  "permissions": [
    "live.*"
  ]
}
Response examples (201) 
{
  "id": "string",
  "label": "string",
  "description": "string",
  "permissions": [
    "live.*"
  ],
  "audienceScope": "All",
  "audienceScopeGroupIds": [
    "string"
  ]
}