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

> Get an Attention call recording by its ID, with transcript, participants and details. Includes inputs, outputs, SDK V2 examples, and Deepline cost.

Get an Attention call recording by its ID, with transcript, participants and details.

> [!NOTE]
>
> Tool ID: `attention_conversation_by_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_id',
  {
    "id": "id_123"
  },
);

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

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute attention_conversation_by_id --input '{
  "id": "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": {
    "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_conversation_by_id --json` for the latest machine-readable contract.

## Input reference

Retrieves detailed information about a specific conversation, including its transcription, participants, and metadata. The response can be customized to include or exclude certain details based on the query parameters.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.id` | `string` | Yes | — | Unique identifier of the conversation |
| `payload.by` | `"id" \| "external_id"` | No | `"id"` | Specify how to lookup the conversation: 'id' for internal conversation ID (default), 'external\_id' for external application ID from imports Allowed: `id`, `external_id`. |
| `payload.filter` | `object` | No | — | Include internal participants in the response |
| `payload.detailedTranscript` | `boolean` | No | `false` | Include detailed transcript information in the response |

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

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Retrieves detailed information about a specific conversation, including its transcription, participants, and metadata. The response can be customized to include or exclude certain details based on the query parameters.",
    "properties": {
      "id": {
        "type": "string",
        "description": "Unique identifier of the conversation"
      },
      "by": {
        "type": "string",
        "description": "Specify how to lookup the conversation: 'id' for internal conversation ID (default), 'external_id' for external application ID from imports",
        "default": "id",
        "enum": [
          "id",
          "external_id"
        ]
      },
      "filter": {
        "type": "object",
        "description": "Include internal participants in the response",
        "properties": {
          "include_internal_participants": {
            "type": "boolean",
            "description": "Include internal participants in the response"
          },
          "include_zoom_metadata": {
            "type": "boolean",
            "description": "Include Zoom-specific metadata in the response"
          },
          "include_import_metadata": {
            "type": "boolean",
            "description": "Include import metadata in the response"
          }
        },
        "required": [],
        "additionalProperties": false
      },
      "detailedTranscript": {
        "type": "boolean",
        "description": "Include detailed transcript information in the response",
        "default": false
      }
    },
    "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.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_conversation_by_id --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.