Gainsight External Segments API

External Segment Operations

Documentation GitHub OpenAPI

Operations 3

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /v1/external_segment/metadata Create an external segment · createExternalSegment #

Ask an LLM

“How do I register a segment defined in another system?”

“Can creating an external segment fail if it already exists?”

Tell an agent

Create an external segment named {name} with external ID {externalId}.

Register segment {name}, failing if it exists ({failIfExists}).

PUT /v1/external_segment/metadata Update an external segment · updateExternalSegment #

Ask an LLM

“Can I rename an external segment or change its description?”

“Is it possible to edit the metadata of a segment synced from outside?”

Tell an agent

Rename external segment {id} to {name}.

Update the description of external segment {externalId} to {description}.

POST /v1/external_segment/update_membership Change external segment membership · Update External Segment membership #

Ask an LLM

“What's the way to add users to, or drop them from, an external segment?”

“Can I update segment membership by account instead of by user?”

Tell an agent

Add identities to segments {add} and remove them from {remove}.

Update {identityType} membership: add {add}, remove {remove}.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/gainsight-externalsegments-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  description: Gainsight PX API provides a programmatic (server-based) method to access the users, accounts, and events that have been captured by the Gainsight PX subscription.
  version: 0.1.6
  title: Gainsight PX REST External Segments API
  contact:
    name: Gainsight PX
    url: https://www.gainsight.com/product-experience/
    email: pxsupport@gainsight.com
  license:
    name: internal
servers:
- url: https://api.aptrinsic.com/
tags:
- name: ExternalSegments
  description: External Segment Operations
paths:
  /v1/external_segment/metadata:
    post:
      tags:
      - ExternalSegments
      summary: createExternalSegment
      operationId: createExternalSegmentUsingPOST
      parameters:
      - name: failIfExists
        in: query
        description: failIfExists
        required: false
        schema:
          type: boolean
          default: false
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExternalSegmentDto'
      deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ExternalSegmentDto'
        description: externalSegmentDto
        required: true
    put:
      tags:
      - ExternalSegments
      summary: updateExternalSegment
      operationId: updateExternalSegmentUsingPUT
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExternalSegmentDto'
      deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ExternalSegmentDto'
        description: externalSegmentDto
        required: true
  /v1/external_segment/update_membership:
    post:
      tags:
      - ExternalSegments
      summary: Update External Segment membership
      description: Updates External Segment membership
      operationId: updateMembershipUsingPOST
      responses:
        '200':
          description: Success
        '400':
          description: Bad request, possible duplicate
        '401':
          description: Unauthorized or bad API Key
        '429':
          description: Rate limit exceeded
      deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SegmentPayload'
        description: Segment Payload
        required: true
components:
  schemas:
    ExternalSegmentDto:
      type: object
      properties:
        id:
          type: string
        externalId:
          type: string
        name:
          type: string
        description:
          type: string
      title: ExternalSegmentDto
    SegmentPayload:
      type: object
      required:
      - add
      - remove
      properties:
        add:
          type: array
          description: List of segments to add
          items:
            $ref: '#/components/schemas/SegmentAction'
        identityType:
          type: string
          example: IDENTIFY_ID
          description: Identity type for all identities
          enum:
          - IDENTIFY_ID
          - GLOBAL_ID
        remove:
          type: array
          description: List of segments to remove
          items:
            $ref: '#/components/schemas/SegmentAction'
      title: SegmentPayload
      description: Payload for adding or removing segment identities
    SegmentAction:
      type: object
      required:
      - identities
      - lastQualificationTime
      - segmentId
      properties:
        identities:
          type: array
          description: List of user identity IDs
          items:
            type: string
        lastQualificationTime:
          type: string
          example: '2023-01-12T00:25:15.269332Z'
          description: Last qualification time in ISO 8601 format
        segmentId:
          type: string
          example: 21d7ef5a-77ac-43d0-80c5-0ce1871a5ec7
          description: Segment ID
      title: SegmentAction
      description: Segment action containing segment ID, qualification time, and identities
  securitySchemes:
    X-APTRINSIC-API-KEY:
      type: apiKey
      name: Aptrinsic API Key
      in: header

Gainsight External Segments API

Operations 3

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification