> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Summarize Documents

Generate an AI summary of the requested documents.

**Note**, this action belongs to `Glean Chat API`, therefore requires using either the `Global Client Token` or the `User Client Token` connection methods.

<Note>
  External Documentation

  To learn more, visit the [Glean documentation](https://developers.glean.com/api/client-api/summarize/summarize).
</Note>

## Parameters

<div className="integrations-table">
  | Parameter                | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
  | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
  | Documents Specifications | An array of objects of documents specifications. Can be one of the following specification types:<br />\* An array of objects containing `URLs` of documents, Example:<br /><pre><code>\[<br />  \{<br />    "url": "[https://bluesky.test/blueskytest-1](https://bluesky.test/blueskytest-1)"<br />  },<br />  \{<br />    "url": "[https://bluesky.test/blueskytest-2](https://bluesky.test/blueskytest-2)"<br />  }<br />]</code></pre>\* An array of objects containing `document IDs`, Example:<br /><pre><code>\[<br />  \{<br />    "id": "8739af2e1c89456b"<br />  },<br />  \{<br />    "id": "7489bf2s8v98738g"<br />  }<br />]</code></pre>\* An array of objects containing `content data`, Example:<br /><pre><code>\[<br />  \{<br />    "contentId": 101,<br />    "docType": "xxxxx",<br />    "ugcType": "ANNOUNCEMENTS"<br />  },<br />  \{<br />    "contentId": 202,<br />    "docType": "xxxxx",<br />    "ugcType": "ANSWERS"<br />  }<br />]</code></pre>For more information on the different specification options, please refer to [Glean's Documentation](https://developers.glean.com/api/client-api/summarize/summarize). |
  | Preferred Summary Length | Length of summary output.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
  | Query                    | A query that the summary should be about.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
  | Timestamp                | A timestamp associated with the client request.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
  | Tracking Token           | An opaque token that represents this particular result.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
</div>

## Example Output

```json theme={"dark"}
{
	"error": {
		"message": "string"
	},
	"summary": {
		"text": "string",
		"followUpPrompts": [
			"string"
		]
	},
	"trackingToken": "string"
}
```

## Workflow Library Example

[Summarize Documents with Glean and Send Results Via Email](https://library.blinkops.com/workflows/summarize-documents-with-glean-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/summarize-documents-with-glean-and-send-results-via-email/canvas" />
</div>
