Automation Actions

Before You Begin

🔗 Use the GraphQL Playground to execute the queries in this guide.

➡️ New to GraphQL? Learn how to navigate the Playground with our Playground Basics Guide.

Prerequisites

  1. Authentication: Use a Service Account token (Personal Access Tokens are deprecated).
  2. Repo ID: Identify the repo to retrieve the automation actions from, due to the possibility of some action to be disabled. If omitted, the query will return all automation actions, but some might be disabled.

Step 1: Find Your Repo ID

1. Via Pipefy UI

  • Open the pipe in your browser.
  • The URL will include the Repo ID: https://app.pipefy.com/pipes/9876543210.
  • Repo ID = 9876543210 (the number after /pipes/).

2. Via GraphQL Query

Step 2: Query Automation Actions

Use the automationActions query to retrieve available automation actions. Below are some examples:

{
  automationActions {
    id
    enabled
    disabledReason
    eventsBlacklist
    acceptedParameters
    initiallyHidden
    icon
    triggerEvents
  }
}

With repo

{
  automationActions(repoId: "1234") {
    id
    enabled
    disabledReason
    eventsBlacklist
    acceptedParameters
    initiallyHidden
    icon
    triggerEvents
  }
}

Key Fields Explained:

  • id: Automation action unique identifier.
  • enabled: Indicates if the action is enabled (true) or disabled (false).
  • disabledReason: If disabled, returns an identifier of the reason.
  • eventsBlacklist: A list of events that cannot trigger the action.
  • acceptedParameters: A list of parameters accepted by the action.
  • initiallyHidden: Indicates if the action should be initially hidden when creating a new automation, and be displayed only after selecting the event.
  • icon: The icon name to be displayed with the action name.
  • triggerEvents: A list of events that can relate to the action in a way that could generate an infinite loop of automations.

Step 3: Execute and Interpret the Response

After running the query, you'll receive a structured JSON response. Here’s an example:

{
  "data": {
    "automationActions": [
      {
        "id": "generate_with_ai",
        "enabled": true,
        "disabledReason": null,
        "eventsBlacklist": ["scheduler"],
        "acceptedParameters": ["ai_params"],
        "initiallyHidden": null,
        "icon": "i-ai-automation",
        "triggerEvents": ["field_updated"]
      },
      {
        "id": "send_a_task",
        "enabled": true,
        "disabledReason": null,
        "eventsBlacklist": ["scheduler", "sla_based", "card_left_phase", "manually_triggered"],
        "acceptedParameters": ["task_params"],
        "initiallyHidden": null,
        "icon": "i-form",
        "triggerEvents": []
      },
      {
        "id": "move_single_card",
        "enabled": true,
        "disabledReason": null,
        "eventsBlacklist": ["scheduler", "manually_triggered"],
        "acceptedParameters": ["to_phase_id"],
        "initiallyHidden": null,
        "icon": "i-move-in",
        "triggerEvents": ["card_moved", "all_children_in_phase"]
      },
      {
        "id": "create_card",
        "enabled": true,
        "disabledReason": null,
        "eventsBlacklist": ["scheduler", "manually_triggered"],
        "acceptedParameters": ["fields_map_order"],
        "initiallyHidden": null,
        "icon": "i-card",
        "triggerEvents": ["card_created", "field_updated", "sla_based"]
      }
    ]
  }
}

This query provides a quick and effective way to retrieve a list of available automation actions.