Get a map - Fluid Topics - Latest

Fluid Topics API Reference Guide
Category
Reference Guides
Audience
public
Version
Latest

This web service returns information about a given map.

Method Endpoint
GET 
/api/khub/maps/{mapId}
Path parameter Type Description
{mapId} String Expects the id associated with the map. Users can get the id by listing maps or searching maps.

It is necessary to provide an Ft-Calling-App value when using Fluid Topics web services. See Fluid Topics calling app.

This web service requires authentication on portals with mandatory authentication.

Response body

The following example shows a JSON response body for this web service:

{
  "title": "Fluid Topics API Reference Guide",
  "lang": "en-US",
  "id": "ENQRHyDq~oYAqQn5tJAjKA",
  "originId": "fluid-topics-api-reference-guide",
  "baseId": "fluid-topics-api-reference-guide",
  "lastEdition": "2026-01-26",
  "lastPublication": "2026-01-26T12:53:11.335508",
  "clusterId": "fluid-topics-api-reference-guide",
  "editorialType": "BOOK",
  "khubVersion": "5.0.203",
  "openMode": "FLUIDTOPICS",
  "prettyUrl": "/go/Fluid-Topics-API-Reference-Guide",
  "readerUrl": "/r/Fluid-Topics-API-Reference-Guide",
  "rightsApiEndpoint": "/api/khub/maps/ENQRHyDq~oYAqQn5tJAjKA/rights",
  "topicsApiEndpoint": "/api/khub/maps/ENQRHyDq~oYAqQn5tJAjKA/topics",
  "attachmentsApiEndpoint": "/api/khub/maps/ENQRHyDq~oYAqQn5tJAjKA/attachments",
  "metadata": [
    {
      "key": "author",
      "label": "Author",
      "values": [
        "Clément Guillaume",
        "Dorian Baret",
        "Leanna Inzalaco"
      ]
    },
    {
      "key": "tags",
      "label": "tags",
      "values": [
        "fluid-topics-reference-guide"
      ]
    },
    {
      "key": "Product",
      "label": "Product",
      "values": [
        "Fluid Topics"
      ]
    },
    {
      "key": "Category",
      "label": "Category",
      "values": [
        "Reference Guides"
      ]
    },
    {
      "key": "audience",
      "label": "Audience",
      "values": [
        "public"
      ]
    },
    {
      "key": "media_dir",
      "label": "media_dir",
      "values": [
        "images"
      ]
    },
    {
      "key": "FT_Version",
      "label": "Version",
      "values": [
        "Latest"
      ]
    },
    {
      "key": "Version_FT",
      "label": "Version",
      "values": [
        "Latest"
      ]
    },
    {
      "key": "sourceId_custom",
      "label": "sourceId_custom",
      "values": [
        "md_doc"
      ]
    },
    {
      "key": "ft:publicationId",
      "label": "ft:publicationId",
      "values": [
        "ENQRHyDq~oYAqQn5tJAjKA"
      ]
    },
    {
      "key": "ft:title",
      "label": "ft:title",
      "values": [
        "Fluid Topics API Reference Guide"
      ]
    },
    {
      "key": "ft:locale",
      "label": "ft:locale",
      "values": [
        "en-US"
      ]
    },
    {
      "key": "ft:publication_title",
      "label": "ft:publication_title",
      "values": [
        "Fluid Topics API Reference Guide"
      ]
    },
    {
      "key": "ft:editorialType",
      "label": "Editorial type",
      "values": [
        "book"
      ]
    },
    {
      "key": "ft:openMode",
      "label": "ft:openMode",
      "values": [
        "fluidtopics"
      ]
    },
    {
      "key": "ft:originId",
      "label": "ft:originId",
      "values": [
        "fluid-topics-api-reference-guide"
      ]
    },
    {
      "key": "ft:baseId",
      "label": "ft:baseId",
      "values": [
        "fluid-topics-api-reference-guide"
      ]
    },
    {
      "key": "ft:clusterId",
      "label": "ft:clusterId",
      "values": [
        "fluid-topics-api-reference-guide"
      ]
    },
    {
      "key": "ft:lastEdition",
      "label": "ft:lastEdition",
      "values": [
        "2026-01-26"
      ]
    },
    {
      "key": "ft:lastPublication",
      "label": "ft:lastPublication",
      "values": [
        "2026-01-26T12:53:11.335508"
      ]
    },
    {
      "key": "ft:sourceId",
      "label": "ft:sourceId",
      "values": [
        "md_doc"
      ]
    },
    {
      "key": "ft:sourceName",
      "label": "Source Name",
      "values": [
        "Markdown Product Knowledge"
      ]
    },
    {
      "key": "ft:sourceType",
      "label": "ft:sourceType",
      "values": [
        "Markdown"
      ]
    },
    {
      "key": "ft:sourceCategory",
      "label": "ft:sourceCategory",
      "values": [
        ""
      ]
    },
    {
      "key": "ft:isPublication",
      "label": "ft:isPublication",
      "values": [
        "true"
      ]
    },
    {
      "key": "ft:isUnstructured",
      "label": "ft:isUnstructured",
      "values": [
        "false"
      ]
    },
    {
      "key": "ft:isArticle",
      "label": "ft:isArticle",
      "values": [
        "false"
      ]
    },
    {
      "key": "ft:isBook",
      "label": "ft:isBook",
      "values": [
        "true"
      ]
    },
    {
      "key": "ft:structure",
      "label": "ft:structure",
      "values": [
        "structured"
      ]
    },
    {
      "key": "ft:document_type",
      "label": "ft:document_type",
      "values": [
        "map"
      ]
    },
    {
      "key": "ft:khubVersion",
      "label": "ft:khubVersion",
      "values": [
        "5.0.203"
      ]
    },
    {
      "key": "ft:prettyUrl",
      "label": "ft:prettyUrl",
      "values": [
        "Fluid-Topics-API-Reference-Guide"
      ]
    },
    {
      "key": "ft:outputSize",
      "label": "ft:outputSize",
      "values": [
        "6772"
      ]
    },
    {
      "key": "ft:contentSize",
      "label": "ft:contentSize",
      "values": [
        "3715454"
      ]
    },
    {
      "key": "ft:attachmentsSize",
      "label": "ft:attachmentsSize",
      "values": [
        "0"
      ]
    },
    {
      "key": "ft:publishStatus",
      "label": "ft:publishStatus",
      "values": [
        "visible"
      ]
    },
    {
      "key": "ft:publishUploadId",
      "label": "ft:publishUploadId",
      "values": [
        "99a3bb1a-ae69-4a29-9dcb-67890426ed19"
      ]
    }
  ],
  "contentStyles": {
    "customCssClasses": [],
    "titleStylesheetUrl": "https://docs.fluidtopics.com/stylesheets/content/title.css?v=XXX",
    "topicStylesheetUrl": "https://docs.fluidtopics.com/stylesheets/content/topic.css?v=XXX"
  },
  "pbkConfidential": false,
  "translationError": false
}
Field Type Description
title String The map's title.
lang String The map's locale.
id String The map's unique identifier.
originId String The map's identifier as determined by its origin.
baseId String The map's base identifier.
lastEdition String The date when the map was last modified.
lastPublication String The date when the map was last published.
clusterId String The map's cluster identifier.
editorialType String The map's editorial type.
khubVersion String The version of the processing pipeline last used to publish or reprocess the map.
openMode String The location where the map opens.
prettyUrl String The map's pretty URL if defined.
readerUrl String The URL fragment to use as the Fluid Topics reader entry point for the associated map. It is the pretty URL when available.
rightsApiEndpoint String The path where the map's access rights are available.
topicsApiEndpoint String The path where the map's topics are available.
attachmentsApiEndpoint String The path where the map's attachments are available, if any exist.
metadata Array An array containing the key, values, and label fields. If the metadata's values follow a hierarchical structure, the hierarchical values field is present instead of the values field.
contentStyles Object Information about the content styling.
customCssClasses Array The names of CSS classes as defined for title styles in the Content styles administration interface.
titleStylesheetUrl String A URL pointing to the custom title styles defined in the Content styles administration interface.
topicStylesheetUrl String A URL pointing to the custom topic styles defined in the Content styles administration interface.
pbkConfidential Boolean Shows the possibility of adding a map's topics to a personal book. If true, it is possible to add topics to a personal book. If false, it is not possible
watermark Array An array containing the text, color, and opacity fields when a map is watermarked.
text String The text displayed as a watermark.
color String The color of the watermark expressed in hexadecimal format.
opacity String The opacity of the watermark expressed in percentage. 0 means transparent.
translationError Boolean Indicates whether an error occurred when using the On-demand translation component.
  • This web service returns all metadata, including built-in metadata.
  • An additional optional field, originURL, is only present when the openMode object has the value external.