Skip to main content

​
List Operations

​
listRuns

Returns a paginated list of execution runs. Parameters:
  • limit: Int - Number of items to return (default: 10, max: 100)
  • offset: Int - Number of items to skip (default: 0)
  • configId: ID - Filter runs by specific configuration ID (optional)
  • GraphQL
  • SDK
query ListRuns($limit: Int = 10, $offset: Int = 0, $configId: ID) {
  listRuns(limit: $limit, offset: $offset, configId: $configId) {
    items {
      id
      success
      error
      startedAt
      completedAt
      data
      config {
        ... on Workflow {
          id
          version
          instruction
          createdAt
          updatedAt
        }
      }
    }
    total
  }
}

​
listWorkflows

Returns a paginated list of workflow configurations.
  • GraphQL
  • SDK
query ListWorkflows($limit: Int = 10, $offset: Int = 0) {
  listWorkflows(limit: $limit, offset: $offset) {
    items {
      id
      version
      createdAt
      updatedAt
      instruction
      steps {
        id
        apiConfig {
          id
          urlHost
          urlPath
          method
          instruction
          authentication
        }
        integrationId
        executionMode
        loopSelector
        loopMaxIters
        inputMapping
        responseMapping
      }
      integrationIds
      finalTransform
      responseSchema
      inputSchema
    }
    total
  }
}

​
listIntegrations

Returns a paginated list of integration configurations.
  • GraphQL
  • SDK
query ListIntegrations($limit: Int = 10, $offset: Int = 0) {
  listIntegrations(limit: $limit, offset: $offset) {
    items {
      id
      name
      type
      urlHost
      urlPath
      documentationUrl
      documentation
      documentationPending
      specificInstructions
      icon
      version
      createdAt
      updatedAt
    }
    total
  }
}

​
listWorkflowSchedules

Returns all schedules for a specific workflow. Parameters:
  • workflowId: String! - The workflow ID to list schedules for (required)
  • GraphQL
  • SDK
query ListWorkflowSchedules($workflowId: String!) {
  listWorkflowSchedules(workflowId: $workflowId) {
    id
    workflowId
    cronExpression
    timezone
    enabled
    payload
    options
    lastRunAt
    nextRunAt
    createdAt
    updatedAt
  }
}

​
Get Operations

​
getRun

Retrieves a specific execution run by ID.
  • GraphQL
  • SDK
query GetRun($id: ID!) {
  getRun(id: $id) {
    id
    success
    error
    startedAt
    completedAt
    data
    config {
      ... on Workflow {
        id
        version
        instruction
        createdAt
        updatedAt
      }
    }
  }
}

​
getWorkflow

Retrieves a specific workflow configuration by ID.
  • GraphQL
  • SDK
query GetWorkflow($id: ID!) {
  getWorkflow(id: $id) {
    id
    version
    createdAt
    updatedAt
    instruction
    steps {
      id
      apiConfig {
        id
        urlHost
        urlPath
        method
        instruction
        authentication
      }
      integrationId
      executionMode
      loopSelector
      loopMaxIters
      inputMapping
      responseMapping
    }
    integrationIds
    finalTransform
    responseSchema
    inputSchema
  }
}

​
getIntegration

Retrieves a specific integration configuration by ID.
  • GraphQL
  • SDK
query GetIntegration($id: ID!) {
  getIntegration(id: $id) {
    id
    name
    type
    urlHost
    urlPath
    credentials
    documentationUrl
    documentation
    documentationPending
    specificInstructions
    icon
    version
    createdAt
    updatedAt
  }
}

​
Utility Queries

​
generateSchema

Generates a JSON schema based on instructions and optional response data. Useful for creating response schemas for workflows. Parameters:
  • instruction: String! - Natural language description of the desired schema (required)
  • responseData: String - Sample JSON data to infer schema from (optional)
  • GraphQL
  • SDK
query GenerateSchema($instruction: String!, $responseData: String) {
  generateSchema(instruction: $instruction, responseData: $responseData)
}

​
generateInstructions

Generates natural language instructions based on integration configurations. Helps create workflow instructions from available integrations. Parameters:
  • integrations: [IntegrationInput!]! - List of integrations to generate instructions for (required)
  • GraphQL
  • SDK
query GenerateInstructions($integrations: [IntegrationInput!]!) {
  generateInstructions(integrations: $integrations)
}

​
getTenantInfo

Retrieves tenant account information.
  • GraphQL
  • SDK
query GetTenantInfo {
  getTenantInfo {
    email
    emailEntrySkipped
  }
}

​
findRelevantIntegrations

Finds integrations relevant to a given natural language instruction. Returns suggested integrations with explanations. Parameters:
  • instruction: String - Natural language description of what you want to do (optional, returns all integrations if not provided)
  • GraphQL
  • SDK
query FindRelevantIntegrations($instruction: String) {
  findRelevantIntegrations(instruction: $instruction) {
    id
    reason
    savedCredentials
  }
}

​
Fields

  • instruction: String (optional) - Natural language description of what you want to do
  • Returns: Array of SuggestedIntegration objects