---
title: Turbine Record Actions
slug: connectors/turbine-record-actions
docTags: 
createdAt: 2026-06-09T16:30:01.149Z
---

Turbine Record Actions provides native functionality for managing, updating, and relating records within Swimlane applications.

Turbine Record Actions enables seamless management of Swimlane application records within the Swimlane Turbine platform. This connector provides low-code actions to create, update, search, and delete records, as well as manage references and access restrictions. By integrating with Turbine Record Actions, security teams can automate incident record handling, enforce granular access controls, and streamline data relationships across workflows. This empowers users to accelerate response times, maintain data integrity, and ensure compliance within their security operations.

## Capabilities

This connector has the capability to search, create, update, upsert, and delete records in Turbine.

## Notes

For information on how to write filters, see the documentation for searching in the
[Swimlane Python driver](https://swimlane-python-driver.readthedocs.io/en/stable/examples/resources.html#search-records).

# Actions

## Add References

Add references to a field in a Swimlane application record.

### Input

| **Argument Name**      | **Type** | **Required** | **Description**                            |
| ---------------------- | -------- | ------------ | ------------------------------------------ |
| `applicationName`      | string   | Required     | Application Name for the record.           |
| `trackingId`           | string   | Required     | Tracking ID of the record.                 |
| `referenceFieldKey`    | string   | Required     | The key of the field to add references to. |
| `referenceTrackingIds` | array    | Required     | Tracking IDs of references to add.         |

### Input Example

`{"applicationName":"Example Name","trackingId":"string","referenceFieldKey":"string","referenceTrackingIds":["string"]}`

## Add Restrictions

Add restrictions to a Swimlane application record.

### Input

| **Argument Name** | **Type** | **Required** | **Description**                            |
| ----------------- | -------- | ------------ | ------------------------------------------ |
| `applicationName` | string   | Required     | Application Name for the record.           |
| `trackingId`      | string   | Required     | Tracking ID of the record.                 |
| `users`           | array    | Optional     | Usernames to restrict the record to.       |
| `groups`          | array    | Optional     | Groups to restrict the record to.          |
| `append`          | boolean  | Optional     | Whether to append or replace restrictions. |

### Input Example

`{"applicationName":"Example Name","trackingId":"string","users":["string"],"groups":["string"],"append":true}`

## Create Record

Create a Swimlane application record.

### Input

| **Argument Name**     | **Type** | **Required** | **Description**                                                              |
| --------------------- | -------- | ------------ | ---------------------------------------------------------------------------- |
| `applicationName`     | string   | Required     | Application Name for the record.                                             |
| `fields`              | object   | Required     | A object containing the field keys and values to populate in the new record. |
| `restrictions`        | object   | Optional     | Users and groups to restrict the record to.                                  |
| `restrictions.users`  | array    | Optional     | Usernames to restrict the record to.                                         |
| `restrictions.groups` | array    | Optional     | Groups to restrict the record to.                                            |

### Input Example

`{"applicationName":"Example Name","fields":{},"restrictions":{"users":["string"],"groups":["string"]}}`

### Output

| **Parameter** | **Type** | **Description**   |
| ------------- | -------- | ----------------- |
| `tracking-id` | string   | Unique identifier |

### Output Example

`{"tracking-id":"string"}`

## Delete Record

Delete a Swimlane application record.

### Input

| **Argument Name** | **Type** | **Required** | **Description**                  |
| ----------------- | -------- | ------------ | -------------------------------- |
| `applicationName` | string   | Required     | Application Name for the record. |
| `trackingId`      | string   | Required     | Tracking ID of the record.       |

### Input Example

`{"applicationName":"Example Name","trackingId":"string"}`

## Remove References

Remove references from a field in a Swimlane application record.

### Input

| **Argument Name**      | **Type** | **Required** | **Description**                                 |
| ---------------------- | -------- | ------------ | ----------------------------------------------- |
| `applicationName`      | string   | Required     | Application Name for the record.                |
| `trackingId`           | string   | Required     | Tracking ID of the record.                      |
| `referenceFieldKey`    | string   | Required     | The key of the field to remove references from. |
| `referenceTrackingIds` | array    | Required     | Tracking IDs of references to remove.           |

### Input Example

`{"applicationName":"Example Name","trackingId":"string","referenceFieldKey":"string","referenceTrackingIds":["string"]}`

## Remove Restrictions

Remove restrictions from a Swimlane application record.

### Input

| **Argument Name** | **Type** | **Required** | **Description**                                     |
| ----------------- | -------- | ------------ | --------------------------------------------------- |
| `applicationName` | string   | Required     | Application Name for the record.                    |
| `trackingId`      | string   | Required     | Tracking ID of the record.                          |
| `users`           | array    | Optional     | Usernames to remove from the record's restrictions. |
| `groups`          | array    | Optional     | Groups to remove from the record's restrictions.    |

### Input Example

`{"applicationName":"Example Name","trackingId":"string","users":["string"],"groups":["string"]}`

## Search Records

Search Swimlane application records.

### Input

| **Argument Name** | **Type** | **Required** | **Description**                                               |
| ----------------- | -------- | ------------ | ------------------------------------------------------------- |
| `applicationName` | string   | Required     | Application Name for the record.                              |
| `filters`         | array    | Optional     | Search filters                                                |
| `filterType`      | string   | Optional     | select whether this is an "AND" or an "OR" filter             |
| `returnFields`    | array    | Optional     | Only the fields provided will be returned in the record data. |
| `limit`           | number   | Optional     | The maximum number of results to return, defaults to 1000.    |

### Input Example

`{"applicationName":"Example Name","filters":[],"filterType":"string","returnFields":["string"],"limit":123}`

### Output

| **Parameter**         | **Type** | **Description**              |
| --------------------- | -------- | ---------------------------- |
| `records`             | array    | Output field: records        |
| `records.tracking-id` | string   | Unique identifier            |
| `count`               | number   | Count value                  |
| `limit`               | number   | Output field: limit          |
| `isCountLimited`      | boolean  | Output field: isCountLimited |

### Output Example

`{"records":[],"count":123,"limit":123,"isCountLimited":true}`

## Update Record

Update a Swimlane application record.

### Input

| **Argument Name** | **Type** | **Required** | **Description**                                                                                                                                               |
| ----------------- | -------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `applicationName` | string   | Required     | Application Name for the record.                                                                                                                              |
| `trackingId`      | string   | Required     | Tracking ID of the record to update.                                                                                                                          |
| `patchValues`     | object   | Optional     | An object containing all the field keys and values to update. The fields will be overwritten with the new values.                                             |
| `appendValues`    | object   | Optional     | An object containing all the field keys and values to append. The fields will be appended with the new values. The values must match the types of the fields. |

### Input Example

`{"applicationName":"Example Name","trackingId":"string","patchValues":{},"appendValues":{}}`

### Output

| **Parameter** | **Type** | **Description**   |
| ------------- | -------- | ----------------- |
| `tracking-id` | string   | Unique identifier |

### Output Example

`{"tracking-id":"string"}`

## Update/Create Record

Updates or creates a Swimlane application record based on a key field.

### Input

| **Argument Name** | **Type** | **Required** | **Description**                                                                                                                                               |
| ----------------- | -------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `applicationName` | string   | Required     | Application Name for the record.                                                                                                                              |
| `keyFieldKey`     | string   | Required     | Key of the field to use as a unique identifier.                                                                                                               |
| `keyFieldValue`   | string   | Required     | Value of the key field.                                                                                                                                       |
| `patchValues`     | object   | Optional     | An object containing all the field keys and values to update. The fields will be overwritten with the new values.                                             |
| `appendValues`    | object   | Optional     | An object containing all the field keys and values to append. The fields will be appended with the new values. The values must match the types of the fields. |

### Input Example

`{"applicationName":"Example Name","keyFieldKey":"string","keyFieldValue":"string","patchValues":{},"appendValues":{}}`

### Output

| **Parameter** | **Type** | **Description**   |
| ------------- | -------- | ----------------- |
| `tracking-id` | string   | Unique identifier |

### Output Example

`{"tracking-id":"string"}`

# Response Headers

| **Header**   | **Description**                                       | **Example**                   |
| ------------ | ----------------------------------------------------- | ----------------------------- |
| Content-Type | The media type of the resource                        | application/json              |
| Date         | The date and time at which the message was originated | Thu, 01 Jan 2024 00:00:00 GMT |
