Add (or update) a table action on a list.

curl --request POST \
  --url https://api.parallellabs.app/api/v0/lists/{listId}/action \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "actionParameters": {},
  "actionId": "<string>",
  "autoRunEnabled": true,
  "companyId": "<string>",
  "conditions": {
    "combinator": "<string>",
    "filters": [
      {
        "field": "<string>",
        "operator": "<string>",
        "value": "<string>"
      }
    ],
    "groups": [
      {
        "combinator": "<string>",
        "filters": [
          {
            "field": "<string>",
            "operator": "<string>",
            "value": "<string>"
          }
        ],
        "groups": [
          {}
        ]
      }
    ]
  }
}
'

import requests

url = "https://api.parallellabs.app/api/v0/lists/{listId}/action"

payload = {
    "actionParameters": {},
    "actionId": "<string>",
    "autoRunEnabled": True,
    "companyId": "<string>",
    "conditions": {
        "combinator": "<string>",
        "filters": [
            {
                "field": "<string>",
                "operator": "<string>",
                "value": "<string>"
            }
        ],
        "groups": [
            {
                "combinator": "<string>",
                "filters": [
                    {
                        "field": "<string>",
                        "operator": "<string>",
                        "value": "<string>"
                    }
                ],
                "groups": [{}]
            }
        ]
    }
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    actionParameters: {},
    actionId: '<string>',
    autoRunEnabled: true,
    companyId: '<string>',
    conditions: {
      combinator: '<string>',
      filters: [{field: '<string>', operator: '<string>', value: '<string>'}],
      groups: [
        {
          combinator: '<string>',
          filters: [{field: '<string>', operator: '<string>', value: '<string>'}],
          groups: [{}]
        }
      ]
    }
  })
};

fetch('https://api.parallellabs.app/api/v0/lists/{listId}/action', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.parallellabs.app/api/v0/lists/{listId}/action",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'actionParameters' => [
        
    ],
    'actionId' => '<string>',
    'autoRunEnabled' => true,
    'companyId' => '<string>',
    'conditions' => [
        'combinator' => '<string>',
        'filters' => [
                [
                                'field' => '<string>',
                                'operator' => '<string>',
                                'value' => '<string>'
                ]
        ],
        'groups' => [
                [
                                'combinator' => '<string>',
                                'filters' => [
                                                                [
                                                                                                                                'field' => '<string>',
                                                                                                                                'operator' => '<string>',
                                                                                                                                'value' => '<string>'
                                                                ]
                                ],
                                'groups' => [
                                                                [
                                                                                                                                
                                                                ]
                                ]
                ]
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.parallellabs.app/api/v0/lists/{listId}/action"

	payload := strings.NewReader("{\n  \"actionParameters\": {},\n  \"actionId\": \"<string>\",\n  \"autoRunEnabled\": true,\n  \"companyId\": \"<string>\",\n  \"conditions\": {\n    \"combinator\": \"<string>\",\n    \"filters\": [\n      {\n        \"field\": \"<string>\",\n        \"operator\": \"<string>\",\n        \"value\": \"<string>\"\n      }\n    ],\n    \"groups\": [\n      {\n        \"combinator\": \"<string>\",\n        \"filters\": [\n          {\n            \"field\": \"<string>\",\n            \"operator\": \"<string>\",\n            \"value\": \"<string>\"\n          }\n        ],\n        \"groups\": [\n          {}\n        ]\n      }\n    ]\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.parallellabs.app/api/v0/lists/{listId}/action")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"actionParameters\": {},\n  \"actionId\": \"<string>\",\n  \"autoRunEnabled\": true,\n  \"companyId\": \"<string>\",\n  \"conditions\": {\n    \"combinator\": \"<string>\",\n    \"filters\": [\n      {\n        \"field\": \"<string>\",\n        \"operator\": \"<string>\",\n        \"value\": \"<string>\"\n      }\n    ],\n    \"groups\": [\n      {\n        \"combinator\": \"<string>\",\n        \"filters\": [\n          {\n            \"field\": \"<string>\",\n            \"operator\": \"<string>\",\n            \"value\": \"<string>\"\n          }\n        ],\n        \"groups\": [\n          {}\n        ]\n      }\n    ]\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.parallellabs.app/api/v0/lists/{listId}/action")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"actionParameters\": {},\n  \"actionId\": \"<string>\",\n  \"autoRunEnabled\": true,\n  \"companyId\": \"<string>\",\n  \"conditions\": {\n    \"combinator\": \"<string>\",\n    \"filters\": [\n      {\n        \"field\": \"<string>\",\n        \"operator\": \"<string>\",\n        \"value\": \"<string>\"\n      }\n    ],\n    \"groups\": [\n      {\n        \"combinator\": \"<string>\",\n        \"filters\": [\n          {\n            \"field\": \"<string>\",\n            \"operator\": \"<string>\",\n            \"value\": \"<string>\"\n          }\n        ],\n        \"groups\": [\n          {}\n        ]\n      }\n    ]\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "msg": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

Lists

Add (or update) a table action on a list.

Table actions are automations attached to a list as an action column — e.g. a research agent that enriches each row, an AI text generator, or an HTTP request. Set autoRunEnabled to run the action automatically on rows as they are added.

Discover the available actions and their default parameters via GET /lists/actions, then pass that template (customized) as actionParameters. Provide actionId to update an existing action instead of creating one.

POST

api

lists

{listId}

action

Add (or update) a table action on a list.

curl --request POST \
  --url https://api.parallellabs.app/api/v0/lists/{listId}/action \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "actionParameters": {},
  "actionId": "<string>",
  "autoRunEnabled": true,
  "companyId": "<string>",
  "conditions": {
    "combinator": "<string>",
    "filters": [
      {
        "field": "<string>",
        "operator": "<string>",
        "value": "<string>"
      }
    ],
    "groups": [
      {
        "combinator": "<string>",
        "filters": [
          {
            "field": "<string>",
            "operator": "<string>",
            "value": "<string>"
          }
        ],
        "groups": [
          {}
        ]
      }
    ]
  }
}
'

import requests

url = "https://api.parallellabs.app/api/v0/lists/{listId}/action"

payload = {
    "actionParameters": {},
    "actionId": "<string>",
    "autoRunEnabled": True,
    "companyId": "<string>",
    "conditions": {
        "combinator": "<string>",
        "filters": [
            {
                "field": "<string>",
                "operator": "<string>",
                "value": "<string>"
            }
        ],
        "groups": [
            {
                "combinator": "<string>",
                "filters": [
                    {
                        "field": "<string>",
                        "operator": "<string>",
                        "value": "<string>"
                    }
                ],
                "groups": [{}]
            }
        ]
    }
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    actionParameters: {},
    actionId: '<string>',
    autoRunEnabled: true,
    companyId: '<string>',
    conditions: {
      combinator: '<string>',
      filters: [{field: '<string>', operator: '<string>', value: '<string>'}],
      groups: [
        {
          combinator: '<string>',
          filters: [{field: '<string>', operator: '<string>', value: '<string>'}],
          groups: [{}]
        }
      ]
    }
  })
};

fetch('https://api.parallellabs.app/api/v0/lists/{listId}/action', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.parallellabs.app/api/v0/lists/{listId}/action",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'actionParameters' => [
        
    ],
    'actionId' => '<string>',
    'autoRunEnabled' => true,
    'companyId' => '<string>',
    'conditions' => [
        'combinator' => '<string>',
        'filters' => [
                [
                                'field' => '<string>',
                                'operator' => '<string>',
                                'value' => '<string>'
                ]
        ],
        'groups' => [
                [
                                'combinator' => '<string>',
                                'filters' => [
                                                                [
                                                                                                                                'field' => '<string>',
                                                                                                                                'operator' => '<string>',
                                                                                                                                'value' => '<string>'
                                                                ]
                                ],
                                'groups' => [
                                                                [
                                                                                                                                
                                                                ]
                                ]
                ]
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.parallellabs.app/api/v0/lists/{listId}/action"

	payload := strings.NewReader("{\n  \"actionParameters\": {},\n  \"actionId\": \"<string>\",\n  \"autoRunEnabled\": true,\n  \"companyId\": \"<string>\",\n  \"conditions\": {\n    \"combinator\": \"<string>\",\n    \"filters\": [\n      {\n        \"field\": \"<string>\",\n        \"operator\": \"<string>\",\n        \"value\": \"<string>\"\n      }\n    ],\n    \"groups\": [\n      {\n        \"combinator\": \"<string>\",\n        \"filters\": [\n          {\n            \"field\": \"<string>\",\n            \"operator\": \"<string>\",\n            \"value\": \"<string>\"\n          }\n        ],\n        \"groups\": [\n          {}\n        ]\n      }\n    ]\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.parallellabs.app/api/v0/lists/{listId}/action")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"actionParameters\": {},\n  \"actionId\": \"<string>\",\n  \"autoRunEnabled\": true,\n  \"companyId\": \"<string>\",\n  \"conditions\": {\n    \"combinator\": \"<string>\",\n    \"filters\": [\n      {\n        \"field\": \"<string>\",\n        \"operator\": \"<string>\",\n        \"value\": \"<string>\"\n      }\n    ],\n    \"groups\": [\n      {\n        \"combinator\": \"<string>\",\n        \"filters\": [\n          {\n            \"field\": \"<string>\",\n            \"operator\": \"<string>\",\n            \"value\": \"<string>\"\n          }\n        ],\n        \"groups\": [\n          {}\n        ]\n      }\n    ]\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.parallellabs.app/api/v0/lists/{listId}/action")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"actionParameters\": {},\n  \"actionId\": \"<string>\",\n  \"autoRunEnabled\": true,\n  \"companyId\": \"<string>\",\n  \"conditions\": {\n    \"combinator\": \"<string>\",\n    \"filters\": [\n      {\n        \"field\": \"<string>\",\n        \"operator\": \"<string>\",\n        \"value\": \"<string>\"\n      }\n    ],\n    \"groups\": [\n      {\n        \"combinator\": \"<string>\",\n        \"filters\": [\n          {\n            \"field\": \"<string>\",\n            \"operator\": \"<string>\",\n            \"value\": \"<string>\"\n          }\n        ],\n        \"groups\": [\n          {}\n        ]\n      }\n    ]\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "msg": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

Authorizations

X-API-Key

string

header

required

Company API key - scoped to a specific company. Generate from the Integrations page in your dashboard.

Path Parameters

listId

string

required

Body

application/json

Table action configuration

Request body for adding (or updating) a table action — an automation attached to a list as an action column. Use GET /lists/actions to discover available actions and their default actionParameters; pass that template (with your customizations) as actionParameters here. Set autoRunEnabled=true to have the action fire automatically on new rows, and use conditions to restrict which rows it runs on.

actionParameters

object

required

Action configuration. Must include actionType (e.g. "agent", "ai_text", "http_request" — see GET /lists/actions) and a "name" for the action column. Other keys depend on the action type (e.g. an "agent" action takes "goal" and "model"). Actions run in "update_rows" mode, filling in a cell on each row.

actionId

string

Existing action/column ID (UUID) to update. Omit to create a new action.

autoRunEnabled

boolean

When true, the action runs automatically on rows as they are added to the list. Default: false. Pair with conditions to auto-run on only a subset of rows.

companyId

string

Company ID that owns the list. Required when authenticating with a personal access key (pak_…) — the key is not tied to a specific company so the server cannot infer it. Required when authenticating with a company API key only if the key belongs to a user who has access to multiple companies; otherwise it defaults to the key's company. Optional for JWT (dashboard) auth — defaults to the user's active company.

conditions

object

Optional run conditions restricting which rows the action runs on (applies to both auto-run and manual runs). An AND/OR tree of field comparisons — see ConditionsSchema for the full shape, operators, and examples. Null/omitted (or an empty filters+groups) runs on every row. The "field" in each condition is a column NAME (as in the list headers), and the row must already have that column for the comparison to match (except is_empty/is_not_empty).

Show child attributes

Response

Action created or updated

Generic success response

msg

string

Human-readable success message (typically "Success")

Delete a smart list.Run a table action against some or all rows of a list.

⌘I

Agents

Keys

Audio

Browser

Chat

Projects

Companies

Employees

Memories

Departments

Company Users

Content

Integrations

Documentation

Documents

Images

Inbox

Landing Pages

Leads

Lists

Marketing Campaigns

Mcp

Monitors

Models

Organizations

Usage

People

Content Research

Sequences

Support

Tags

Video

Voices

Add (or update) a table action on a list.

Authorizations

Path Parameters

Body

Response