API

List topics

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
GET /v1/forums/{forumId}/topics

List topics

Path parameters

  • forumId string Required

    The id of the forum

Query parameters

  • page integer | null

    The page number in a paginated set of results

  • limit integer | null

    The limit of results to be returned per page

    Maximum value is 250.

  • name object

    Filters on name

    Hide name attributes Show name attributes object
    • name[eq] string

      Search Topic with a specified name

    • name[contains] string

      Search Topic that contains this value in his name

Responses

  • 200 application/json

    Topics returned successfully

    Hide response attributes Show response attributes object
    • items array[object] Required

      The items found

      Hide items attributes Show items attributes object
      • id string Required

        The id of the topic.

      • name string Required

        The name of the topic.

      • closedAt integer | null Required

        Date at which the topic has been closed (Unix timestamp format), or null if the topic is active

      • forumId string Required

        The id of the forum of the topic.

      • createdAt integer Required

        Timestamp in ms of creation date

      • contentMarkdown string Required

        Content of the topic, in Markdown. Empty when the topic has no content.

      • author object Required

        The author of the topic, or null when the author cannot be found (e.g. member deleted).

        Hide author attributes Show author attributes object
        • firstName string Required

          The firstName of the author.

        • lastName string Required

          The lastName of the author.

        • profilePicture string | null Required

          The profile picture of the author.

        • spotMemberId string Required

          The spotMemberId of the author.

    • total integer Required

      The total number of items found
  • 400

    Malformed payload

  • 401

    Unauthorized

  • 403

    Forbidden

  • 404

    Forum not found

GET /v1/forums/{forumId}/topics 
curl \
 --request GET 'https://openapi.meltingspot.io/v1/forums/{forumId}/topics'
Response examples (200) 
{
  "items": [
    {
      "id": "string",
      "name": "string",
      "closedAt": 42,
      "forumId": "string",
      "createdAt": 42,
      "contentMarkdown": "string",
      "author": {
        "firstName": "string",
        "lastName": "string",
        "profilePicture": "string",
        "spotMemberId": "string"
      }
    }
  ],
  "total": 42
}