> ## 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: List Gihistory

> List the history of generalized insights for an Attention user. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.

List the history of generalized insights for an Attention user.

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

## 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_list_gihistory',
  {
    "user_uuid": "user_123"
  },
);

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

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute attention_list_gihistory --input '{
  "user_uuid": "user_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": {
    "links": {
      "self": "example",
      "related": "example"
    },
    "meta": {
      "pageCount": 123,
      "totalRecords": 123,
      "pageNumber": 123
    }
  }
}
```

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

## Input reference

Retrieves the history of generalized insights for a specific user. This endpoint allows you to track and analyze the evolution of insights over time, with options to control the response format and pagination.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.user_uuid` | `string` | Yes | — | Unique identifier of the user whose insight history is being requested |
| `payload.withoutEnhancingResults` | `boolean` | No | — | When set to true, returns raw insight data without additional processing or enhancement |
| `payload.limit` | `integer` | No | — | Maximum number of history entries to return |
| `payload.offset` | `integer` | No | — | Number of entries to skip before starting to collect the result set |

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

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Retrieves the history of generalized insights for a specific user. This endpoint allows you to track and analyze the evolution of insights over time, with options to control the response format and pagination.",
    "properties": {
      "user_uuid": {
        "type": "string",
        "description": "Unique identifier of the user whose insight history is being requested"
      },
      "withoutEnhancingResults": {
        "type": "boolean",
        "description": "When set to true, returns raw insight data without additional processing or enhancement"
      },
      "limit": {
        "type": "integer",
        "description": "Maximum number of history entries to return"
      },
      "offset": {
        "type": "integer",
        "description": "Number of entries to skip before starting to collect the result set"
      }
    },
    "required": [
      "user_uuid"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.data` | `array` | No | — | — |
| `result.data.data[].uuid` | `string` | Yes | — | — |
| `result.data.data[].user` | `object` | No | — | — |
| `result.data.data[].user.uuid` | `string` | No | — | — |
| `result.data.data[].title` | `string` | Yes | — | — |
| `result.data.data[].results` | `array` | Yes | — | — |
| `result.data.data[].results[].uuid` | `string` | Yes | — | — |
| `result.data.data[].results[].synthesis` | `string` | Yes | — | — |
| `result.data.data[].results[].prompt` | `string` | Yes | — | — |
| `result.data.data[].results[].status` | `"PENDING" \| "FINISHED"` | Yes | — | Allowed: `PENDING`, `FINISHED`. |
| `result.data.data[].results[].filtersUsed` | `object` | No | — | — |
| `result.data.data[].results[].filtersUsed.startDate` | `string` | No | — | Format: `date-time`. |
| `result.data.data[].results[].filtersUsed.endDate` | `string` | No | — | Format: `date-time`. |
| `result.data.data[].results[].filtersUsed.teams` | `array` | Yes | — | — |
| `result.data.data[].results[].filtersUsed.teams[].teamUUID` | `string` | Yes | — | — |
| `result.data.data[].results[].filtersUsed.teams[].teamName` | `string` | Yes | — | — |
| `result.data.data[].results[].filtersUsed.teamMembers` | `array` | Yes | — | — |
| `result.data.data[].results[].filtersUsed.teamMembers[].teamMemberUUID` | `string` | Yes | — | — |
| `result.data.data[].results[].filtersUsed.teamMembers[].teamMemberName` | `string` | Yes | — | — |
| `result.data.data[].results[].filtersUsed.teamMembers[].teamMemberLastName` | `string` | Yes | — | — |
| `result.data.data[].results[].filtersUsed.teamMembers[].teamMemberEmail` | `string` | Yes | — | — |
| `result.data.data[].results[].filtersUsed.opportunities` | `array` | Yes | — | — |
| `result.data.data[].results[].filtersUsed.opportunities[].opportunityUUID` | `string` | Yes | — | — |
| `result.data.data[].results[].filtersUsed.opportunities[].opportunityName` | `string` | Yes | — | — |
| `result.data.data[].results[].filtersUsed.conversations` | `array` | Yes | — | — |
| `result.data.data[].results[].filtersUsed.conversations[].conversationUUID` | `string` | Yes | — | — |
| `result.data.data[].results[].filtersUsed.conversations[].conversationTitle` | `string` | Yes | — | — |
| `result.data.data[].results[].filtersUsed.isInternal` | `boolean` | No | — | — |
| `result.data.data[].results[].filtersUsed.labels` | `array` | Yes | — | — |
| `result.data.data[].results[].filtersUsed.labels[].name` | `string` | Yes | — | — |
| `result.data.data[].results[].filtersUsed.labels[].values` | `array` | Yes | — | — |
| `result.data.data[].results[].items` | `array` | Yes | — | — |
| `result.data.data[].results[].items[].uuid` | `string` | Yes | — | — |
| `result.data.data[].results[].items[].summary` | `string` | Yes | — | — |
| `result.data.data[].results[].items[].evidence` | `object` | No | — | — |
| `result.data.data[].results[].items[].evidence.conversationsEvidence` | `array` | Yes | — | — |
| `result.data.data[].results[].items[].evidence.conversationsEvidence[].type` | `"CONVERSATION"` | Yes | — | Allowed: `CONVERSATION`. |
| `result.data.data[].results[].items[].evidence.conversationsEvidence[].conversationUUID` | `string` | Yes | — | — |
| `result.data.data[].results[].items[].evidence.conversationsEvidence[].conversationTitle` | `string` | Yes | — | — |
| `result.data.data[].results[].items[].evidence.conversationsEvidence[].finishedAt` | `string` | No | — | Format: `date-time`. |
| `result.data.data[].results[].items[].evidence.conversationsEvidence[].conversationQuotes` | `array` | Yes | — | — |
| `result.data.data[].results[].items[].evidence.conversationsEvidence[].conversationQuotes[].quote` | `string` | Yes | — | — |
| `result.data.data[].results[].items[].evidence.conversationsEvidence[].conversationQuotes[].reference` | `object` | No | — | — |
| `result.data.data[].results[].items[].evidence.conversationsEvidence[].conversationQuotes[].reference.startIdx` | `string` | Yes | — | — |
| `result.data.data[].results[].items[].evidence.conversationsEvidence[].conversationQuotes[].reference.endIdx` | `string` | Yes | — | — |
| `result.data.data[].results[].conversationsUsed` | `array` | Yes | — | — |
| `result.data.data[].results[].emailsUsed` | `array` | Yes | — | — |
| `result.data.data[].results[].type` | `"LIST" \| "TEXT_WITH_SOURCES" \| "SINGLE_QUOTE" \| "QUOTE_LIST" \| "SUMMARY_TABLE" \| "TABLE_QUOTES"` | Yes | — | Allowed: `LIST`, `TEXT_WITH_SOURCES`, `SINGLE_QUOTE`, `QUOTE_LIST`, `SUMMARY_TABLE`, `TABLE_QUOTES`. |
| `result.data.data[].results[].result` | `object` | Yes | — | — |

The table shows the first 50 fields. Expand the raw schema below for every field.

> [!NOTE]
>
> This output schema is too large for an inline display. Read the complete live contract with `deepline describe attention_list_gihistory --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.