accept_proposal
ChatGPTApprove a pending drive proposal: apply its file changes onto the drive and remove the proposal. If a proposed file was edited on the drive after the proposal was prepared, this returns needsConfirmation with the edited paths instead of overwriting. Ask the human, then re-run with force: true to overwrite.
add_newer_prepared_draft
ChatGPTWhen this project started from a prepared tender response and a newer approved draft of it is available, add that draft as a second document (documents/<slug>-v<version>/) beside the one being worked on. The existing document is never changed. Fails with not_found when no newer draft is waiting.
answer_join_request
ChatGPTApprove (they join as a member) or decline someone who asked to join the current workspace. A declined person can ask again after 7 days. Get request ids from get_workspace_discovery. Requires an owner or admin role.
archive_thread
ChatGPTArchive a conversation you manage, preserving its messages, or restore it with archived false.
cancel_invitation
ChatGPTCancel a pending invitation to the current workspace, by invitation id (from list_members) or by the invited email. The link stops working. Requires an owner or admin role.
cancel_task
ChatGPTCancel a task and its delegated work. Completed tasks retain their final result.
check_access
ChatGPTCheck whether a person can read, write, or manage the workspace, a project, a thread, or an organization-drive folder or file. Returns allowed plus the proving ACL chain. Use list_access to see everyone. Does not change anyone's rights. Company roles, usersets, and parent relations are inspect-only.
connect_channel
ChatGPTLet the signed-in user talk to Cobl from a chat app such as WhatsApp. When it is already linked, returns their account there and their thread for it in Cobl. Otherwise returns a one-time code and a link that opens the chat with the code ready: hand both to the user, who sends it from their own chat account within 15 minutes to finish linking.
connect_integration
ChatGPTStart connecting a third-party app (Gmail, Slack, Notion, ...) to the signed-in user's account. Returns an authorization URL, or alreadyConnected: true and no URL when the app is already connected. You cannot complete the OAuth consent yourself; hand the URL to the user to open in their browser and approve access.
convert_file
ChatGPTRead a PDF or Office file (DOCX/PPTX/XLSX): the way to get a binary document's contents into context (plain read_file only reads text). Default format: "markdown" returns the text; if you want to keep it, write_file it somewhere (large PDFs are chunked and may be truncated). format: "image" renders the requested page(s) as pictures and shows them to you; use it when the LOOK matters (layout, palette, typography, imagery), e.g. replicating a document's design. Image calls render at most 4 pages; page through with pages. Rendered pages are also saved under .cobl/pages/ so later steps can reuse them.
copy_file
ChatGPTCopy a file or folder, leaving the source intact. Copy selected assets used by a deliverable, source files needed for verbatim assembly, or a chosen template bundle. Browse and search organization material in place with search_drive, list_files and read_file; do not copy a knowledge folder just to inspect or search it. A complete folder copy is appropriate when the user explicitly requests duplication or export.
create_automation
ChatGPTHave Cobl run instructions for the user on its own: on a schedule, whenever another tool calls a webhook, or both. Each run acts as the user and bills the workspace like a chat. With a webhook, the response holds the URL and signing secret (Standard Webhooks) the sending tool needs; outside assistants get the URL and secretLocation, the Cobl page where the person copies the secret. With appEvent, it runs whenever one of the user's connected apps reports that event (find events with list_app_events). Events arrive in the run as untrusted data; such runs keep every tool, but sending anything out (an email, a message, a share link) waits for the user's approval in the run's thread.
create_channel_group
ChatGPTCreate an empty group in the user's own sidebar, when they ask for one. Naming an existing group returns it. File channels into it with set_project_group.
create_folder
ChatGPTCreate a folder (and missing parents) on the unified drive.
create_group
ChatGPTCreate a named group from existing workspace members. Only owners and admins can do this. Members receive access to resources shared with the group. Requires approval.
create_project
ChatGPTCreate a new project (deal room) in the signed-in user's organization and seed its empty documents/ folder, ready for files, or copy a template into it. Returns the new project id; pass it as projectId, spaceId or workspace, whichever the tool asks for. New projects start Restricted (only the creator has access) unless visibility says otherwise, and contain nothing from the organization's shared drive.
create_thread
ChatGPTCreate a private conversation, optionally filed beside documents. Placement does not share the conversation or set its output destination.
delete_automation
ChatGPTDelete one of the user's automations. Threads it already opened stay. Its webhook URL stops working.
delete_channel_group
ChatGPTDelete a group from the user's own sidebar, when they ask. Its channels go back to Channels; nothing else changes.
delete_file
ChatGPTDelete a file/folder (recursive for folders) on the unified drive.
delete_group
ChatGPTDelete a group and its membership and resource grants. Resources and other access remain. Only owners and admins can do this. Requires approval.
delete_project
ChatGPTPermanently delete a project everywhere: its documents, drive index, sandboxes, and share links. This is a hard delete with no undo. Ask the human to explicitly confirm the exact project before calling this, then pass confirm: true.
delete_thread
ChatGPTPermanently delete a conversation you manage and its history. Stop active work first. Archive when history should stay recoverable.
discard_proposal
ChatGPTReject a pending drive proposal: delete it without applying anything. The drive's current files are untouched.
disconnect_channel
ChatGPTDisconnect the signed-in user's chat app (such as WhatsApp) from Cobl. Their thread for it and its history stay in Cobl; messages from that account get a new sign-in link until they reconnect.
disconnect_integration
ChatGPTDisconnect a third-party app from the signed-in user's account, revoking Cobl's access to it. Identify the integration by its toolkit slug (preferred) or by a connected account id. Only the user's own connections can be disconnected, unless team: true: then a workspace owner or admin stops sharing that app with the workspace.
edit_file
ChatGPTReplace an exact unique snippet in a text file on the unified drive.
generate_brand
ChatGPTExtract website identity into design.md and annotated assets. Select organization only for its shared identity; select project for a client or campaign. Returns guide and candidate paths; preserves human corrections. Reuse available identity before extracting again.
get_project
ChatGPTFetch one project's metadata plus a top-level listing of its drive (documents live under documents/, shared brand assets under organization/) so you get oriented in one call. Pass a project id from list_projects as workspace.
get_run_status
ChatGPTRead a document run's durable state and saved progress. Running work belongs to its thread and continues while clients disconnect. Waiting runs need the original sender's answer; interrupted runs need an explicit retry or stop.
get_task
ChatGPTRead a task started by this OAuth application, including its final result or outstanding questions.
get_thread
ChatGPTRead a thread's placement, output destination, audience and your permissions.
get_workspace
ChatGPTThe current workspace (organization): its name, slug, and logo, plus the signed-in user's role in it (owner, admin, or member). Use it to know which workspace you're acting in before listing projects or inviting teammates.
get_workspace_discovery
ChatGPTWhether colleagues with a verified email at the company domain can find and join the current workspace, how new members get approved, and who is waiting for approval. Requires an owner or admin role.
grant_access
ChatGPTGrant reader, writer, or admin access on a project or thread. For threads, use a workspace member or companyId for all current and future members; sharing includes existing history. Organization-drive folders and files accept reader or writer only, and only for active workspace members. Restrict a folder/file with relation restricted (no person): company --restricted--> entry. Workspace members get access at once. Anyone outside the workspace, with or without a Cobl account, gets an emailed project invitation instead (outcome invited) that expires after expiresInDays; inviting the same email again renews it. Guests can view or edit, not manage: admin is for workspace members only. Changing the tier of a guest who already has access applies at once. Nobody outside the workspace can be invited to the Drive. Admin is project or thread manage access. Cannot change workspace roles (use invite_member), can grant to groupId instead of a person (projects, folders and files), cannot mutate company usersets or parent relations, and cannot downgrade an organization member's inherited can edit on an unrestricted entry while the workspace default is members can edit. When team settings set the drive to members can view, members inherit reader and a writer grant gives that member edit on the folder or file and its descendants. On a project shared with the whole team, a workspace member can only be given more than the team default (can edit or can manage over can view, can manage over can edit). Needs approval.
invite_member
ChatGPTInvite someone to join the current workspace by email. Creates a pending invitation, attempts email delivery, and returns the accept link to share when email is unavailable. Requires an owner or admin role.
leave_workspace
ChatGPTLeave the current workspace. The last owner has to make someone else an owner first. After leaving, the person lands in their next workspace, or in onboarding when none is left.
list_access
ChatGPTList who can access the workspace, a project, a thread, or an organization-drive folder or file: your own read/write/manage, direct user grants, inherited or userset access, a stored restricted tuple, and pending invitations. Also the general access level (Restricted, Whole team or Public) with the levels you may pick, and how many distinct people can open it. A group or the whole team is one row, never one row per member. Inspect with this before grant_access, revoke_access or set_general_access. Workspace seats stay read-only here; change those with invite_member.
list_app_events
ChatGPTWhat one of the user's apps (gmail, hubspot, slack, ...) can report to start an automation, with each event's settings and what it carries, and whether the user has connected that app. If not, offer connect_integration first.
list_automations
ChatGPTThe user's automations with their schedule, webhook, whether they are paused, and their last run.
list_channel_groups
ChatGPTList your own sidebar groups, including empty ones. Groups are personal: a teammate's groups never show here.
list_file_versions
ChatGPTList the saved versions of one text file, newest first. Every save is a version, and each says what happened: a person's save, Cobl publishing a conversation's changes, Cobl merging its changes with edits saved at the same time, resolving overlapping edits, or keeping the version a person saved. Restore one with restore_file_version. Images, PDFs and other binary files have no versions.
list_files
ChatGPTList files/folders as an ASCII tree, 2 levels deep by default. Browse organization folders directly with an explicit path such as organization/knowledge; no working copy is needed. Omit path to list the selected output folder, or the three scope folders when no destination is selected. Bare paths use the selected output folder or active project. Raise depth to look deeper. If truncated, list narrower subfolders. A [no access] entry cannot be opened; tell the user instead of reading it or requesting access.
list_groups
ChatGPTList groups in the current workspace, their members, and shared resources visible to the caller. Use group IDs when granting or revoking resource access.
list_integrations
ChatGPTList the third-party apps (Gmail, Zoom, Notion, ...) the signed-in user has connected to Cobl, plus the apps their workspace shares with every member. scope says whose the connection is ("mine" or "team"); when the user has their own connection for an app the workspace also shares, their own is the one used. Use it to check whether a connection succeeded before offering a new connect link.
list_members
ChatGPTWho's in the current workspace: every member with their name, email, and role, plus pending invitations that haven't been accepted yet. Answers "who's on my team?" Use invite_member to add someone.
list_projects
ChatGPTList the projects in the signed-in user's workspace. Each returned id is the project id other tools take: projectId (file tools), spaceId (share_project, and inside target for access tools), { type: "project", id } inside scope or location (thread and proposal tools) or workspace (the rest). Call this first to discover where to work. Returns projects shared with the whole team plus the Restricted ones the user owns or was added to, each with who created it (createdByYou answers "my projects").
list_shares
ChatGPTThe live public share links of a project: id, URL, label, expiry and who created it. The URL is included only when the caller may manage sharing on the project. Use revoke_share to switch a link off.
list_tasks
ChatGPTList this OAuth application's tasks. Follow nextCursor until absent; a page can be empty after access changes.
list_thread_proposals
ChatGPTFind saved draft or conflicting output across a conversation's Drive scopes, optionally filtering by scope. Human reviewers can apply or dismiss these alternatives.
list_thread_runs
ChatGPTRead queued work, current progress and recovery status for a conversation.
list_threads
ChatGPTFind conversations you can read, including shared threads. Follow nextCursor until it is null; a page can be empty while more results remain.
move_file
ChatGPTMove/rename a file or folder. REMOVES the source: across scopes this deletes the original (e.g. moving out of organization/ removes it for everyone). To keep the original, use copy_file instead.
move_thread
ChatGPTFile a thread you manage in a folder, or omit location to unfile it. Its audience and output destination remain independent.
post_thread_message
ChatGPTPost text as the acting person in a conversation they can write. This does not summon Cobl.
read_chat_history
ChatGPTRead a conversation by threadId (from list_threads), or your conversation in a project by workspace, including shared conversations you can access. Tool calls and attachments are omitted.
read_file
ChatGPTRead a text file or inspect an image from the unified drive. This is how you read Markdown, HTML, CSS, JSON, CSV or any text file, including a line range with offset and limit; it is much faster than a shell command. A bare path uses the selected output folder, or the active project when no destination is selected, or your own user/ Drive when there is neither. Images are shown directly. Images embedded inline in a Markdown file are saved to the drive and replaced by their path in what you read; the file itself is unchanged. Other binary documents use convert_file. Large text files are returned in bounded pages; follow nextOffset (and nextLineOffset when present) until no continuation remains. If list_files marked a path [no access], do not read it; tell the user they cannot open it.
read_thread_proposal_file
ChatGPTInspect a file saved by a completed or interrupted invocation before the human decides whether to apply it. Text up to one megabyte is returned with its download URL.
remove_member
ChatGPTRemove a teammate from the current workspace. They lose every project, folder and thread grant in it. Owners and admins may remove members and admins; only an owner may remove an owner, never the last one. To remove yourself, use leave_workspace.
rename_channel_group
ChatGPTRename a group in the user's own sidebar, when they ask. Its channels stay in it. A name another of their groups already has is refused.
rename_project
ChatGPTRename a project's display name (what lists, sidebars, and breadcrumbs show). Display-only: no file, document, or folder inside the project moves or changes. Every rename marks the project as deliberately named, which retires the background naming agent for that project.
rename_thread
ChatGPTRename a conversation you manage.
respond_to_task
ChatGPTAnswer outstanding task questions or approvals using the exact input request identifiers from get_task. Approval requires the human's explicit decision.
restore_file_version
ChatGPTBring back an earlier version of one text file, found with list_file_versions. The current content becomes a version too, so a restore can itself be undone.
retry_thread_run
ChatGPTExplicitly retry work you invoked after it failed or was interrupted. The earlier partial output stays in history.
revoke_access
ChatGPTRemove a direct user grant or cancel a pending invitation on a project, thread, or an organization-drive folder or file. Pass relation restricted (no person) to restore inheritance from the parent on that folder or file. Drive invitations are legacy and can only be cancelled. Cannot remove the project or thread owner, cannot change workspace roles, and cannot strip an organization member's inherited can edit on an unrestricted entry while the workspace default is members can edit. When the default is members can view, revoking a member's writer grant returns them to view. On a project shared with the whole team, removing a member's own grant returns them to the team default. Needs approval.
revoke_share
ChatGPTSwitch a public share link off: the URL stops resolving for everyone who has it. Get the id from list_shares. Requires manage access on the project.
run_automation
ChatGPTStart one of the user's automations now, outside its schedule. Pass event to test a webhook automation by hand: the run behaves exactly as if its webhook had received that event. Returns the thread it runs in.
search_history
ChatGPTSearch your past conversations by meaning and keyword (hybrid retrieval). Use it to recall earlier decisions, facts, or work that has scrolled out of context. Returns matching messages with their thread and date.
set_general_access
ChatGPTChoose who in the workspace can open a project, a thread, or an organization-drive folder or file: restricted (only the people and groups added) or workspace (everyone in the workspace, at can view or can edit; a thread can also give can manage). People already added keep their access either way. Anyone who can manage a thread can change its audience, which stops its running replies; a person's chat line thread stays private. On a project, both levels also turn off a public link if one is on; turn Public on with share_project. Only the project owner can change a project's team setting; someone who can manage the project can still pick the current level just to turn the public link off. Folders and files need a workspace owner or admin, and Cobl files like COMPANY.md always stay shared with the workspace. Use grant_access and revoke_access for individual people and groups. Needs approval.
set_member_role
ChatGPTChange a workspace member's role: member, admin, or owner. Owners and admins may set member or admin; only an owner may give or take the owner role, and the workspace always keeps at least one owner. You may reduce your own role while at least one owner remains. You cannot promote yourself.
set_project_group
ChatGPTSet a channel's group in the user's own sidebar; teammates' sidebars do not change. Set one yourself when the channel has no group yet and you know what the work is about: reuse one of the user's groups when it fits (see list_channel_groups), otherwise name a new one in 1 to 3 words. Never call this for a channel that already has a group unless the user explicitly asks to move it: they made it in that group or moved it there. "Channels" takes it out of every group.
set_project_icon
ChatGPTChoose a channel's icon, the one its sidebar row and top bar show for everyone, from a fixed set of business icons; null goes back to its default. Call it when the user asks for another icon, or to give a client's channel one that fits its industry; it changes no file.
set_project_opening
ChatGPTChoose what clicking a channel opens, for everyone who opens it: chat (its chat alone), chat-and-overview (the chat with the channel's dashboard beside it) or overview (the dashboard alone, the chat collapsed). Call it when the user asks how a channel should open; it changes no file.
set_project_sector
ChatGPTSet the sector THIS project belongs to, which picks the illustration shown wherever the project is previewed (lists, dashboard, and the image people see when the link is shared). With onlyIfMissing, a sector already chosen is kept.
set_project_work_kind
ChatGPTLabel what kind of work a project is: rfp when the user responds to, qualifies or evaluates a formal tender (RFP, RFI, RFQ, ITT, appel d'offres, marché public: someone else wrote the rules), classic for a proposal, deck, one-pager or quote pitched on the user's own initiative, unknown when the evidence supports neither. A background pass labels most projects on its own; call this when the user tells you what the project is, or corrects the label. It changes analytics only, never the documents.
set_thread_destination
ChatGPTChoose where future work in a conversation writes its output, or omit destination to clear it. Each run must separately have write access.
set_workspace_agent_approvals
ChatGPTMake the agent always ask before deleting in connected apps, or before sending outside the company, for everyone in the current workspace; no personal setting can skip it. Calls are matched by tool name, so differently named actions can be missed, and Slack and Teams messages do not count as sending outside. Leave out a field to keep its value. An AI tool can turn these on but not off: an admin turns them off in Cobl. Read the current values with get_workspace. Requires an owner or admin role.
set_workspace_all_apps_access
ChatGPTBlock or allow every app Cobl offers, for everyone in the current workspace, in one step. A blocked app stays connected but cannot be used or connected until it is allowed again. Apps Cobl adds later are not covered: use set_workspace_new_app_blocking for those. Read the current list with get_workspace. Requires an owner or admin role.
set_workspace_app_access
ChatGPTAllow or block one connected app (Gmail, HubSpot, Notion...) for everyone in the current workspace. A blocked app stays connected but cannot be used or connected by anyone here, in chat, automations or AI tools, until it is allowed again; nobody has to reconnect. While blockNewApps is on, only apps Cobl offers can be allowed. Read the current list with get_workspace. Requires an owner or admin role.
set_workspace_app_account
ChatGPTChoose which kind of connection everyone in the current workspace may use for one app. workspace: only the account the workspace shares, even for people who connected their own. personal: only each person's own account, and the app cannot be shared. personal_or_shared: either, and a person's own account wins (the default). Connections are kept and work again if the rule changes back. This only sets the rule: connecting and sharing stay on Connections. An AI tool can set a rule on an app that has none but cannot change one: an admin changes it in Cobl. Read the current rules with get_workspace. Requires an owner or admin role.
set_workspace_discovery
ChatGPTOpen the current workspace to colleagues with a verified email at your own company domain, or close it. The domain is always the acting admin's own email domain. Requires an owner or admin role.
set_workspace_drive_access
ChatGPTWhat members may do on the organization drive by default: edit (every member can write anywhere not restricted) or view (members read; owners, admins and people with a grant write). Owners and admins keep writing either way. Read the current value with get_workspace. Requires an owner or admin role.
set_workspace_new_app_blocking
ChatGPTTurn on or off "Block new apps until an admin allows them" for the current workspace. On: apps in use today keep their setting, apps Cobl adds later start off, and apps Cobl does not offer stop working. Off: every app not blocked works again. Read the current value with get_workspace. Requires an owner or admin role.
set_workspace_privacy_mode
ChatGPTChoose worldwide, EU-only, or US-only model inference with zero data retention when the AI Gateway supports it. Read the current value with get_workspace. Requires an owner or admin role.
set_workspace_project_sharing
ChatGPTChoose whether project Team access shares with the whole workspace or the current project owner's groups. Group membership and ownership changes update access immediately. Drive sharing is unchanged. Read the current value with get_workspace. Requires an owner or admin.
share_integration
ChatGPTConnect a company app (CRM, project board, knowledge base, analytics...) once for the whole workspace, so every member's assistant can use it without connecting it themselves. Only workspace owners and admins can share, and only company apps: mail, calendars, chat, files and social logins act as one person and stay personal. Every member will act as the account that signs in, so a dedicated integration account works best. Returns a sign-in URL for the admin to open, or alreadyShared: true and no URL.
share_project
ChatGPTCreate a public, view-only share link for a project so an external person can view its documents in the browser without a Cobl account. Builds a fresh snapshot, so the link shows the latest documents. Returns the share URL.
start_document_run
ChatGPTDelegate a whole document (proposal, RFP, market study…) to Cobl's document agent. Starts an agent run in the project and returns a run handle within ~2 seconds while the agent keeps working server-side (runs typically take 1-10 minutes). Read get_run_status with the returned runId every 20-30 seconds and relay progress to the user. The produced files land in the project drive: read them with list_files/read_file, then share_project as needed; for a Word, PDF or PowerPoint copy, start a run whose brief asks for it (the agent saves it in exports/). The run bills like an in-app chat turn. It posts the brief in your conversation for that project (created if needed), so the agent sees its earlier messages; runs there queue one after another. For small edits to an existing file, use edit_file/write_file directly instead.
start_thread_run
ChatGPTQueue Cobl for a message you posted. Set allowSteering when this run may accept your later text guidance at the next model step. steeringForRunId offers this message to your own eligible active run; attachments and stale targets stay queued normally.
stop_thread_run
ChatGPTStop work you invoked, or stop a participant's work in a conversation you manage.
transfer_project_ownership
ChatGPTMake another workspace member the owner of a project. Only the current owner can do it, and the new owner must be a member of the project's workspace (never a guest). The previous owner keeps can manage. The owner alone decides whether the whole team has access, so this hands that choice over. Needs approval.
update_automation
ChatGPTChange, pause or resume one of the user's automations. Only the fields you pass change. schedule null removes the schedule. webhook add, rotate (new secret; update the sender) or remove. appEvent replaces the app event; null removes it.
update_group
ChatGPTRename a group and replace its member list. Read list_groups first and preserve members not being changed. Added members gain group access; removed members lose only group-derived access. Only owners and admins can do this. Requires approval.
update_invitation_expiry
ChatGPTGive a pending project invitation a new expiry, counted from now: 7, 30 or 90 days. This also revives an invitation whose link already expired; it does not send a new email (use grant_access with the same email to renew and resend). Get the invitationId from list_access. Cancelled or accepted invitations cannot be changed. Needs someone who can manage sharing on the project. Needs approval.
view_document
ChatGPTShow a project document to the user, rendered inline. A markdown document returns its text plus a safe HTML rendering. A designed document (an html folder with index.html) is rendered from its Vite-built HTML plus a public snapshot URL. Viewing a designed document publishes the project and reuses or creates its public share link as a side effect, so it additionally requires the share:write scope (markdown does not).
whoami
ChatGPTThe acting user's name and email, the workspace this session operates in (with the user's role), and the scopes this token holds. Call it first to orient yourself: it tells you who you're acting for and what you're allowed to do.
write_file
ChatGPTCreate/overwrite a text file in the selected output folder. Use this tool to author Markdown, HTML and any other text file, rather than a shell heredoc. Explicit scope paths and projectId address other files the user is authorized to edit. Before reusing content from another scope, use copy_file to copy locally referenced assets into the document's destination scope and wait for those copies to succeed. References must be relative to the saved document and resolve within its scope. Markdown files display images with standard image tags whose path is relative to the file: from documents/proposal.md,  shows documents/assets/team.jpg, and  shows an uploaded file. Reference existing drive images this way; never invent an image path or URL.