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

# Intercom: Delete Conversation

> Permanently delete an Intercom conversation by its ID. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.

Permanently delete an Intercom conversation by its ID.

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

## 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(
  'intercom_delete_conversation',
  {
    "conversation_id": 123
  },
);

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

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute intercom_delete_conversation --input '{
  "conversation_id": 123
}' --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": {
    "id": "id_123",
    "object": "conversation",
    "deleted": true
  }
}
```

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

## Input reference

Deleting a conversation is permanent and cannot be reversed. Deleting a conversation permanently removes it from the inbox. All sensitive data is deleted, including admin and user replies, conversation attributes, uploads, and related content. The conversation will still appear in reporting, though some data may be incomplete due to the deletion.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.conversation_id` | `integer` | Yes | — | id |

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

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "{% admonition type=\"warning\" name=\"Irreversible operation\" %} Deleting a conversation is permanent and cannot be reversed. {% /admonition %} Deleting a conversation permanently removes it from the inbox. All sensitive data is deleted, including admin and user replies, conversation attributes, uploads, and related content. The conversation will still appear in reporting, though some data may be incomplete due to the deletion.",
    "properties": {
      "conversation_id": {
        "type": "integer",
        "description": "id"
      }
    },
    "required": [
      "conversation_id"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | deleted conversation object |
| `result.data.id` | `string` | No | — | The unique identifier for the conversation. |
| `result.data.object` | `"conversation"` | No | — | always conversation Allowed: `conversation`. |
| `result.data.deleted` | `boolean` | No | — | Whether the conversation is deleted or not. |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |

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

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "deleted conversation object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The unique identifier for the conversation."
          },
          "object": {
            "type": "string",
            "description": "always conversation",
            "enum": [
              "conversation"
            ]
          },
          "deleted": {
            "type": "boolean",
            "description": "Whether the conversation is deleted or not."
          }
        },
        "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

* [Intercom provider guide](https://deepline.com/docs/providers/intercom/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.