Share via


Default title (Preview)

Provides access to the WordLift GraphQL API, allowing for queries to extract entity data from a Knowledge Graph built with WordLift. Supports a wide range of operations for enhanced data extraction.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name WordLift Support
URL https://wordlift.io
Email support@wordlift.io
Connector Metadata
Publisher WordLift
Website https://wordlift.io
Privacy policy https://wordlift.io/privacy-policy/
Categories AI;Website

WordLift provides a powerful platform to host knowledge graphs, by using the WordLift GraphQL connector users can query and extract data from knowledge graph by leveraging on the flexibility of GraphQL and using the dedicated key associated with a knowledge graph.

Prerequisites

You will need the following to proceed:

  • A WordLift subscription
  • A Knowledge Graph an its related access key
  • Basic GraphQL knowledge

How to get credentials

The Authorization header is required with a value of Key __KEY__ where __KEY__ is a key bound to a Knowledge Graph.

To create a Knowledge Graph and obtain a key connect to wordlift.io and start a new subscription. It takes only a few minutes.

Get started with your connector

To use the WordLift GraphQL connector:

  1. Add it to your automation
  2. When prompted provide the authorization key, prefixed with Key , e.g. if your key is 123 then provide Key 123
  3. Provide the GraphQL query to extract the data as needed
  4. Reuse the data in the required automation scenario

Known issues and limitations

When querying a Knowledge Graph with large amounts of data it is advised to use the rows and page parameter in the query to limit the results to a specifc subset:

query {
  entities(page: 0, rows: 100) {
    ...
  }
}

Common errors and remedies

If you're experiencing 401 unauthenticated errors, please check that you provided authorization data.

If you're experiencing 403 access denied errors, please check that the key is valid and that it's preceded by the Key prefix.

In case of timeouts, try adding the rows: 100, page: 0 parameters to the GraphQL query to limit the number of returned results, e.g.

query {
    entities(rows: 100, page: 0) {
        headline: string(name:"schema:headline")
        description: string(name:"schema:description")
        url: string(name:"schema:url")
    }
}

In case of general errors, check the validity of the GraphQL query.

FAQ

Q: Where do I find my key?

A: If you alredady have an active subscription, go to my.wordlift.io, the list of available keys will be displayed on the home page.

Creating a connection

The connector supports the following authentication types:

Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
API Key securestring The API Key for this api in the form of Key 123 True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Execute a GraphQL query

Provides access to the WordLift GraphQL API, allowing for queries to extract in read-only entity data from a Knowledge Graph built with WordLift. Supports a wide range of operations for enhanced data extraction.

Execute a GraphQL query

Provides access to the WordLift GraphQL API, allowing for queries to extract in read-only entity data from a Knowledge Graph built with WordLift. Supports a wide range of operations for enhanced data extraction.

Parameters

Name Key Required Type Description
Content Type header
Content-Type string

The request content type

Accept header
Accept string

The accept type

query
query string

query