TigerGraph

TigerGraph Data API

The Data API from TigerGraph — 5 operation(s) for data.

GitHub OpenAPI

Operations 8

POST /restpp/graph/{graph_name} Upsert vertices and edges #
GET /restpp/graph/{graph_name}/vertices/{vertex_type} List vertices of a type #
DELETE /restpp/graph/{graph_name}/vertices/{vertex_type} Delete vertices of a type #
GET /restpp/graph/{graph_name}/vertices/{vertex_type}/{vertex_id} Retrieve a single vertex #
DELETE /restpp/graph/{graph_name}/vertices/{vertex_type}/{vertex_id} Delete a single vertex #
GET /restpp/graph/{graph_name}/edges/{source_type}/{source_id} List edges from a source vertex #
GET /restpp/graph/{graph_name}/edges/{source_type}/{source_id}/{edge_type}/{target_type}/{target_id} Retrieve a specific edge #
DELETE /restpp/graph/{graph_name}/edges/{source_type}/{source_id}/{edge_type}/{target_type}/{target_id} Delete a specific edge #

Documentation

📖
Documentation
https://docs.tigergraph.com/tigergraph-server/current/api/built-in-endpoints
📖
APIReference
https://docs.tigergraph.com/tigergraph-server/current/api/built-in-endpoints
📖
Documentation
https://docs.tigergraph.com/tigergraph-server/current/API/authentication
📖
Documentation
https://docs.tigergraph.com/savanna/main/
📖
APIReference
https://docs.tigergraph.com/cloud/main/solutions/access-solution/rest-requests

Specifications

⚙
OpenAPI
https://artifacts.apis.io/tigergraph/openapi/tigergraph-data-api-openapi.yml

Other Resources

🔗
PostmanCollection
https://artifacts.apis.io/tigergraph/collections/tigergraph.postman_collection.json
🔗
OpenCollection
https://artifacts.apis.io/tigergraph/collections/tigergraph.opencollection.json
🔗
Plans
https://artifacts.apis.io/tigergraph/plans/tigergraph-plans-pricing.yml

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/tigergraph:tigergraph-data-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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

tigergraph-data-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: TigerGraph REST++ Data API
  description: Specification of the built-in TigerGraph REST++ API exposed by the TigerGraph database server.
  termsOfService: https://www.tigergraph.com/legal/
  contact:
    name: TigerGraph Support
    url: https://www.tigergraph.com/support/
  version: '1.0'
servers:
- url: http://localhost:9000
  description: Self-hosted REST++ server (default port 9000; unified on 14240 in 3.x+)
- url: https://{workspaceId}.i.tgcloud.io:443
  description: TigerGraph Savanna (Cloud) managed workspace over HTTPS
  variables:
    workspaceId:
      default: example
      description: TigerGraph Savanna workspace identifier
security:
- bearerAuth: []
tags:
- name: Data
paths:
  /restpp/graph/{graph_name}:
    post:
      operationId: upsertGraph
      tags:
      - Data
      summary: Upsert vertices and edges
      description: Inserts or updates vertices and/or edges in a graph. If a vertex or edge does not exist it is inserted; if it exists it is updated.
      parameters:
      - $ref: '#/components/parameters/GraphName'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpsertRequest'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RestppResponse'
  /restpp/graph/{graph_name}/vertices/{vertex_type}:
    get:
      operationId: listVertices
      tags:
      - Data
      summary: List vertices of a type
      description: Returns all vertices of the given type, with optional select, filter, limit, and sort.
      parameters:
      - $ref: '#/components/parameters/GraphName'
      - $ref: '#/components/parameters/VertexType'
      - $ref: '#/components/parameters/Select'
      - $ref: '#/components/parameters/Filter'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Sort'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RestppResponse'
    delete:
      operationId: deleteVertices
      tags:
      - Data
      summary: Delete vertices of a type
      parameters:
      - $ref: '#/components/parameters/GraphName'
      - $ref: '#/components/parameters/VertexType'
      - $ref: '#/components/parameters/Filter'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Sort'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RestppResponse'
  /restpp/graph/{graph_name}/vertices/{vertex_type}/{vertex_id}:
    get:
      operationId: getVertex
      tags:
      - Data
      summary: Retrieve a single vertex
      parameters:
      - $ref: '#/components/parameters/GraphName'
      - $ref: '#/components/parameters/VertexType'
      - $ref: '#/components/parameters/VertexId'
      - $ref: '#/components/parameters/Select'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RestppResponse'
    delete:
      operationId: deleteVertex
      tags:
      - Data
      summary: Delete a single vertex
      parameters:
      - $ref: '#/components/parameters/GraphName'
      - $ref: '#/components/parameters/VertexType'
      - $ref: '#/components/parameters/VertexId'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RestppResponse'
  /restpp/graph/{graph_name}/edges/{source_type}/{source_id}:
    get:
      operationId: listEdges
      tags:
      - Data
      summary: List edges from a source vertex
      parameters:
      - $ref: '#/components/parameters/GraphName'
      - $ref: '#/components/parameters/SourceType'
      - $ref: '#/components/parameters/SourceId'
      - $ref: '#/components/parameters/Select'
      - $ref: '#/components/parameters/Filter'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Sort'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RestppResponse'
  /restpp/graph/{graph_name}/edges/{source_type}/{source_id}/{edge_type}/{target_type}/{target_id}:
    get:
      operationId: getEdge
      tags:
      - Data
      summary: Retrieve a specific edge
      parameters:
      - $ref: '#/components/parameters/GraphName'
      - $ref: '#/components/parameters/SourceType'
      - $ref: '#/components/parameters/SourceId'
      - $ref: '#/components/parameters/EdgeType'
      - $ref: '#/components/parameters/TargetType'
      - $ref: '#/components/parameters/TargetId'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RestppResponse'
    delete:
      operationId: deleteEdge
      tags:
      - Data
      summary: Delete a specific edge
      parameters:
      - $ref: '#/components/parameters/GraphName'
      - $ref: '#/components/parameters/SourceType'
      - $ref: '#/components/parameters/SourceId'
      - $ref: '#/components/parameters/EdgeType'
      - $ref: '#/components/parameters/TargetType'
      - $ref: '#/components/parameters/TargetId'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RestppResponse'
components:
  parameters:
    TargetType:
      in: path
      name: target_type
      required: true
      schema:
        type: string
    VertexId:
      in: path
      name: vertex_id
      required: true
      schema:
        type: string
      description: Vertex primary ID.
    Sort:
      in: query
      name: sort
      required: false
      schema:
        type: string
      description: Attribute to sort the results by.
    Select:
      in: query
      name: select
      required: false
      schema:
        type: string
      description: Comma-separated list of attributes to return.
    SourceType:
      in: path
      name: source_type
      required: true
      schema:
        type: string
    Filter:
      in: query
      name: filter
      required: false
      schema:
        type: string
      description: Attribute-based filter expression.
    VertexType:
      in: path
      name: vertex_type
      required: true
      schema:
        type: string
      description: Vertex type name.
    SourceId:
      in: path
      name: source_id
      required: true
      schema:
        type: string
    GraphName:
      in: path
      name: graph_name
      required: true
      schema:
        type: string
      description: Name of the target graph.
    TargetId:
      in: path
      name: target_id
      required: true
      schema:
        type: string
    Limit:
      in: query
      name: limit
      required: false
      schema:
        type: integer
      description: Maximum number of vertices or edges to return.
    EdgeType:
      in: path
      name: edge_type
      required: true
      schema:
        type: string
  schemas:
    RestppResponse:
      type: object
      properties:
        version:
          type: object
        error:
          type: boolean
        message:
          type: string
        results:
          type: array
          items:
            type: object
    UpsertRequest:
      type: object
      properties:
        vertices:
          type: object
        edges:
          type: object
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Bearer token obtained from POST /restpp/requesttoken (required only when token authentication is enabled on the TigerGraph server).