Nintex public API

Queries in GraphQL define the available operations that you can perform on your GraphQL API. They specify the structure of the data you can request and retrieve from the API. With queries, you can define the specific information you want to retrieve from the API, allowing you to ask for exactly what you need and receive a tailored response.

• Read query: A read query in GraphQL is used to retrieve data from a GraphQL API. It allows you to fetch and read data without making any changes. You specify the fields and relationships of the data you want to retrieve and receive a response with the requested data.

  Example: 

  • getQueue (queue: GetQueueInput!): Queue

  • getQueues (queues: GetQueuesInput!): [Queue]

  • taskById (taskId: ID!): TaskState

  • getTrigger (trigger: GetTriggerInput!): Trigger

  • getWizards (wizards: GetWizardsInput!): [Wizard]

• Mutation/edit query: In GraphQL, a mutation, like an edit query, changes or updates data on the API, resembling traditional API actions such as HTTP POST, PATCH, PUT, or DELETE requests. It allows you to create, update, or delete data by specifying which parts of the information you want to change and what values to use. The response you get indicates if the changes worked, ensuring consistent modifications.

  Example: 

  • addQueue (queue: AddQueueInput): Queue

  • updateQueue (queue: UpdateQueueInput): Queue

  • addTask (task: AddTaskInput!): Task

  • reassignTaskToQueue (task: ReassignTaskToQueueInput!): Task

The GraphQL API schema serves as a blueprint, outlining the structure and functionality of our public APIs. It provides a clear overview of available data types, queries, and mutations, to guide you on how to interact with our APIs.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
enum StatusType { 
  PENDING
  PROCESSING
  SUCCEEDED
  FAILED
}
    
type Status {
    id: ID!
    tenantId: ID!
    status: StatusType!
    type: String!
    subType: String!
    metadata: JSON
}

input SortDescriptor {
    field : String!,
    dir: SortDirection!
}

input QueryInput {
    filter: FilterDescriptorType!
    skip: Int,
    sort: [SortDescriptor]!,
    take: Int
}

input FilterDescriptorType {
    field: String = null,
    value: Any = null,
    logic: LogicalOperator = null,
    operator: FilterOperator = null,
    filters: [FilterDescriptorType] = null
}

enum SortDirection {
    DESC,
    ASC
}

enum FilterOperator {
    EQ
    NEQ
    IN
    NIN
    CONTAINS
    GT
    LT
    GTE
    LTE
    ISNULL
    STARTSWITH
    DOESNOTCONTAIN
    ENDSWITH
    IMATCH
}
    
enum LogicalOperator {
    AND
    OR
}

In GraphQL, an endpoint is the URL where you send your GraphQL requests to interact with the API. It's like the gateway to the GraphQL service, allowing you to perform queries, mutations, and subscriptions. The API endpoint for the Nintex public API is <PROTOCOL>://<FQDN>/nintex-public-api/

Follow these steps to get an access token:

1. Create a POST token request using a tool like cURL, Postman, or a programming language (e.g., Python, JavaScript). For this example, we'll use Postman.

2. Enter the URL of the Nintex public API token endpoint in the request URL field using the format:

   POST	<PROTOCOL>://<FQDN>/auth/realms/Kryon/protocol/openid-connect/token

   Customize the URL based on your specific environment:

   • <PROTOCOL>: Replace this with the protocol used by the API. It could be either http or https, depending on the API's security.

   • <FQDN>: Replace this with the fully-qualified domain name of the server hosting the Nintex public API.

3. Open the Body tab.

4. Select x-www-form-urlencoded as the content type of the request body.

   

5. Enter the Key-Value pairs that represent parameters required by the authentication server:

   • client_id: Set to kryon-public-api.

   • grant_type: Set to password.

   • username: Set this to your actual username, which you get during user registration or that is provided by your system administrator.

   • password: Set this to your actual password, which is associated with the provided username.

   Example:

   

6. Run the POST request to send the request to the token endpoint. This will differ depending on the tool (e.g., Postman) or programming language (e.g., cURL, Python, JavaScript) that you are using. After the request is sent successfully, the authentication server responds with a JSON object that includes the access token.

7. Copy the access token from the API response. It's usually found in a field named "access_token".

   

8. Save the access token for authenticating other requests to protected resources.

As an example, you can follow these steps to create an AddQueue request:

1. Send a POST request using a tool like cURL, Postman, or a programming language (e.g., Python, JavaScript). For this example, we'll use Postman.

2. Enter the URL of the Nintex public API endpoint in the request URL field using the format: <PROTOCOL>://<FQDN>/nintex-public-api/graphql.

   Customize the URL based on your specific environment:

   • <PROTOCOL>: Replace this with the protocol used by the API. It could be either http or https, depending on the API's security.

   • <FQDN>: Replace this with the fully-qualified domain name of the server hosting the Nintex public API.

   Example:

   If the protocol is HTTPS and the FQDN is "api.nintexexample.com," the URL could be:

   Copy

   https://api.nintexexample.com/nintex-public-api/graphql

3. Click the Authorization tab.

4. Set the Type to Bearer Token.

5. Paste the access token copied from the Authentication section into the Token field in the Authorization tab.

   

6. Add new headers in the Headers tab:

   • KEY: Content-Type, VALUE: application/json

   • KEY: kryon-client-id, VALUE: kryon-public-api

   • KEY: kryon-auth-provider, VALUE: aerobase

7. Open the Body tab.

8. Select GraphQL as the content type of the request body.

   

9. Enter the GraphQL query and variable in the Body tab.

   

    

   Copy

   QUERY

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   mutation {
     addQueue(queue: {tenantId: "1", name: "queue"}) {
       id
       name
       tenantId
       createdAt
       isDeleted
       deletedAt
       createdBy
     }
   }

   Copy

   GRAPHQL VARIABLES

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   { 
     "queue": { 
      "name": "EliTest",
      "queueOperationalHoursConfig": {
           "type": CUSTOM,
           "workingHours": {
               "from": "1970-01-01T09:09:18.602Z",
               "to": "1970-01-01T10:09:18.602Z",
               "days": [SUNDAY, TUESDAY],
               "timeZone": "Asia/Jerusalem"
           },
           "calendars": ["df0d8a87-b998-417d-8063-9560cc790629"] 
       }
      }
    }

10. Click Send.