Workflow Condition Actions

List of valid attributes:

Attribute	Description	Specifics
left_value	Left-hand operand of the comparison	Required. Object with value and is_placeholder (see below)
right_value	Right-hand operand of the comparison	Required. Object with value and is_placeholder (see below)
operator	Comparison operator	Required. Allowed values: “eq”, “!eq”, “gt”, “gte”, “lt”, “lte”, “ct”
previous_action_id	ID of the previous workflow action in the sequence	Optional. Create only
created_at	Timestamp of creation	Cannot be set
updated_at	Timestamp of last update	Cannot be set
discarded_at	Timestamp of discarding	Cannot be set

Operand object (left_value / right_value):

Field	Description	Specifics
value	Literal value, or a liquid variable path when is_placeholder is true	Required. Placeholders use paths such as user.name (see Liquid Variables).
is_placeholder	Whether value is a liquid variable path	Required. Boolean.
type	Resolved value type	Response only. Set by the API to "string", "integer", or "boolean". Do not send on create/update.

Create

Example request:

{
  "data": {
    "type": "workflow_condition_action",
    "attributes": {
      "operator": "eq",
      "left_value": {
        "value": "time_tracking.status",
        "is_placeholder": true
      },
      "right_value": {
        "value": "created",
        "is_placeholder": false
      },
      "previous_action_id": "9ee58efe-7ce5-4143-99d3-954303b188f3"
    }
  }
}

Example response:

{
  "data": {
    "id": "85579c3b-22ea-43b8-ab79-d60d05680be5",
    "type": "workflow_condition_action",
    "attributes": {
      "operator": "eq",
      "left_value": {
        "value": "time_tracking.status",
        "type": "string",
        "is_placeholder": true
      },
      "right_value": {
        "value": "created",
        "type": "string",
        "is_placeholder": false
      },
      "created_at": "2026-08-04T12:00:00.000Z",
      "updated_at": "2026-08-04T12:00:00.000Z",
      "discarded_at": null
    }
  }
}

This endpoint creates a new condition action for a workflow.

HTTP Request

POST /api/v1/workflows/:workflow_id/condition_actions

URL Parameters

Parameter	Description
workflow_id	The ID of the workflow that the action belongs to

Update

Example request:

{
  "data": {
    "type": "workflow_condition_action",
    "attributes": {
      "operator": "gt",
      "left_value": {
        "value": 10,
        "is_placeholder": false
      },
      "right_value": {
        "value": 5,
        "is_placeholder": false
      }
    }
  }
}

Example response:

{
  "data": {
    "id": "85579c3b-22ea-43b8-ab79-d60d05680be5",
    "type": "workflow_condition_action",
    "attributes": {
      "operator": "gt",
      "left_value": {
        "value": 10,
        "type": "integer",
        "is_placeholder": false
      },
      "right_value": {
        "value": 5,
        "type": "integer",
        "is_placeholder": false
      },
      "created_at": "2026-08-01T12:00:00.000Z",
      "updated_at": "2026-08-04T12:05:00.000Z",
      "discarded_at": null
    }
  }
}

This endpoint updates a condition action.

HTTP Request

PUT /api/v1/workflows/:workflow_id/condition_actions/:condition_action_id

URL Parameters

Parameter	Description
condition_action_id	The ID of the condition action to update
workflow_id	The ID of the workflow that the action belongs to