Qlik Sense Impact API

openapi: 3.2.0
info:
  title: lineage-graphs Impact API
  version: ''
servers:
- url: https://{tenant}.{region}.qlikcloud.com
  variables:
    region:
      default: us
      description: The region the tenant is hosted in
    tenant:
      default: your-tenant
      description: Name of the tenant that will be called
tags:
- name: Impact
paths:
  /api/v1/lineage-graphs/impact/{id}/actions/expand:
    get:
      tags:
      - Impact
      summary: Get next-level nodes
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/graphResponse'
          description: Successful Operation.
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorResponse-400'
          description: The request is in incorrect format.
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorResponse-403'
          description: User does not have access to the node.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorResponse-404'
          description: The record is not found.
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorResponse-429'
          headers:
            Retry-After:
              schema:
                type: integer
                example: 15
              description: The number of seconds until new requests are allowed
          description: Too many requests
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorResponse-500'
          description: Internal server error.
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorResponse-503'
          description: Service unavailable
      parameters:
      - in: path
        name: id
        schema:
          type: string
        example: qri:app:sense://e5c651d5-1198-45a2-be5d-f016cee0baf5
        required: true
        description: The QRI for base node.
      - in: query
        name: level
        schema:
          enum:
          - field
          - table
          type: string
          default: table
        required: true
        description: The level to get the nodes on.
      - in: query
        name: node
        schema:
          type: string
        required: true
        description: 'The node in the downstream graph to get next-level nodes for. For instance, to get the TABLE level nodes inside a RESOURCE level node,

          use the RESOURCE level QRI for the node. Similarly, use the TABLE level QRI to get the FIELD level nodes.

          If a TABLE level QRI is used with `level` parameter being `TABLE`, only the RESOURCE level of the node will be

          taken into consideration.

          '
      - in: query
        name: down
        schema:
          type: integer
          default: 5
        required: false
        description: The number of downstream resource levels nodes to retrieve. (5 if not provided, -1 means unlimited and 1 means direct lineage)
      description: Returns next-level nodes inside a specified node on an impact analysis graph retrieved using a base node.
      x-qlik-visibility: public
      x-qlik-stability: stable
      x-qlik-deprecated: false
      x-qlik-tier:
        tier: special
        limit: 20
      operationId: getApiV1LineageGraphsImpactByIdActionsExpand
      x-operation-id-source: derived
  /api/v1/lineage-graphs/impact/{id}/actions/search:
    get:
      tags:
      - Impact
      summary: Search all labels
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/graphsResponse'
          description: Successful Operation.
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorResponse-400'
          description: The request is in incorrect format.
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorResponse-403'
          description: User does not have access to the node.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorResponse-404'
          description: The record is not found.
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorResponse-429'
          headers:
            Retry-After:
              schema:
                type: integer
                example: 15
              description: The number of seconds until new requests are allowed
          description: Too many requests
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorResponse-500'
          description: Internal server error.
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorResponse-503'
          description: Service unavailable
      parameters:
      - in: path
        name: id
        schema:
          type: string
        example: qri:app:sense://e5c651d5-1198-45a2-be5d-f016cee0baf5
        required: true
        description: The qri for root node.
      - in: query
        name: filter
        schema:
          type: string
        example: label co "label1" or label co "label2"
        required: true
        description: 'The expression that matches the SCIM filter format. The filter has to be encoded.

          The currently supported attribute is "label", attribute operator "co" (contains), and grouping operator "or". Example: ''label co "label1" or label co "label2"''. The search queries are case insensetive.

          '
      - in: query
        name: down
        schema:
          type: integer
          default: 5
        required: false
        description: The number of downstream resource levels nodes to search. (5 if not provided, -1 means unlimited) and 1 means direct lineage.
      description: Searchs all labels within a impact graph on all available levels. Returns result per level.
      x-qlik-visibility: public
      x-qlik-stability: stable
      x-qlik-deprecated: false
      x-qlik-tier:
        tier: special
        limit: 20
      operationId: getApiV1LineageGraphsImpactByIdActionsSearch
      x-operation-id-source: derived
  /api/v1/lineage-graphs/impact/{id}/overview:
    get:
      tags:
      - Impact
      summary: Get all RESOURCE level nodes
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/graphResponse'
          description: Successful Operation.
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorResponse-400'
          description: The request is in incorrect format.
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorResponse-403'
          description: User does not have access to the node.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorResponse-404'
          description: The record is not found.
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorResponse-429'
          headers:
            Retry-After:
              schema:
                type: integer
                example: 15
              description: The number of seconds until new requests are allowed
          description: Too many requests
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorResponse-500'
          description: Internal server error.
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorResponse-503'
          description: Service unavailable
      parameters:
      - in: path
        name: id
        schema:
          type: string
        example: qri:app:sense://e5c651d5-1198-45a2-be5d-f016cee0baf5
        required: true
        description: The qri for root node.
      - in: query
        name: down
        schema:
          type: integer
          default: 5
        required: false
        description: The number of downstream resource levels nodes to retrieve. (5 if not provided, -1 means unlimited and 1 means direct lineage)
      description: Returns all RESOURCE level nodes that are impacted by a change in the source node. The number of tables and fields that are impacted for each resource are included as metadata. The id (QRI) can be on any level (FIELD, TABLE or RESOURCE) and the impact will be collected based on the starting QRI.
      x-qlik-visibility: public
      x-qlik-stability: stable
      x-qlik-deprecated: false
      x-qlik-tier:
        tier: special
        limit: 20
      operationId: getApiV1LineageGraphsImpactByIdOverview
      x-operation-id-source: derived
  /api/v1/lineage-graphs/impact/{id}/source:
    get:
      tags:
      - Impact
      summary: Get impact sources
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/graphsResponse'
          description: Successful Operation.
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorResponse-400'
          description: The request is in incorrect format.
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorResponse-403'
          description: User does not have access to the node.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorResponse-404'
          description: The record is not found.
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorResponse-429'
          headers:
            Retry-After:
              schema:
                type: integer
                example: 15
              description: The number of seconds until new requests are allowed
          description: Too many requests
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorResponse-500'
          description: Internal server error.
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorResponse-503'
          description: Service unavailable
      parameters:
      - in: path
        name: id
        schema:
          type: string
        example: qri:app:sense://e5c651d5-1198-45a2-be5d-f016cee0baf5
        required: true
        description: The id (QRI) for root node.
      description: Returns all levels of the requested root node. Only node information will be returned.
      x-qlik-visibility: public
      x-qlik-stability: stable
      x-qlik-deprecated: false
      x-qlik-tier:
        tier: special
        limit: 20
      operationId: getApiV1LineageGraphsImpactByIdSource
      x-operation-id-source: derived
components:
  schemas:
    errorResponse-503:
      type: object
      properties:
        errors:
          type: array
          items:
            type: object
            properties:
              code:
                type: string
                example: HTTP-503
              title:
                type: string
                example: Service Unavailable
              detail:
                type: string
                example: The service is unavailable.
        traceId:
          type: string
          example: e5c651d5-1198-45a2-be5d-f016cee0baf5
    dataAsset:
      type: object
      properties:
        id:
          type: string
          example: qri:app:landing://65083739daf9b2658503f93c
          description: The id (QRI) of the data asset
        type:
          type: string
          example: DI_APP
          description: The type of the data asset
        label:
          type: string
          example: example.Landing.Asset
          description: The lable of the data asset
        subtype:
          type: string
          example: LANDING_SAAS_MANAGED
          description: The subtype of the data asset
      description: The data integration data asset where the node belongs to
    errorResponse-500:
      type: object
      properties:
        errors:
          type: array
          items:
            type: object
            properties:
              code:
                type: string
                example: HTTP-500
              meta:
                type: object
                example: '{"id":"e5c651d5-1198-45a2-be5d-f016cee0baf5"}'
                description: The meta contains additional information when requests fail due to internal errors.
              title:
                type: string
                example: Internal Server Error
              detail:
                type: string
                example: Something went wrong in the server.
        traceId:
          type: string
          example: e5c651d5-1198-45a2-be5d-f016cee0baf5
    errorResponse-404:
      type: object
      properties:
        errors:
          type: array
          items:
            type: object
            properties:
              code:
                type: string
                example: HTTP-404
              title:
                type: string
                example: Not Found
              detail:
                type: string
                example: The resource either never existed, or may have been deleted.
        traceId:
          type: string
          example: e5c651d5-1198-45a2-be5d-f016cee0baf5
    node:
      type: object
      example: '{"label":"a","metadata":{"id":"qri:app:sense://3634fc0d-273d-429e-8d0b-1b4b1b66a1f2","subtype":"PROCESSOR","type":"DA_APP","filePath":"example.qvd"}}'
      properties:
        label:
          type: string
          example: example.qvd
          description: Name label of the node.
        metadata:
          type: object
          required:
          - id
          - type
          properties:
            id:
              type: string
              example: qri:app:sense://3634fc0d-273d-429e-8d0b-1b4b1b66a1f2
              description: The id (QRI) of the node
            type:
              type: string
              example:
              - DA_APP
              - DA_APP_LINK
              - DATASET
              - TABLE
              - FIELD
              description: The type of the node.
            fields:
              type: integer
              example: 1
              description: "The number of fields that are impacted. \nThis will be returned as part of the response from /impact/{id}/overview and /impact/{id}/actions/expand on the table level.\n"
            tables:
              type: integer
              example: 1
              description: "The number of tables that are impacted. \nThis will be returned as part of the response from /impact/{id}/overview.\n"
            subtype:
              type: string
              example:
              - PROCESSOR
              - APPLICATION
              - FILE
              description: The subtype of the node.
            filePath:
              type: string
              example: example.qvd
              description: The file path of a node
            dataAsset:
              $ref: '#/components/schemas/dataAsset'
          description: This contains additional node information such as node types, subtypes, queryExpressions, etc.
    nodes:
      type: object
      example: '{"qri:app:sense://3634fc0d-273d-429e-8d0b-1b4b1b66a1f2":{"label":"a","metadata":{"id":"qri:app:sense://3634fc0d-273d-429e-8d0b-1b4b1b66a1f2","subtype":"PROCESSOR","type":"DA_APP","filePath":"example.qvd"}}}'
      description: All the nodes contained in a graph.
      additionalProperties:
        $ref: '#/components/schemas/node'
    errorResponse-403:
      type: object
      properties:
        errors:
          type: array
          items:
            type: object
            properties:
              code:
                type: string
                example: HTTP-403
              title:
                type: string
                example: Forbidden
              detail:
                type: string
                example: You don't have sufficient permissions to access this resource.
        traceId:
          type: string
          example: e5c651d5-1198-45a2-be5d-f016cee0baf5
    edge:
      type: object
      properties:
        id:
          type:
          - string
          - 'null'
          example: '1'
          description: The index of edges. This is only used in the POST request.
        source:
          type: string
          example: qri:app:sense://e5c651d5-1198-45a2-be5d-f016cee0baf5
          description: The id (QRI) of the source node on this edge.
        target:
          type: string
          example: qri:app:sense://e5c651d5-1198-45a2-be5d-f016cee0baf5
          description: The id (QRI) of the target node on this edge.
        metadata:
          type: object
          properties:
            type:
              type: string
        relation:
          type: string
          example:
          - LOAD
          - STORE
          - READ
          - FROM
    graphsResponse:
      type: object
      title: Response with all graphs
      properties:
        graphs:
          $ref: '#/components/schemas/graphs'
    errorResponse-400:
      type: object
      properties:
        errors:
          type: array
          items:
            type: object
            properties:
              code:
                type: string
                example: HTTP-400
              title:
                type: string
                example: Bad Request
              detail:
                type: string
                example: Something is not right in the request.
        traceId:
          type: string
          example: e5c651d5-1198-45a2-be5d-f016cee0baf5
    graphResponse:
      type: object
      title: Response with a single graph
      properties:
        graph:
          $ref: '#/components/schemas/graph'
    graph:
      type: object
      properties:
        type:
          type: string
          example: RESOURCE
        edges:
          type: array
          items:
            $ref: '#/components/schemas/edge'
        label:
          type: string
          example: Sales Data
          description: Label string for this graph.
        nodes:
          $ref: '#/components/schemas/nodes'
        directed:
          type: boolean
          example: true
          description: Returns true if the graph is directed.
        metadata:
          type: object
          properties:
            total:
              type: integer
              example: 1
              description: The total number of nodes retrieved in this graph.
            createdAt:
              type: string
              example: '2023-10-05T14:48:00.000Z'
              description: The date and time when the graph is created.
            producerId:
              type: string
              example: qri:db:oracle://LfxVj_3du3GYdWdNaa721lOWvbhENXEArBpl58h96YE#ZfH0lkXnTTGu7QGnIvKZpIxFNagQivBtnbC_cAoCPOs
              description: The id (QRI) of the graph producer.
            specVersion:
              type: string
              example: 1
            producerType:
              type: string
              example:
              - QDA
              - EXTERNAL
              description: The type of the graph producer.
      description: The lineage graph containing the node.
    graphs:
      type: object
      title: Graphs
      properties:
        graphs:
          type: array
          items:
            $ref: '#/components/schemas/graph'
      description: The list of lineage graphs.
    errorResponse-429:
      type: object
      properties:
        code:
          type: string
          example: RATE-001
        title:
          type: string
          example: Too many requests
        errors:
          type: array
          items:
            type: object
            properties:
              code:
                type: string
                example: HTTP-429
              title:
                type: string
                example: Too Many Requests
              detail:
                type: string
                example: User rate limited.