> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Salesloft: Integrations Signals Registrations Plays Update

> Update a Play Registration. Includes SDK V2 and CLI requests, input constraints, response fields, and Deepline credit cost.

Update a Play Registration.

<Info>
  Tool ID: `salesloft_integrations_signals_registrations_plays_update`
</Info>

## Run this action

Use the TypeScript SDK for a single call. Put `ctx.tools.execute(...)` inside a Play when the call should be durable, scheduled, or run across a CSV.

```ts theme={null}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'salesloft_integrations_signals_registrations_plays_update',
  {
    "id": 123
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={null}
deepline tools execute salesloft_integrations_signals_registrations_plays_update --input '{
  "id": 123
}' --json
```

## Example response

The SDK exposes this shape at `result.toolResponse.raw`. Values below are representative.

```json theme={null}
{
  "data": {
    "state": "California",
    "signal_type": "example",
    "signal_registration": {}
  }
}
```

Use `deepline tools get salesloft_integrations_signals_registrations_plays_update --json` for the latest machine-readable contract.

## Input reference

Salesloft Plays are rulesets that turn Salesloft Signals into action if and when certain criteria are met - when indicator(s) of an incoming Signal match indicator(s) of a previously configured Play registration. A Play registration must be associated to an existing Signal registration. Play registration properties that can be updated include: name, label, description, indicators, and attributes. Please note, a Play registration can not be updated after it has been globally installed.

| Name                  | Type      | Required | Default | Details                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| --------------------- | --------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `payload.id`          | `integer` | Yes      | —       | The Play Registration ID.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `payload.name`        | `object`  | No       | —       | The localized mapping of the Play Registration's name, which is displayed as the default title for the Play. Example: `&#123; "en-us": "Video Watched", "es-mx": "Vídeo Visto" &#125;`                                                                                                                                                                                                                                                                                                                                                                           |
| `payload.label`       | `object`  | No       | —       | The localized mapping of the Play Registration's label, which provides a short description used to explain the signal and action combination. Example: `&#123; "en-us": "Video Fully Watched", "es-mx": "Vídeo Visto en su Totalidad" &#125;`                                                                                                                                                                                                                                                                                                                    |
| `payload.indicators`  | `array`   | No       | —       | List of indicators that must be present on the Signal for the Play to execute. Indicators come from Signal Registration Indicators. Only one indicator per Play is suggested. See Create Play Registration documentation for examples of how indicators are used to trigger Plays. Note: Indicators cannot be updated after a Play is made globally available.                                                                                                                                                                                                   |
| `payload.description` | `object`  | No       | —       | The localized mapping of the Play Registration's description, which provides a more detailed description of the signal and action combination. \`\`\` \{ "en-us": "This Play helps convert potential buyers by surfacing buyer actions. When a potential buyer watches a video completely, this play will schedule a follow-up task.", "es-mx": "Esta Play ayuda a convertir a compradores potenciales al mostrar las acciones de los compradores. Cuando un comprador potencial ve un vídeo por completo, esta See the live schema for the complete constraint. |
| `payload.attributes`  | `object`  | No       | —       | The attributes that describe the default settings for the Play, including default task values. Values will be merged into existing `attributes`. If you would like to remove a field's value, set it to `null`. See Create Play Registration documentation for supported attributes. Example: `&#123; "task_subject": "Updated Task Subject" &#125;`                                                                                                                                                                                                             |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ````json theme={null}
  {
    "type": "object",
    "description": "Salesloft Plays are rulesets that turn Salesloft Signals into action if and when certain criteria are met - when indicator(s) of an incoming Signal match indicator(s) of a previously configured Play registration. A Play registration must be associated to an existing Signal registration. Play registration properties that can be updated include: name, label, description, indicators, and attributes. Please note, a Play registration can not be updated after it has been globally installed.",
    "properties": {
      "id": {
        "type": "integer",
        "description": "The Play Registration ID."
      },
      "name": {
        "type": "object",
        "description": "The localized mapping of the Play Registration's name, which is displayed as the default title for the Play. Example: ``` { \"en-us\": \"Video Watched\", \"es-mx\": \"Vídeo Visto\" } ```"
      },
      "label": {
        "type": "object",
        "description": "The localized mapping of the Play Registration's label, which provides a short description used to explain the signal and action combination. Example: ``` { \"en-us\": \"Video Fully Watched\", \"es-mx\": \"Vídeo Visto en su Totalidad\" } ```"
      },
      "indicators": {
        "type": "array",
        "description": "List of indicators that must be present on the Signal for the Play to execute. Indicators come from Signal Registration Indicators. Only one indicator per Play is suggested. See Create Play Registration documentation for examples of how indicators are used to trigger Plays. Note: Indicators cannot be updated after a Play is made globally available.",
        "items": {
          "type": "string"
        }
      },
      "description": {
        "type": "object",
        "description": "The localized mapping of the Play Registration's description, which provides a more detailed description of the signal and action combination. ``` { \"en-us\": \"This Play helps convert potential buyers by surfacing buyer actions. When a potential buyer watches a video completely, this play will schedule a follow-up task.\", \"es-mx\": \"Esta Play ayuda a convertir a compradores potenciales al mostrar las acciones de los compradores. Cuando un comprador potencial ve un vídeo por completo, esta reproducción programará una tarea de seguimiento.\" } ```"
      },
      "attributes": {
        "type": "object",
        "description": "The attributes that describe the default settings for the Play, including default task values. Values will be merged into existing `attributes`. If you would like to remove a field's value, set it to `null`. See Create Play Registration documentation for supported attributes. Example: ``` { \"task_subject\": \"Updated Task Subject\" } ```"
      }
    },
    "required": [
      "id"
    ],
    "additionalProperties": false
  }
  ````
</details>

## Output reference

Standard tool result payload.

| Name                              | Type      | Required | Default | Details                                                                                                                                                                                                                                                                   |
| --------------------------------- | --------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `result.data`                     | `object`  | Yes      | —       | Provider response payload.                                                                                                                                                                                                                                                |
| `result.data.state`               | `string`  | No       | —       | State of play registration, either 'draft' or 'enabled'. 'draft' means Play is only available to your team and Play can be updated as needed. 'enabled' means Play is available to all teams, and only certain properties of the Play (name, label, etc.) can be updated. |
| `result.data.signal_type`         | `string`  | No       | —       | Signal Type                                                                                                                                                                                                                                                               |
| `result.data.signal_registration` | `record`  | No       | —       | Associated signal registration                                                                                                                                                                                                                                            |
| `result.data.owner_user_guid`     | `string`  | No       | —       | User GUID of Play Registration owner                                                                                                                                                                                                                                      |
| `result.data.owner_tenant_id`     | `integer` | No       | —       | Tenant ID of Play Registration owner                                                                                                                                                                                                                                      |
| `result.data.name`                | `record`  | No       | —       | Localized mapping of the Play Registration's name, which is displayed as a title for the Play                                                                                                                                                                             |
| `result.data.label`               | `record`  | No       | —       | Localized mapping of the Play Registration's label, which provides a short description used to explain the signal action combination                                                                                                                                      |
| `result.data.integration`         | `record`  | No       | —       | Associated integration                                                                                                                                                                                                                                                    |
| `result.data.indicators`          | `array`   | No       | —       | List of Play Indicators. Come from Signal Registration Indicators. An Indicator set by a Play must be a part of its Signal Registration i.e. if this Indicator is present, then that Play will execute.                                                                   |
| `result.data.identifier`          | `string`  | No       | —       | Play Identifier                                                                                                                                                                                                                                                           |
| `result.data.id`                  | `integer` | No       | —       | ID of Play Registration                                                                                                                                                                                                                                                   |
| `result.data.enabled_at`          | `string`  | No       | —       | ISO8601 timestamp of when play registration was enabled Format: `date`.                                                                                                                                                                                                   |
| `result.data.description`         | `record`  | No       | —       | Localized mapping of the Play Registration's description, which provides a more detailed description of the signal action combination                                                                                                                                     |
| `result.data.created_at`          | `string`  | No       | —       | ISO8601 timestamp of when play registration was created Format: `date`.                                                                                                                                                                                                   |
| `result.data.attributes`          | `record`  | No       | —       | Describe the Task that will get generated, when it will be due, and instructions/template provided to the seller at execution time. (If task\_type is email, then you can optionally set an email\_subject and email\_body.)                                              |
| `result.meta`                     | `object`  | No       | —       | Additional response metadata (status, paging).                                                                                                                                                                                                                            |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Provider response payload.",
        "properties": {
          "state": {
            "type": "string",
            "description": "State of play registration, either 'draft' or 'enabled'. 'draft' means Play is only available to your team and Play can be updated as needed. 'enabled' means Play is available to all teams, and only certain properties of the Play (name, label, etc.) can be updated."
          },
          "signal_type": {
            "type": "string",
            "description": "Signal Type"
          },
          "signal_registration": {
            "type": "object",
            "description": "Associated signal registration"
          },
          "owner_user_guid": {
            "type": "string",
            "description": "User GUID of Play Registration owner"
          },
          "owner_tenant_id": {
            "type": "integer",
            "description": "Tenant ID of Play Registration owner"
          },
          "name": {
            "type": "object",
            "description": "Localized mapping of the Play Registration's name, which is displayed as a title for the Play"
          },
          "label": {
            "type": "object",
            "description": "Localized mapping of the Play Registration's label, which provides a short description used to explain the signal action combination"
          },
          "integration": {
            "type": "object",
            "description": "Associated integration"
          },
          "indicators": {
            "type": "array",
            "description": "List of Play Indicators. Come from Signal Registration Indicators. An Indicator set by a Play must be a part of its Signal Registration i.e. if this Indicator is present, then that Play will execute.",
            "items": {
              "type": "string"
            }
          },
          "identifier": {
            "type": "string",
            "description": "Play Identifier"
          },
          "id": {
            "type": "integer",
            "description": "ID of Play Registration"
          },
          "enabled_at": {
            "type": "string",
            "description": "ISO8601 timestamp of when play registration was enabled",
            "format": "date"
          },
          "description": {
            "type": "object",
            "description": "Localized mapping of the Play Registration's description, which provides a more detailed description of the signal action combination"
          },
          "created_at": {
            "type": "string",
            "description": "ISO8601 timestamp of when play registration was created",
            "format": "date"
          },
          "attributes": {
            "type": "object",
            "description": "Describe the Task that will get generated, when it will be due, and instructions/template provided to the seller at execution time. (If task_type is email, then you can optionally set an email_subject and email_body.)"
          }
        },
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.

## Related documentation

* [Salesloft provider guide](/docs/providers/salesloft/guide)
* [SDK V2 quickstart](/docs/sdk-v2/quickstart)
* [SDK reference](/docs/sdk-v2/sdk-reference)
* [Run tools across a CSV](/docs/sdk-v2/batch-csv)
