---
title: "What agents can do"
description: "Every task a connected agent can do in undocsend, grouped by job, with the permission each one needs."
canonical: "https://undocsend.com/docs/agents/what-agents-can-do"
last_updated: "2026-11-19"
---

# What agents can do

Every task a connected agent can do in undocsend, grouped by job, with the permission each one needs.

## How to read this page

A connected agent has 55 tools. You don’t call them yourself: you ask in plain language and the agent picks the right one. This page lists each tool as a task, with the permission it needs:

- **Read**: look, never change.
- **Build**: create and organise.
- **Share**: anything that reaches people outside your team. Off unless you tick it.

You choose these when you [approve the connection](https://undocsend.com/docs/agents/connect#approval-screen). The tool name is shown in grey in case your app displays it.

> Some tasks never happen straight away. Deleting, opening a room up, removing a teammate, and adding a file to a room people have already visited become a request you approve. See [Asking for approval](https://undocsend.com/docs/agents/what-agents-can-do#requests).

## Workspace and rooms

- See the workspace: name, plan and status (Read): `get_workspace`
- List all rooms, with their state, NDA and access settings (Read): `list_rooms`
- Look at one room: access mode, settings, folders and counts (Read): `get_room`
- See who may see and download each folder and file in a room (Read): `list_room_permissions`

## Documents and search

- List the documents in a room, or your whole library, newest first (Read): `list_documents` · shows the rooms each file is in and how many links share it
- Look at one document: folder, status, versions, its saved summary and where it is used (Read): `get_document`
- Read a document’s text, page by page (Read): `get_document_text` · up to 60,000 characters per call
- Search the documents in a room by keyword (Read): `search_documents`
- See a document’s earlier versions (Read): `list_document_versions` · it can’t restore one

## Building rooms

- Create a room (Build): `create_room` · always behind an email gate or a password, never public; stops at your plan’s room limit
- Change room settings (Build): `update_room_settings` · tightening only; see [what it can’t loosen](https://undocsend.com/docs/agents/permissions-and-approvals#never-directly)
- Create a folder (Build): `create_folder`
- Rename a folder (Build): `rename_folder`
- Reorder folders (Build): `reorder` · documents always show newest first
- Move a document to another folder in one of its rooms (Build): `move_document` · if more people can see the new folder, this becomes a request
- Change a document’s title or description, or lower its downloads (Build): `update_document` · it can’t raise downloads
- Add a file from your library to a room (Share): `add_to_room` · it stays one file; once people have visited the room, this becomes a request
- Remove a file from a room (Share): `remove_from_room` · it stays in your library and its other rooms and links

## Uploading documents

- Upload a document into a room, or into your library only (Build): `upload_document`
- Upload a new version of a document, keeping its links and permissions (Build): `replace_document` · the new version shows everywhere the file is used
- Finish an upload (Build): `finalize_upload`
- Check how an upload is processing (Build): `get_upload_status`
- Give you a browser link to upload files yourself (Build): `create_upload_link` · works for 24 hours
- Publish an interactive page (a self-contained HTML file) as a document (Build): `push_artifact` · up to 5 MB

## Setup wizard and knowledge

- Get the standard folder layout for a deal stage (Read): `get_room_template` · free
- Run the setup wizard to propose a room structure (Build): `run_setup_wizard` · uses AI credits
- Propose a room structure of its own (Build): `apply_room_structure` · free
- Accept a proposal and create its folders (Build): `accept_wizard_proposal`
- Read the workspace knowledge: your voice, thesis and briefings (Read): `list_knowledge`
- Add or update a knowledge entry (Build): `update_knowledge` · it can’t delete one

## Sharing and invites

- List share links, with their settings, visits, views and expiry (Read): `list_share_links`
- Create a share link to a room’s files, some documents from any room, or one document (Share): `create_share_link` · visitors always verify their email; it can add a password or an NDA, but never allow downloads or turn the watermark off
- Change a share link (Share): `update_share_link` · links it made can change within those limits, others only get stricter; never who the link is for
- Email investors their own personal link (Share): `invite_investors` · up to 50 people a day per workspace; you get a summary email
- Revoke a share link, or a visitor’s access everywhere (Share): `revoke_access` · takes effect immediately

## Who sees and downloads which files

- Set which audiences can see a folder or file in a room (Share): `set_item_audiences` · narrowing is immediate; showing it to more people becomes a request
- Set a room’s downloads for each group, or one file’s for a group (Share): `set_room_downloads` · lowering is immediate; it can’t raise downloads

Reading the current rules and download settings is `list_room_permissions`, under [Workspace and rooms](https://undocsend.com/docs/agents/what-agents-can-do#workspace-and-rooms).

## Investor questions

An agent can help with questions, but it can never send an answer. A person on your team approves and sends.

- List unanswered investor questions (Read): `list_open_questions`
- Draft an answer from your documents (Build): `draft_answer` · uses AI credits
- Save an answer it wrote itself as a draft (Build): `save_answer_draft`
- Close a question (Build): `dismiss_question` · the visitor sees it as closed
- Set a question’s category or due date (Build): `update_question`

## Analytics and activity

- See how a room is doing: views, top documents and visitors (Read): `get_room_analytics` · includes visitor emails
- See the most engaged and most recent visitors (Read): `get_visitor_activity`
- See which investors’ AI tools read which documents (Read): `list_agent_access` · as reported by those tools
- Read recent audit log entries (Read): `get_audit_log`

## Team and records

- List team members and pending invites (Read): `list_team_members`
- List document requests you sent to others, and what came back (Read): `list_upload_requests`
- See who accepted an NDA or agreement (Read): `list_agreement_acceptances`
- See requests for access to a room (Read): `list_access_requests` · read only: you decide them

## Asking for approval

These tools don’t change anything. They send you a request to approve in undocsend. See [how approval requests work](https://undocsend.com/docs/agents/permissions-and-approvals#approval-requests).

- Ask to delete documents (from every room and link), folders or share links, or archive rooms (Build): `request_deletion` · up to 25 items per request
- Ask to change how people get into a room (public, email gate, email gate without login) (Build): `request_access_change`
- Ask to remove a team member (Build): `request_member_removal` · never the owner
- Check on a request it sent (Read): `get_action_request`
- Withdraw a request it sent, before you decide on it (Build): `cancel_action_request` · only its own, only while waiting

## Tasks that use AI credits

Two tasks spend your workspace’s AI credits, the same way they do in the dashboard:

- **Running the setup wizard** (`run_setup_wizard`).
- **Drafting an answer** to an investor question (`draft_answer`).

If your workspace uses its own AI key, these run on that key instead. Every other task is free, including reading summaries undocsend already made and proposing a room structure itself.

---

Section: AI agents. HTML: https://undocsend.com/docs/agents/what-agents-can-do · Docs index: https://undocsend.com/docs.md
