> ## 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.

# Attention: Change Conversation Labels

> Replace the labels on an Attention conversation, optionally refreshing its CRM insights. Includes inputs, outputs, SDK V2 examples, and Deepline cost.

Replace the labels on an Attention conversation, optionally refreshing its CRM insights.

> [!NOTE]
>
> Tool ID: `attention_change_conversation_labels`

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

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

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

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute attention_change_conversation_labels --input '{
  "id": "id_123",
  "labels": {}
}' --json
```

## Example response

The SDK returns this shape at `result.toolResponse.raw`. The example values illustrate the response.

```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
  "data": {
    "type": "conversations",
    "id": "id_123",
    "attributes": {
      "externalIntelligenceOpportunityID": "external_intelligence_opportunity_123",
      "externalOpportunity": {
        "uuid": "uuid_123",
        "title": "VP of Engineering"
      },
      "dealUUID": "deal_123",
      "zoomMetadata": {
        "calleeName": "Example",
        "calleeNumber": "example",
        "callerName": "Example",
        "callerNumber": "example"
      },
      "importMetadata": {}
    }
  }
}
```

Use `deepline describe attention_change_conversation_labels --json` for the latest machine-readable contract.

## Input reference

Replaces the labels (key-value metadata) on a conversation. When labels change, the label-changed workflow is triggered and CRM intelligence may be refreshed unless analysis is explicitly skipped.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.id` | `string` | Yes | — | UUID of the conversation to update |
| `payload.labels` | `object` | Yes | — | Key-value map of labels to set on the conversation. Replaces all existing labels. |
| `payload.skip_analysis` | `boolean` | No | `false` | When true, skips CRM intelligence refresh after the label change. Defaults to false. |

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

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Replaces the labels (key-value metadata) on a conversation. When labels change, the label-changed workflow is triggered and CRM intelligence may be refreshed unless analysis is explicitly skipped.",
    "properties": {
      "id": {
        "type": "string",
        "description": "UUID of the conversation to update"
      },
      "labels": {
        "type": "object",
        "description": "Key-value map of labels to set on the conversation. Replaces all existing labels.",
        "additionalProperties": true
      },
      "skip_analysis": {
        "type": "boolean",
        "description": "When true, skips CRM intelligence refresh after the label change. Defaults to false.",
        "default": false
      }
    },
    "required": [
      "id",
      "labels"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.type` | `"conversations"` | No | — | Allowed: `conversations`. |
| `result.data.id` | `string` | No | — | — |
| `result.data.attributes` | `object` | No | — | — |
| `result.data.attributes.uuid` | `string` | No | — | — |
| `result.data.attributes.transcript` | `record` | No | — | — |
| `result.data.attributes.boards` | `array` | No | — | — |
| `result.data.attributes.boards[].uuid` | `string` | No | — | — |
| `result.data.attributes.boards[].board` | `object` | No | — | — |
| `result.data.attributes.boards[].board.uuid` | `string` | No | — | — |
| `result.data.attributes.boards[].board.name` | `string` | No | — | — |
| `result.data.attributes.boards[].board.columns` | `array` | No | — | — |
| `result.data.attributes.boards[].board.columns[].id` | `string` | No | — | — |
| `result.data.attributes.boards[].board.columns[].title` | `string` | No | — | — |
| `result.data.attributes.boards[].board.columns[].children` | `array` | No | — | — |
| `result.data.attributes.boards[].board.columns[].children[].uuid` | `string` | No | — | — |
| `result.data.attributes.boards[].board.columns[].children[].keywords` | `array` | No | — | — |
| `result.data.attributes.boards[].board.columns[].children[].response` | `string` | No | — | — |
| `result.data.attributes.boards[].board.columns[].children[].text` | `string` | No | — | — |
| `result.data.attributes.boards[].board.team` | `object` | No | — | Represents a team in the system with its properties and hierarchical structure |
| `result.data.attributes.boards[].board.team.uuid` | `string` | No | — | Unique identifier of the team |
| `result.data.attributes.boards[].board.team.name` | `string` | No | — | Name of the team |
| `result.data.attributes.boards[].board.team.phrases` | `array` | No | — | List of keywords or phrases associated with the team |
| `result.data.attributes.boards[].board.team.slackConnection` | `object` | No | — | Represents the Slack integration details for a team |
| `result.data.attributes.boards[].board.team.slackConnection.id` | `string` | No | — | Slack connection identifier |
| `result.data.attributes.boards[].board.team.slackConnection.info` | `object` | No | — | Information about a connected Slack team |
| `result.data.attributes.boards[].board.team.slackConnection.info.id` | `string` | No | — | Slack team identifier |
| `result.data.attributes.boards[].board.team.slackConnection.info.name` | `string` | No | — | Name of the Slack team |
| `result.data.attributes.boards[].board.team.domain` | `string` | No | — | Domain associated with the team |
| `result.data.attributes.boards[].board.team.organizerJoinInternalMeetings` | `boolean` | No | — | Whether team organizers can join internal meetings |
| `result.data.attributes.boards[].board.team.consentEmailEnabled` | `boolean` | No | — | Whether email consent is enabled for the team |
| `result.data.attributes.boards[].board.team.parentTeamUUID` | `string` | No | — | UUID of the parent team if this team is part of a hierarchy |
| `result.data.attributes.boards[].board.team.organizationUUID` | `string` | No | — | UUID of the organization this team belongs to |
| `result.data.attributes.boards[].board.team.children` | `array` | No | — | List of child teams if this team has a hierarchical structure |
| `result.data.attributes.boards[].board.teamUUID` | `string` | No | — | — |
| `result.data.attributes.boards[].battlecards` | `array` | No | — | — |
| `result.data.attributes.boards[].battlecards[].uuid` | `string` | No | — | — |
| `result.data.attributes.boards[].battlecards[].activatedBattlecardID` | `string` | No | — | — |
| `result.data.attributes.boards[].battlecards[].hidden` | `boolean` | No | — | — |
| `result.data.attributes.boards[].battlecards[].feedbackAction` | `string` | No | — | — |
| `result.data.attributes.finishedAt` | `string` | No | — | Format: `date-time`. |
| `result.data.attributes.title` | `string` | No | — | — |
| `result.data.attributes.liveStreamStartedAt` | `string` | No | — | Format: `date-time`. |
| `result.data.attributes.liveStreamEndedAt` | `string` | No | — | Format: `date-time`. |
| `result.data.attributes.talktracks` | `array` | No | — | — |
| `result.data.attributes.talktracks[].uuid` | `string` | No | — | — |
| `result.data.attributes.talktracks[].items` | `array` | No | — | — |
| `result.data.attributes.talktracks[].items[].uuid` | `string` | No | — | — |
| `result.data.attributes.talktracks[].items[].activatedItemId` | `string` | No | — | — |
| `result.data.attributes.talktracks[].items[].done` | `boolean` | No | — | — |

The table shows the first 50 fields. Use the live contract below for every field.

> [!NOTE]
>
> This output schema is too large for an inline display. Read the complete live contract with `deepline describe attention_change_conversation_labels --json`.

## 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

* [Attention provider guide](https://deepline.com/docs/providers/attention/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.