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

ActionWhat it does
Add item to collectionAdd a link to a collection, or a text note when no address is given.
Ask Glean AssistantAsk Glean Assistant a question about your company's knowledge.
Create announcementPost an announcement that everyone at your company sees in Glean between a start and an end time.
Create answerAdd a question and its answer to Glean, so search and Glean Assistant can give it to others.
Create collectionCreate a collection to gather documents and links under one name.
Create go linkCreate a go link, such as go/team-wiki, that takes everyone at your company to an address.
Delete announcementDelete an announcement, taking it down if it is showing.
Delete answerDelete an answer from Glean.
Delete collectionDelete a collection.
Delete go linkDelete a go link, so it no longer opens anything.
Find peopleFind people in your company directory by name, title, team or other details.
Get agent runCheck on an agent run started by 'Run agent': its state and what the agent has said.
Get answerGet one answer: its question, answer, author and dates.
Get collectionGet one collection with every item in it.
Get documentsGet documents' details from Glean (title, app, author, owner, dates) and, if you want, their full text.
Get go linkGet one go link: where it leads, who made it and when.
Get personGet someone's profile from your company directory: title, department, location, manager and more.
List agentsList the Glean agents you can run, optionally only those whose name contains some text.
List collectionsList the collections you can see, optionally only those whose name contains some text.
List go linksList the go links you can edit, optionally only those matching some text.
Remove item from collectionTake one item out of a collection.
Run agentRun a Glean agent with a message or its form's fields, and wait up to five minutes for its answer.
SearchSearch everything you can see in Glean, across all your company's connected apps.
Summarize documentsHave Glean write a short summary of one or more documents, optionally about a question you give.
Update answerChange an answer's question, answer or other phrasings.
Update go linkChange 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

Collectioncollection_idtextRequired
The collection. Pick one, or give its number from an earlier step.
Addressurltext
The web address to add, such as a document's url.
Namenametext
A name to show for it. Needed for a text note.
Descriptiondescriptiontext
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

QuestionquestiontextRequired
What to ask, in your own words.
Continue conversationconversation_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

TitletitletextRequired
The headline.
Textbodytext
The announcement's text.
Startsstarts_atdate and time
When it starts showing. Leave empty for now.
Endsends_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

QuestionquestiontextRequired
The question people ask.
Answeranswer_texttextRequired
The answer, as plain text.
Other ways to askquestion_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

NamenametextRequired
The collection's name, which must be unique.
Descriptiondescriptiontext
What the collection is for.
Emojiicontext
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 a go link, such as go/team-wiki, that takes everyone at your company to an address.

Inputs

NamealiastextRequired
The part after go/, such as team-wiki.
Goes todestination_urltextRequired
The web address the go link opens.
Descriptiondescriptiontext
What the go link is for.
Unlistedunlistedtrue/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

Announcementannouncement_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

Answeranswer_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

Collectioncollection_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 a go link, so it no longer opens anything.

Inputs

Go linkgo_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 forquerytext
A name, title, team or other detail. Leave empty to list everyone.
Page sizepage_sizenumber
How many to return, 1 to 100.From 1 to 100.
Next pagecursortext
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

Agentagent_idtextRequired
The agent. Pick one, or give its ID from 'List agents' or the end of its address in Agent Builder.
Run IDrun_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

Answeranswer_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

Collectioncollection_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

DocumentsdocumentslistRequired
Up to 20 documents, each by its web address (such as a search result's url) or its Glean document ID.
Include full textinclude_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 one go link: where it leads, who made it and when.

Inputs

Go linkgo_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 IDpersontext
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 containsnametext
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 containsnametext
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 the go links you can edit, optionally only those matching some text.

Inputs

Search forsearchtext
Text in the name, address or description. Leave empty for all.
Page sizepage_sizenumber
How many to return, 1 to 100.From 1 to 100.
Next pagecursortext
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

Collectioncollection_idtextRequired
The collection. Pick one, or give its number from an earlier step.
Item IDitem_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

Agentagent_idtextRequired
The agent. Pick one, or give its ID from 'List agents' or the end of its address in Agent Builder.
Messagemessagetext
What to ask the agent, for an agent that takes a message.
Form fieldsinputsobject
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 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 forquerytextRequired
What to search for. Glean's operators work too, such as from:jane or app:confluence.
Appsdatasourceslist
Only results from these apps. Leave empty for all.
Updated on or afterupdated_afterdate
Only results last changed on or after this date.
Updated on or beforeupdated_beforedate
Only results last changed on or before this date.
Page sizepage_sizenumber
How many to return, 1 to 100.From 1 to 100.
Next pagecursortext
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

DocumentsdocumentslistRequired
Up to 20 documents, each by its web address (such as a search result's url) or its Glean document ID.
Focus onfocustext
A question or topic the summary should be about.
Lengthsummary_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

Answeranswer_idtextRequired
The answer's number, from 'Create answer' or an earlier step.
Questionquestiontext
A new question. Leave empty to keep it.
Answeranswer_texttext
A new answer. Leave empty to keep it.
Other ways to askquestion_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"
  }
}

Change a go link's name, address, description or visibility. Only the fields given change.

Inputs

Go linkgo_linktextRequired
The go link. Pick one, or give its name (such as team-wiki) or number.
New namealiastext
A new name after go/. Leave empty to keep it.
Goes todestination_urltext
A new address. Leave empty to keep it.
Descriptiondescriptiontext
A new description. Leave empty to keep it.
Unlistedunlistedtrue/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"
  }
}

On this page