Get Content Library

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://px-apidocs.gainsight.com/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json
{
  "gainsight-px-rest-api MCP server": {
    "url": "https://px-apidocs.gainsight.com/mcp"
  }
}

Close
GET /v1/content-library

Fetch metadata for Content Library entries from your PX Subscription. The API provides you with the summary of basic information of each content item that makes it easy to work with specific data.

Results are sorted by last modified date descending by default.

Examples:

URI Results
GET /v1/content-library?pageSize=100 Get first 100 content library entries sorted by last modified date (desc).
GET /v1/content-library?pageSize=100&pageNumber=1 Get next 100 content library entries.
GET /v1/content-library?productId=1234LPSWUBFW Get content library entries of product 1234LPSWUBFW.
GET /v1/content-library?contentId=abcd1234 Get a specific content entry by content ID.
GET /v1/content-library?excludeContentIds=abcd1234&excludeContentIds=efgh5678 Get all content entries except those with the given content IDs.
GET /v1/content-library?sortColumnName=createdDate&sortOrder=ASC Sort by created date ascending.

Important: The default pageSize on list calls is 200. The pageSize can be changed by adding a pageSize parameter to the URL (i.e. /v1/content-library?pageSize=100) with a max pageSize=500.

To fetch a particular page, use the pageNumber parameter (zero based)

Query parameters

  • contentId string

    Content ID

  • contentType string

    Content type filter. One of ARTICLE, LINKED_ARTICLE, LINK, FUNC_CALL, GUIDE, SLIDER, DIALOG, SURVEY, or legacy ENGAGEMENT (all engagements)

    Values are ENGAGEMENT, GUIDE, SLIDER, DIALOG, SURVEY, ARTICLE, LINKED_ARTICLE, LINK, or FUNC_CALL.

  • excludeContentIds array[string]

    Content IDs to exclude from the results

  • pageNumber integer(int32)

    Page number

    Default value is 0.

  • pageSize integer(int32)

    Number of events per page range[1,500]

    Default value is 200.

  • productId string

    Property Group

  • searchTerms string

    Search terms

  • sortColumnName array[string]

    Sort column name

  • sortOrder string

    Sort direction (ASC or DESC, default: DESC)

    Default value is DESC.

Responses

  • 200 application/json

    Success

    Hide response attributes Show response attributes object
    • content array[object]
      Hide content attributes Show content attributes object
      • additionalInfo string
      • articleProvider string

        Values are ARTICLE_PROVIDER_UNDEFINED, ZENDESK_ARTICLE_PROVIDER, HELP_DOCS_ARTICLE_PROVIDER, SALESFORCE_ARTICLE_PROVIDER, MINDTOUCH_ARTICLE_PROVIDER, BLOOMFIRE_ARTICLE_PROVIDER, TI_ARTICLE_PROVIDER, GOOGLE_SEARCH_PROVIDER, HIGHER_LOGIC_PROVIDER, CONTENTFUL_PROVIDER, COVEO_PROVIDER, ZOOM_IN_PROVIDER, or UNRECOGNIZED.

      • contentId string
      • contentType string

        Values are GUIDE, ANNOUNCEMENT, SLIDER, LINK, BOOLEAN_SURVEY, RATING_SURVEY, NPS_SURVEY, CES_SURVEY, MULTIPLE_QUESTION_SURVEY, ARTICLE, KNOWLEDGE_BASE_ARTICLE, CUSTOM_LINK, FUNC_CALL, or COMMUNITY.

      • createdBy object
        Hide createdBy attributes Show createdBy attributes object
        • id string
        • name string
      • createdDate integer(int64)
      • description string
      • displayName string
      • id string
      • imageUrl string
      • lastModifiedBy object
        Hide lastModifiedBy attributes Show lastModifiedBy attributes object
        • id string
        • name string
      • lastModifiedDate integer(int64)
      • name string
    • first boolean
    • last boolean
    • number integer(int32)
    • numberOfElements integer(int32)
    • size integer(int32)
    • sort array[object]
      Hide sort attributes Show sort attributes object
      • direction string
      • property string
    • totalElements integer(int64)
    • totalPages integer(int32)
  • 400

    Bad request

  • 401

    Unauthorized or bad API Key

  • 429

    Rate limit exceeded

GET /v1/content-library
curl \
 --request GET 'https://app.aptrinsic.com/v1/content-library'
Response examples (200)
{
  "content": [
    {
      "additionalInfo": "string",
      "articleProvider": "ARTICLE_PROVIDER_UNDEFINED",
      "contentId": "string",
      "contentType": "GUIDE",
      "createdBy": {
        "id": "string",
        "name": "string"
      },
      "createdDate": 42,
      "description": "string",
      "displayName": "string",
      "id": "string",
      "imageUrl": "string",
      "lastModifiedBy": {
        "id": "string",
        "name": "string"
      },
      "lastModifiedDate": 42,
      "name": "string"
    }
  ],
  "first": true,
  "last": true,
  "number": 42,
  "numberOfElements": 42,
  "size": 42,
  "sort": [
    {
      "direction": "string",
      "property": "string"
    }
  ],
  "totalElements": 42,
  "totalPages": 42
}