Glean
App · 26 actions
Search your company's knowledge with Glean, ask Glean Assistant and get answers with their sources, summarize documents, run Glean agents, look people up, and manage answers, collections, go links and announcements.
Actions
| Action | What it does |
|---|---|
| Add item to collection | Add a link to a collection, or a text note when no address is given. |
| Ask Glean Assistant | Ask Glean Assistant a question about your company's knowledge. |
| Create announcement | Post an announcement that everyone at your company sees in Glean between a start and an end time. |
| Create answer | Add a question and its answer to Glean, so search and Glean Assistant can give it to others. |
| Create collection | Create a collection to gather documents and links under one name. |
| Create go link | Create a go link, such as go/team-wiki, that takes everyone at your company to an address. |
| Delete announcement | Delete an announcement, taking it down if it is showing. |
| Delete answer | Delete an answer from Glean. |
| Delete collection | Delete a collection. |
| Delete go link | Delete a go link, so it no longer opens anything. |
| Find people | Find people in your company directory by name, title, team or other details. |
| Get agent run | Check on an agent run started by 'Run agent': its state and what the agent has said. |
| Get answer | Get one answer: its question, answer, author and dates. |
| Get collection | Get one collection with every item in it. |
| Get documents | Get documents' details from Glean (title, app, author, owner, dates) and, if you want, their full text. |
| Get go link | Get one go link: where it leads, who made it and when. |
| Get person | Get someone's profile from your company directory: title, department, location, manager and more. |
| List agents | List the Glean agents you can run, optionally only those whose name contains some text. |
| List collections | List the collections you can see, optionally only those whose name contains some text. |
| List go links | List the go links you can edit, optionally only those matching some text. |
| Remove item from collection | Take one item out of a collection. |
| Run agent | Run a Glean agent with a message or its form's fields, and wait up to five minutes for its answer. |
| Search | Search everything you can see in Glean, across all your company's connected apps. |
| Summarize documents | Have Glean write a short summary of one or more documents, optionally about a question you give. |
| Update answer | Change an answer's question, answer or other phrasings. |
| Update go link | Change a go link's name, address, description or visibility. |
Add item to collection
Add a link to a collection, or a text note when no address is given. Returns the new item and its ID.
Inputs
- Collection
collection_idtextRequired - The collection. Pick one, or give its number from an earlier step.
- Address
urltext - The web address to add, such as a document's url.
- Name
nametext - A name to show for it. Needed for a text note.
- Description
descriptiontext - Why it is in the collection.
Outputs
collectionobject- A collection
itemobject- An item in a collection
item_idtext- The new item's ID, for 'Remove item from collection'
Example output
{
"collection": {
"created_at": "2026-10-24T09:00:00Z",
"creator": "Jane Doe",
"description": "Everything a new hire needs.",
"icon": "\ud83d\udcda",
"id": 42,
"item_count": 1,
"items": [
{
"description": "Where we keep runbooks.",
"document_id": "",
"item_id": "item_1",
"item_type": "URL",
"name": "Team wiki",
"url": "https://example.com/wiki"
}
],
"name": "Onboarding",
"updated_at": "2026-10-24T09:00:00Z"
},
"item": {
"description": "Where we keep runbooks.",
"document_id": "",
"item_id": "item_1",
"item_type": "URL",
"name": "Team wiki",
"url": "https://example.com/wiki"
},
"item_id": "item_1"
}Ask Glean Assistant
Ask Glean Assistant a question about your company's knowledge. Returns the answer as plain text, the sources it cites, and a conversation ID for a follow-up question.
Inputs
- Question
questiontextRequired - What to ask, in your own words.
- Continue conversation
conversation_idtext - A conversation ID from an earlier answer, to ask a follow-up. Leave empty to start a new conversation.
Outputs
answertext- The answer, as plain text
citationslist- The sources it cites
conversation_idtext- Give this to ask a follow-up
Example output
{
"answer": "Book travel through Navan; flights over 6 hours may be business class.",
"citations": [
{
"datasource": "gdrive",
"title": "Travel policy",
"type": "document",
"url": "https://example.com/travel"
}
],
"conversation_id": "conv_01HX"
}Create announcement
Post an announcement that everyone at your company sees in Glean between a start and an end time. You need permission to post announcements in Glean.
Inputs
- Title
titletextRequired - The headline.
- Text
bodytext - The announcement's text.
- Starts
starts_atdate and time - When it starts showing. Leave empty for now.
- Ends
ends_atdate and timeRequired - When it stops showing.
Outputs
announcementobject- An announcement
Example output
{
"announcement": {
"author": "Jane Doe",
"body": "The office is closed for the holiday.",
"created_at": "2026-10-24T09:00:00Z",
"ends_at": "2026-10-31T17:00:00Z",
"id": 11,
"is_published": true,
"starts_at": "2026-10-27T09:00:00Z",
"title": "Office closed Friday",
"view_url": ""
}
}Create answer
Add a question and its answer to Glean, so search and Glean Assistant can give it to others.
Inputs
- Question
questiontextRequired - The question people ask.
- Answer
answer_texttextRequired - The answer, as plain text.
- Other ways to ask
question_variationslist - Other phrasings of the question, so more searches find it.
Outputs
answerobject- An answer
Example output
{
"answer": {
"answer_text": "Blue light is scattered more than red light.",
"author": "Jane Doe",
"created_at": "2026-10-24T09:00:00Z",
"doc_id": "ANSWERS_answer_3",
"id": 3,
"question": "Why is the sky blue?",
"question_variations": [],
"updated_at": "2026-10-24T09:00:00Z"
}
}Create collection
Create a collection to gather documents and links under one name.
Inputs
- Name
nametextRequired - The collection's name, which must be unique.
- Description
descriptiontext - What the collection is for.
- Emoji
icontext - An emoji to show with it, such as 📚.
Outputs
collectionobject- A collection
Example output
{
"collection": {
"created_at": "2026-10-24T09:00:00Z",
"creator": "Jane Doe",
"description": "Everything a new hire needs.",
"icon": "\ud83d\udcda",
"id": 42,
"item_count": 0,
"items": [],
"name": "Onboarding",
"updated_at": "2026-10-24T09:00:00Z"
}
}Create go link
Create a go link, such as go/team-wiki, that takes everyone at your company to an address.
Inputs
- Name
aliastextRequired - The part after go/, such as team-wiki.
- Goes to
destination_urltextRequired - The web address the go link opens.
- Description
descriptiontext - What the go link is for.
- Unlisted
unlistedtrue/false - Hide it from everyone but you and Glean admins.
Outputs
go_linkobject- A go link
Example output
{
"go_link": {
"alias": "team-wiki",
"created_at": "2026-10-24T09:00:00Z",
"created_by": "Jane Doe",
"description": "The team wiki.",
"destination_url": "https://example.com/wiki",
"id": 7,
"link": "go/team-wiki",
"unlisted": false,
"updated_at": "2026-10-24T09:00:00Z"
}
}Delete announcement
Delete an announcement, taking it down if it is showing.
Inputs
- Announcement
announcement_idtextRequired - The announcement's number, from 'Create announcement'.
Outputs
announcement_idnumber- The announcement deleted
deletedtrue/false- Always true once deleted
Example output
{
"announcement_id": 11,
"deleted": true
}Delete answer
Delete an answer from Glean.
Inputs
- Answer
answer_idtextRequired - The answer's number, from 'Create answer' or an earlier step.
Outputs
answer_idtext- The answer deleted
deletedtrue/false- Always true once deleted
Example output
{
"answer_id": "3",
"deleted": true
}Delete collection
Delete a collection. The documents in it are not touched.
Inputs
- Collection
collection_idtextRequired - The collection. Pick one, or give its number from an earlier step.
Outputs
collection_idnumber- The collection deleted
deletedtrue/false- Always true once deleted
Example output
{
"collection_id": 42,
"deleted": true
}Delete go link
Delete a go link, so it no longer opens anything.
Inputs
- Go link
go_linktextRequired - The go link. Pick one, or give its name (such as team-wiki) or number.
Outputs
deletedtrue/false- Always true once deleted
go_link_idnumber- The go link deleted
Example output
{
"deleted": true,
"go_link_id": 7
}Find people
Find people in your company directory by name, title, team or other details.
Inputs
- Search for
querytext - A name, title, team or other detail. Leave empty to list everyone.
- Page size
page_sizenumber - How many to return, 1 to 100.From 1 to 100.
- Next page
cursortext - The 'next_cursor' from an earlier page, to get the page after it.
Outputs
countnumber- How many on this page
has_moretrue/false- True if there are more
next_cursortext- Give as 'Next page' for the page after; empty on the last
peoplelist- The people found
Example output
{
"count": 1,
"has_more": false,
"next_cursor": "",
"people": [
{
"business_unit": "Product",
"department": "Engineering",
"email": "jane@example.com",
"employee_type": "FULL_TIME",
"id": "abc123",
"location": "San Francisco",
"manager_email": "sam@example.com",
"manager_id": "def456",
"manager_name": "Sam Lee",
"name": "Jane Doe",
"phone": "",
"photo_url": "",
"start_date": "2022-03-01",
"timezone": "America/Los_Angeles",
"title": "Engineering Manager"
}
]
}Get agent run
Check on an agent run started by 'Run agent': its state and what the agent has said.
Inputs
- Agent
agent_idtextRequired - The agent. Pick one, or give its ID from 'List agents' or the end of its address in Agent Builder.
- Run ID
run_idtextRequired - The run_id from 'Run agent'.
Outputs
agent_idtext- The agent's ID
answertext- What the agent said, as plain text
created_attext- When the run started (ISO 8601)
errortext- Why the run failed, if it did
finishedtrue/false- True once the run has ended
messageslist- The run's messages in order
run_idtext- The run's ID, for 'Get agent run'
statetext- QUEUED, RUNNING, REQUIRES_INPUT, SUCCEEDED, FAILED, CANCELLING, CANCELLED or EXPIRED
updated_attext- When the run last changed (ISO 8601)
waiting_for_approvallist- Tools the agent wants to use that someone must approve in Glean
Example output
{
"agent_id": "mho4lwzylcozgoc2",
"answer": "Parental leave is 16 weeks at full pay.",
"created_at": "2026-10-24T09:00:00Z",
"error": "",
"finished": true,
"messages": [
{
"role": "USER",
"text": "What is our parental leave policy?"
},
{
"role": "GLEAN_AI",
"text": "Parental leave is 16 weeks at full pay."
}
],
"run_id": "run_01JAGENT",
"state": "SUCCEEDED",
"updated_at": "2026-10-24T09:00:20Z",
"waiting_for_approval": []
}Get answer
Get one answer: its question, answer, author and dates.
Inputs
- Answer
answer_idtextRequired - The answer's number, from 'Create answer' or an earlier step.
Outputs
answerobject- An answer
Example output
{
"answer": {
"answer_text": "Blue light is scattered more than red light.",
"author": "Jane Doe",
"created_at": "2026-10-24T09:00:00Z",
"doc_id": "ANSWERS_answer_3",
"id": 3,
"question": "Why is the sky blue?",
"question_variations": [],
"updated_at": "2026-10-24T09:00:00Z"
}
}Get collection
Get one collection with every item in it.
Inputs
- Collection
collection_idtextRequired - The collection. Pick one, or give its number from an earlier step.
Outputs
collectionobject- A collection
Example output
{
"collection": {
"created_at": "2026-10-24T09:00:00Z",
"creator": "Jane Doe",
"description": "Everything a new hire needs.",
"icon": "\ud83d\udcda",
"id": 42,
"item_count": 1,
"items": [
{
"description": "Where we keep runbooks.",
"document_id": "",
"item_id": "item_1",
"item_type": "URL",
"name": "Team wiki",
"url": "https://example.com/wiki"
}
],
"name": "Onboarding",
"updated_at": "2026-10-24T09:00:00Z"
}
}Get documents
Get documents' details from Glean (title, app, author, owner, dates) and, if you want, their full text.
Inputs
- Documents
documentslistRequired - Up to 20 documents, each by its web address (such as a search result's url) or its Glean document ID.
- Include full text
include_contenttrue/false - Also return each document's full text.
Outputs
countnumber- How many were found
documentslist- The documents found
not_foundlist- Documents Glean could not find or you can't open
Example output
{
"count": 1,
"documents": [
{
"author": "Jane Doe",
"container": "Engineering",
"content": "",
"created_at": "2026-04-01T09:00:00Z",
"datasource": "confluence",
"doc_type": "page",
"id": "CONFLUENCE_12345",
"owner": "Jane Doe",
"status": "",
"title": "Q2 2026 Platform Roadmap",
"updated_at": "2026-10-20T14:00:00Z",
"url": "https://company.atlassian.net/wiki/spaces/ENG/pages/12345"
}
],
"not_found": []
}Get go link
Get one go link: where it leads, who made it and when.
Inputs
- Go link
go_linktextRequired - The go link. Pick one, or give its name (such as team-wiki) or number.
Outputs
go_linkobject- A go link
Example output
{
"go_link": {
"alias": "team-wiki",
"created_at": "2026-10-24T09:00:00Z",
"created_by": "Jane Doe",
"description": "The team wiki.",
"destination_url": "https://example.com/wiki",
"id": 7,
"link": "go/team-wiki",
"unlisted": false,
"updated_at": "2026-10-24T09:00:00Z"
}
}Get person
Get someone's profile from your company directory: title, department, location, manager and more. Leave the person empty to get your own.
Inputs
- Email or person ID
persontext - Their work email, or a person ID from an earlier step. Leave empty for yourself.
Outputs
personobject- A person
Example output
{
"person": {
"business_unit": "Product",
"department": "Engineering",
"email": "jane@example.com",
"employee_type": "FULL_TIME",
"id": "abc123",
"location": "San Francisco",
"manager_email": "sam@example.com",
"manager_id": "def456",
"manager_name": "Sam Lee",
"name": "Jane Doe",
"phone": "",
"photo_url": "",
"start_date": "2022-03-01",
"timezone": "America/Los_Angeles",
"title": "Engineering Manager"
}
}List agents
List the Glean agents you can run, optionally only those whose name contains some text.
Inputs
- Name contains
nametext - Only agents whose name contains this. Leave empty for all.
Outputs
agentslist- The agents
countnumber- How many
Example output
{
"agents": [
{
"agent_id": "mho4lwzylcozgoc2",
"description": "Answers HR policy questions.",
"name": "HR Policy Agent"
}
],
"count": 1
}List collections
List the collections you can see, optionally only those whose name contains some text.
Inputs
- Name contains
nametext - Only collections whose name contains this. Leave empty for all.
Outputs
collectionslist- The collections
countnumber- How many
Example output
{
"collections": [
{
"created_at": "2026-10-24T09:00:00Z",
"creator": "Jane Doe",
"description": "Everything a new hire needs.",
"icon": "\ud83d\udcda",
"id": 42,
"item_count": 1,
"items": [],
"name": "Onboarding",
"updated_at": "2026-10-24T09:00:00Z"
}
],
"count": 1
}List go links
List the go links you can edit, optionally only those matching some text.
Inputs
- Search for
searchtext - Text in the name, address or description. Leave empty for all.
- Page size
page_sizenumber - How many to return, 1 to 100.From 1 to 100.
- Next page
cursortext - The 'next_cursor' from an earlier page, to get the page after it.
Outputs
countnumber- How many on this page
go_linkslist- The go links
has_moretrue/false- True if there are more
next_cursortext- Give as 'Next page' for the page after; empty on the last
totalnumber- How many match in all
Example output
{
"count": 1,
"go_links": [
{
"alias": "team-wiki",
"created_at": "2026-10-24T09:00:00Z",
"created_by": "Jane Doe",
"description": "The team wiki.",
"destination_url": "https://example.com/wiki",
"id": 7,
"link": "go/team-wiki",
"unlisted": false,
"updated_at": "2026-10-24T09:00:00Z"
}
],
"has_more": false,
"next_cursor": "",
"total": 1
}Remove item from collection
Take one item out of a collection. The document itself is not touched.
Inputs
- Collection
collection_idtextRequired - The collection. Pick one, or give its number from an earlier step.
- Item ID
item_idtextRequired - The item's ID, from 'Get collection' or 'Add item to collection'.
Outputs
collectionobject- A collection
item_idtext- The item removed
removedtrue/false- Always true once removed
Example output
{
"collection": {
"created_at": "2026-10-24T09:00:00Z",
"creator": "Jane Doe",
"description": "Everything a new hire needs.",
"icon": "\ud83d\udcda",
"id": 42,
"item_count": 0,
"items": [],
"name": "Onboarding",
"updated_at": "2026-10-24T09:00:00Z"
},
"item_id": "item_1",
"removed": true
}Run agent
Run a Glean agent with a message or its form's fields, and wait up to five minutes for its answer. A run that takes longer comes back unfinished with a run ID for 'Get agent run'.
Inputs
- Agent
agent_idtextRequired - The agent. Pick one, or give its ID from 'List agents' or the end of its address in Agent Builder.
- Message
messagetext - What to ask the agent, for an agent that takes a message.
- Form fields
inputsobject - The agent's form fields, for an agent with an input form. Fields left empty are sent empty.
Outputs
agent_idtext- The agent's ID
answertext- What the agent said, as plain text
created_attext- When the run started (ISO 8601)
errortext- Why the run failed, if it did
finishedtrue/false- True once the run has ended
messageslist- The run's messages in order
run_idtext- The run's ID, for 'Get agent run'
statetext- QUEUED, RUNNING, REQUIRES_INPUT, SUCCEEDED, FAILED, CANCELLING, CANCELLED or EXPIRED
updated_attext- When the run last changed (ISO 8601)
waiting_for_approvallist- Tools the agent wants to use that someone must approve in Glean
Example output
{
"agent_id": "mho4lwzylcozgoc2",
"answer": "Parental leave is 16 weeks at full pay.",
"created_at": "2026-10-24T09:00:00Z",
"error": "",
"finished": true,
"messages": [
{
"role": "USER",
"text": "What is our parental leave policy?"
},
{
"role": "GLEAN_AI",
"text": "Parental leave is 16 weeks at full pay."
}
],
"run_id": "run_01JAGENT",
"state": "SUCCEEDED",
"updated_at": "2026-10-24T09:00:20Z",
"waiting_for_approval": []
}Search
Search everything you can see in Glean, across all your company's connected apps. Returns one page of results with their titles, addresses and matching passages.
Inputs
- Search for
querytextRequired - What to search for. Glean's operators work too, such as from:jane or app:confluence.
- Apps
datasourceslist - Only results from these apps. Leave empty for all.
- Updated on or after
updated_afterdate - Only results last changed on or after this date.
- Updated on or before
updated_beforedate - Only results last changed on or before this date.
- Page size
page_sizenumber - How many to return, 1 to 100.From 1 to 100.
- Next page
cursortext - The 'next_cursor' from an earlier page, to get the page after it.
Outputs
countnumber- How many on this page
has_moretrue/false- True if there are more
next_cursortext- Give as 'Next page' for the page after; empty on the last
resultslist- The results, best first
warningslist- Anything Glean noted, such as partial results
Example output
{
"count": 1,
"has_more": false,
"next_cursor": "",
"results": [
{
"created_at": "2026-04-01T09:00:00Z",
"creator": "Jane Doe",
"datasource": "confluence",
"document_type": "page",
"owner": "Jane Doe",
"snippets": [
"The platform team will focus on API stability and..."
],
"title": "Q2 2026 Platform Roadmap",
"updated_at": "2026-10-20T14:00:00Z",
"url": "https://company.atlassian.net/wiki/spaces/ENG/pages/12345"
}
],
"warnings": []
}Summarize documents
Have Glean write a short summary of one or more documents, optionally about a question you give.
Inputs
- Documents
documentslistRequired - Up to 20 documents, each by its web address (such as a search result's url) or its Glean document ID.
- Focus on
focustext - A question or topic the summary should be about.
- Length
summary_lengthnumber - About how many characters, 100 to 5000. Glean's default is 500.From 100 to 5000.
Outputs
follow_up_promptslist- Questions worth asking next
summarytext- The summary
Example output
{
"follow_up_prompts": [
"Who owns API stability?"
],
"summary": "The roadmap puts API stability first, then search speed."
}Update answer
Change an answer's question, answer or other phrasings. Only the fields given change.
Inputs
- Answer
answer_idtextRequired - The answer's number, from 'Create answer' or an earlier step.
- Question
questiontext - A new question. Leave empty to keep it.
- Answer
answer_texttext - A new answer. Leave empty to keep it.
- Other ways to ask
question_variationslist - Other phrasings of the question, so more searches find it.
Outputs
answerobject- An answer
Example output
{
"answer": {
"answer_text": "Rayleigh scattering.",
"author": "Jane Doe",
"created_at": "2026-10-24T09:00:00Z",
"doc_id": "ANSWERS_answer_3",
"id": 3,
"question": "Why is the sky blue?",
"question_variations": [],
"updated_at": "2026-10-24T09:00:00Z"
}
}Update go link
Change a go link's name, address, description or visibility. Only the fields given change.
Inputs
- Go link
go_linktextRequired - The go link. Pick one, or give its name (such as team-wiki) or number.
- New name
aliastext - A new name after go/. Leave empty to keep it.
- Goes to
destination_urltext - A new address. Leave empty to keep it.
- Description
descriptiontext - A new description. Leave empty to keep it.
- Unlisted
unlistedtrue/false - Hide it from everyone but you and Glean admins.
Outputs
go_linkobject- A go link
Example output
{
"go_link": {
"alias": "team-wiki",
"created_at": "2026-10-24T09:00:00Z",
"created_by": "Jane Doe",
"description": "The team wiki.",
"destination_url": "https://example.com/new",
"id": 7,
"link": "go/team-wiki",
"unlisted": false,
"updated_at": "2026-10-24T09:00:00Z"
}
}