> ## 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: Conversation By External ID

> Find an Attention conversation by the ID it had in the system it was imported from. Includes inputs, outputs, SDK V2 examples, and Deepline cost.

Find an Attention conversation by the ID it had in the system it was imported from.

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

## 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_conversation_by_external_id',
  {
    "externalId": "external_123"
  },
);

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

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute attention_conversation_by_external_id --input '{
  "externalId": "external_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": {
    "conversation_id": "conversation_123"
  }
}
```

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

## Input reference

Looks up a conversation by its external application ID (the ID from the source system that originally imported the conversation). Returns the Attention conversation UUID if found.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.externalId` | `string` | Yes | — | The external application ID used when the conversation was imported |

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

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Looks up a conversation by its external application ID (the ID from the source system that originally imported the conversation). Returns the Attention conversation UUID if found.",
    "properties": {
      "externalId": {
        "type": "string",
        "description": "The external application ID used when the conversation was imported"
      }
    },
    "required": [
      "externalId"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.conversation_id` | `string` | No | — | Attention conversation UUID corresponding to the external ID |
| `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": "Provider response payload.",
        "properties": {
          "conversation_id": {
            "type": "string",
            "description": "Attention conversation UUID corresponding to the external ID"
          }
        },
        "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

* [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.