Oo Feishu

Feishu

Operate Feishu through your OOMOL-connected account. This skill calls the feishu connector with the oo CLI; OOMOL injects credentials server-side, so you never handle raw tokens.

Running an action

Assume the user has already installed the oo CLI, signed in, and connected Feishu. Do not run oo auth login or open the connection URL proactively — just run the action. Fall back to First-time setup only when a command actually fails with an auth or connection error.

1. Inspect the contract to get the authoritative input/output schema before building a payload:

oo connector schema "feishu" --action "<action_name>"

2. Run the action with a JSON payload that matches the input schema:

oo connector run "feishu" --action "<action_name>" --data '<json>' --json

• --data takes a JSON object string or @path/to/file.json; omit it to send {}.
• The response is { "data": ..., "meta": { "executionId": "..." } }; the execution id lives under meta.executionId.

Each action is listed below with a one-line description; actions that change state carry a [write] or [destructive] tag. Before constructing --data, fetch the action's live schema with oo connector schema to get its authoritative input fields.

Available actions

• add_approval_cc — Add CC recipients to an active approval instance. [write]
• add_chat_members — Add users or bots to a Feishu chat. [write]
• add_drive_permission — Grant a collaborator permission on a Feishu Drive resource. [write]
• add_sign_approval_task — Add users before, after, or alongside the current approval task. [write]
• add_task_comment — Add a text comment to a Feishu task. [write]
• add_task_to_tasklist — Add a Feishu task to a tasklist. [write]
• add_wiki_member — Add a member to a Feishu Wiki space. [write]
• apply_drive_permission — Apply to a Feishu document owner for view or edit permission on behalf of the current user. [write]
• apply_minutes_permission — Apply for view or edit permission on one Feishu Minutes record. [write]
• approve_approval_task — Approve a pending approval task with optional form controls. [write]
• arrange_base_dashboard — Ask Feishu to automatically arrange dashboard blocks. [write]
• batch_create_base_records — Create up to 200 records in one Feishu Base request. [write]
• batch_create_okrs — Create objectives and their key results sequentially, with optional rollback on failure. [write]
• batch_delete_base_records — Delete up to 200 records in one Feishu Base request. [destructive]
• batch_get_messages — Fetch up to 50 Feishu messages by message ID in one request.
• batch_update_base_records — Update up to 200 records with record-specific fields in one Feishu Base request. [write]
• batch_update_sheet — Execute multiple Sheet AI write tools in one batch request. [write]
• cancel_approval_instance — Recall an approval instance initiated by the connected user. [write]
• cancel_message_flag — Cancel a targeted message flag or best-effort cancel both message and feed layers. [write]
• cancel_scheduled_send — Cancel a Feishu mail message before its scheduled delivery time. [write]
• clear_cells — Clear cell contents, formats, or both from an A1 range. [destructive]
• complete_task — Mark a Feishu task as completed. [write]
• copy_base — Copy a Feishu Base, optionally changing its name, destination folder, content inclusion, or time zone. [write]
• copy_drive_file — Copy a Feishu Drive file or online document into another folder. [write]
• copy_sheet_range — Copy a cell range. [write]
• copy_wiki_node — Copy a Feishu Wiki node into another space or below another parent. [write]
• create_app_slash_command — Register a slash command, optionally updating the existing command when its name already exists. [write]
• create_approval_instance — Create an approval instance from structured form controls. [write]
• create_base — Create a Feishu Base, optionally replacing its default table with a custom initial schema. [write]
• create_base_block — Create a folder, table, document, dashboard, or workflow block. [write]
• create_base_dashboard — Create a dashboard in a Base. [write]
• create_base_dashboard_block — Create a chart, metric, or text block in a Base dashboard. [write]
• create_base_field — Create one field in a Feishu Base table. [write]
• create_base_form — Create a form in a Base table. [write]
• create_base_form_questions — Create up to ten questions in a Base form. [write]
• create_base_record — Create one record in a Feishu Base table. [write]
• create_base_record_share_links — Generate share links for up to 100 Base records. [write]
• create_base_role — Create a custom Base role from a complete permission configuration. [write]
• create_base_table — Create a table with an optional initial field schema in a Feishu Base. [write]
• create_base_views — Create one or more views sequentially in a Feishu Base table. [write]
• create_base_workflow — Create a disabled Base workflow from a complete definition. [write]
• create_calendar_event — Create a Feishu calendar event and add attendees, rolling back the event if attendee creation fails. [write]
• create_chat — Create a Feishu group or topic chat with initial users and bots. [write]
• create_document — Create a Feishu document from Docx XML or Markdown content, optionally inside a folder or Wiki node. [write]
• create_drive_comment — Create a full-resource or anchored rich-text comment on a Feishu Drive document or supported file. [write]
• create_drive_comment_reply — Add a rich-text reply to a Feishu Drive comment. [write]
• create_drive_folder — Create a folder in Feishu Drive. [write]
• create_drive_shortcut — Create a Feishu Drive shortcut to an existing file in another folder. [write]
• create_feed_shortcuts — Add up to 10 chats to the authorized user's feed shortcuts at the head or tail. [write]
• create_mail_draft — Compose and save a new Feishu mail draft without sending it. [write]
• create_mail_template — Create a personal Feishu mail template from JSON content and existing Drive-backed attachments. [write]
• create_markdown_file — Create a Markdown file from a JSON string in Feishu Drive root, a Drive folder, or a Wiki node. [write]
• create_message_flag — Bookmark a message in the message or feed layer, automatically detecting thread type when needed. [write]
• create_okr — Create one Feishu objective or key result from plain text. [write]
• create_okr_alignment — Align one Feishu OKR objective to another objective. [write]
• create_okr_progress — Create a progress record for an objective or key result. [write]
• create_sheet — Create an empty sub-sheet with optional position and dimensions. [write]
• create_sheet_chart — Create a chart object. [write]
• create_sheet_conditional_format — Create a conditional format object. [write]
• create_sheet_filter — Create a filter object. [write]
• create_sheet_filter_view — Create a filter view object. [write]
• create_sheet_float_image — Create a float image object. [write]
• create_sheet_pivot_table — Create a pivot table object. [write]
• create_sheet_sparkline — Create a sparkline object. [write]
• create_slide — Create a page in an existing Feishu Slides presentation. [write]
• create_slides_presentation — Create a Feishu Slides presentation and optionally add up to ten initial pages. [write]
• create_task — Create a Feishu task with members, dates, reminders, and tasklist membership. [write]
• create_tasklist — Create a Feishu tasklist. [write]
• create_whiteboard_diagram — Create a Mermaid, PlantUML, or SVG diagram node in a Feishu whiteboard. [write]
• create_whiteboard_nodes — Create raw OpenAPI nodes in a Feishu whiteboard, optionally replacing all existing content. [write]
• create_wiki_node — Create a document node in a Feishu Wiki space. [write]
• create_wiki_space — Create a Feishu Wiki space. [write]
• create_workbook — Create a Feishu spreadsheet workbook. [write]
• decline_mail_read_receipt — Dismiss a message's read-receipt request without sending mail, safely doing nothing when already cleared. [write]
• delete_app_slash_command — Permanently delete a slash command selected by command ID or exact command name. [destructive]
• delete_base_block — Delete a Base resource block. [destructive]
• delete_base_dashboard — Delete a Base dashboard and its blocks. [destructive]
• delete_base_dashboard_block — Delete a block from a Base dashboard. [destructive]
• delete_base_field — Delete one field from a Feishu Base table. [destructive]
• delete_base_form — Delete a form from a Base table. [destructive]
• delete_base_form_questions — Delete up to ten questions from a Base form. [destructive]
• delete_base_record — Delete one record from a Feishu Base table. [destructive]
• delete_base_role — Delete a custom Base role; system roles cannot be deleted. [destructive]
• delete_base_table — Delete a table from a Feishu Base. [destructive]
• delete_base_view — Delete one view from a Feishu Base table by ID or accepted view name. [destructive]
• delete_calendar_event — Delete a Feishu calendar event. [destructive]
• delete_document_cover — Idempotently clear the cover of a Feishu docx document. [destructive]
• delete_drive_comment — Delete a Feishu Drive comment. [destructive]
• delete_drive_comment_reply — Delete a reply from a Feishu Drive comment. [destructive]
• delete_drive_item — Delete a Feishu Drive file or folder and return a task ID when Feishu processes the deletion asynchronously. [destructive]
• delete_drive_version — Permanently delete a specific historical version of a Feishu Drive file. [destructive]
• delete_mail_draft — Delete a Feishu mail draft. [destructive]
• delete_okr_alignment — Delete a Feishu OKR objective alignment. [destructive]
• delete_okr_progress — Delete a Feishu OKR progress record. [destructive]
• delete_sheet — Delete one sub-sheet from a workbook. [destructive]
• delete_sheet_chart — Delete a chart object. [destructive]
• delete_sheet_conditional_format — Delete a conditional format object. [destructive]
• delete_sheet_dimension — Delete rows or columns in a sub-sheet. [destructive]
• delete_sheet_dropdowns — Remove dropdown validation from multiple sheet-prefixed ranges. [destructive]
• delete_sheet_filter — Delete a filter object. [destructive]
• delete_sheet_filter_view — Delete a filter view object. [destructive]
• delete_sheet_float_image — Delete a float image object. [destructive]
• delete_sheet_pivot_table — Delete a pivot table object. [destructive]
• delete_sheet_sparkline — Delete a sparkline object. [destructive]
• delete_slide — Delete a page from a Feishu Slides presentation. [destructive]
• delete_wiki_node — Delete a Feishu Wiki node and optionally its descendants. [destructive]
• delete_wiki_space — Delete a Feishu Wiki space and return either synchronous completion or an asynchronous task ID. [destructive]
• diff_markdown_file — Compute a unified line diff between Drive versions or between a Drive version and a JSON Markdown string.
• disable_base_advanced_permissions — Disable advanced permissions for a Base. [write]
• disable_base_workflow — Disable a Base workflow without changing its steps. [write]
• download_base_attachments — Read Base attachment metadata and download selected or all record attachments into connector transit storage.
• download_docs_media — Download Feishu document media or a whiteboard image into connector transit storage.
• download_document_cover — Read a Feishu docx document cover and download its image into connector transit storage.
• download_drive_cover — Download a stable Drive cover preset into connector transit storage.
• download_drive_export — Download a generated Drive export file into connector transit storage.
• download_drive_file — Download a Feishu Drive file into connector transit storage.
• download_drive_preview — Resolve a requested Drive preview type and download the ready artifact into connector transit storage.
• download_message_resource — Download one image or file resource attached to a Feishu message into connector transit storage.
• download_minutes_media — Resolve and stream a Feishu Minutes audio or video recording into connector transit storage.
• download_vc_note_transcript — Fetch every page of a unified meeting-note transcript and upload the complete text to connector transit storage.
• enable_base_advanced_permissions — Enable advanced permissions for a Base. [write]
• enable_base_workflow — Enable a Base workflow without changing its steps. [write]
• export_whiteboard_svg — Export a Feishu whiteboard as SVG and return the API's Base64 payload without writing a local file.
• fetch_document — Fetch a Feishu document as Docx XML or Markdown, with optional structural detail and partial-read selection.
• fetch_markdown_file — Fetch the latest or a specific version of a Markdown file from Feishu Drive.
• fill_sheet_range — Fill a destination range from a source pattern. [write]
• find_calendar_rooms — Find meeting rooms available for the specified event time slots.
• forward_mail — Forward a Feishu mail message to new recipients. [write]
• freeze_sheet_dimension — Freeze or unfreeze the leading rows or columns. [write]
• get_approval — Get an approval definition, form snapshot, and approval nodes.
• get_approval_instance — Get an approval instance with its nodes, tasks, form, and history.
• get_base — Get the metadata of a Feishu Base.
• get_base_dashboard — Get a Base dashboard.
• get_base_dashboard_block — Get a Base dashboard block and its data configuration. [write]
• get_base_dashboard_block_data — Get the computed chart data for a Base dashboard block. [write]
• get_base_field — Get one field from a Feishu Base table.
• get_base_form — Get a form configured for a Base table.
• get_base_form_detail — Get public form questions and submission metadata by share token.
• get_base_record — Get one record from a Feishu Base table.
• get_base_role — Get a Base role and its complete permission configuration.
• get_base_table — Get one table in a Feishu Base.
• get_base_view — Get one view from a Feishu Base table.
• get_base_view_card — Get the card configuration of a Base view.
• get_base_view_filter — Get the filter configuration of a Base view.
• get_base_view_group — Get the grouping configuration of a Base view.
• get_base_view_sort — Get the sorting configuration of a Base view.
• get_base_view_timebar — Get the timeline configuration of a Base view.
• get_base_view_visible_fields — Get the visible field IDs of a Base view.
• get_base_workflow — Get a Base workflow including its steps.
• get_calendar_event — Get the complete details of one Feishu calendar event.
• get_calendar_meeting_info — Get video meeting and meeting-note relations for calendar event instances.
• get_cells — Read one or more A1 ranges with values, formulas, and optional styles.
• get_chat — Get the metadata of one Feishu chat visible to the authorized user.
• get_current_user — Get the profile of the Feishu user who authorized this connection, using their user_access_token.
• get_document — Get a Feishu docx document's basic metadata (title and revision) that the authorized user can read.
• get_document_content — Read the full plain-text content of a Feishu docx document the authorized user can access.
• get_document_revert_status — Get the status of a Feishu document history revert task.
• get_drive_export — Get the normalized status and generated file token of a Drive export task.
• get_drive_import — Get the normalized status and created document token of a Drive import task. [write]
• get_drive_task_status — Get the current state of an asynchronous Drive move, copy, or delete task.
• get_drive_version — Download one specific Feishu Drive file version into connector transit storage.
• get_mail_message — Read one Feishu mail message with body and attachment metadata.
• get_mail_recall_detail — Get asynchronous recall progress and per-recipient results for one Feishu mail message.
• get_mail_send_status — Get the latest per-recipient delivery status for one sent Feishu mail message. [write]
• get_mail_signature_detail — Fetch one complete mail signature and annotate whether it is the send or reply default.
• get_mail_thread — Read every message in a Feishu mail thread in chronological order.
• get_minutes_detail — Get the basic metadata of one Feishu Minutes record.
• get_minutes_download_metadata — Get the temporary media download URL for a Feishu Minutes record without downloading it.
• get_minutes_summary — Get the generated summary of a Feishu Minutes record.
• get_minutes_todos — List the generated todos of a Feishu Minutes record.
• get_minutes_transcript — Get the generated transcript text of a Feishu Minutes record.
• get_okr_cycle_detail — List every objective in an OKR cycle and fetch the key results below each objective.
• get_okr_progress — Get one Feishu OKR progress record.
• get_related_tasks — List tasks related to the authorized Feishu user, with optional bounded auto-pagination.
• get_sheet — Get one sub-sheet from a workbook structure.
• get_sheet_changeset — Get the raw spreadsheet edit actions between two revisions for reviewing applied changes.
• get_sheet_dropdown — Read dropdown validation metadata for a range.
• get_sheet_history_revert_status — Poll the status of a spreadsheet history revert.
• get_slide — Get one Feishu Slides page as SML 2.0 XML by stable ID or page number.
• get_slides_presentation — Get the complete SML 2.0 XML of a Feishu Slides presentation.
• get_slides_revert_status — Get the status of a Slides history revert task.
• get_slides_screenshots — Render up to ten existing Slides pages and store the decoded screenshots in connector transit storage.
• get_task — Get one Feishu task by GUID.
• get_typed_table — Read a sub-sheet range into a DataFrame-friendly typed table with inferred dtypes.
• get_user — Get a Feishu user profile. User identity may omit userId to return the authenticated user.
• get_vc_meeting — Get Feishu video meeting metadata and participant data.
• get_vc_meeting_note — Resolve a video meeting to its note ID and return normalized meeting-note details.
• get_vc_note — Get meeting-note metadata and its related document tokens.
• get_vc_recording_metadata — Get recording URL and duration metadata for a Feishu video meeting.
• get_wiki_node — Resolve and get a Feishu Wiki node by token and object type.
• get_wiki_space — Get one Feishu Wiki space by ID.
• get_wiki_task — Get a normalized Wiki asynchronous task status.
• get_workbook — Get workbook structure and metadata, including all sub-sheets.
• group_sheet_dimension — Group rows or columns in a sub-sheet. [write]
• hide_sheet_dimension — Hide rows or columns in a sub-sheet. [write]
• insert_docs_media — Append an image or file to a Feishu docx document by creating a block, uploading media, and binding the file token with rollback on failure. [write]
• insert_sheet_dimension — Insert blank rows or columns into a sub-sheet. [write]
• inspect_drive_item — Inspect a Feishu Drive token to resolve its canonical type, title, URL, and underlying document for Wiki nodes.
• join_vc_meeting — Join a Feishu video meeting with the app's meeting bot. [write]
• leave_vc_meeting — Leave a Feishu video meeting previously joined by the app's meeting bot. [write]
• list_active_vc_meetings — List active Feishu video meetings for the current user or a tenant user.
• list_app_slash_commands — List every slash command registered on the currently connected Feishu app.
• list_approval_tasks — List approval tasks grouped by pending, completed, initiated, or CC status.
• list_base_blocks — List folders, tables, documents, dashboards, and workflows in a Base.
• list_base_dashboard_blocks — List blocks in a Base dashboard.
• list_base_dashboards — List dashboards in a Base.
• list_base_fields — List the fields in a Feishu Base table.
• list_base_form_questions — List questions configured for a Base form.
• list_base_forms — List forms configured for a Base table.
• list_base_record_history — List the change history for one Base record.
• list_base_records — List records in a Feishu Base table with optional projection, filter, and sort.
• list_base_roles — List roles configured for Base advanced permissions.
• list_base_tables — List tables in a Feishu Base.
• list_base_views — List the views in a Feishu Base table.
• list_base_workflows — List and optionally filter workflows in a Base.
• list_bitable_fields — List the fields (columns) of a Feishu Bitable table, to understand its schema before reading rows.
• list_bitable_tables — List the data tables in a Feishu Bitable (multi-dimensional spreadsheet) the authorized user can access.
• list_calendar_agenda — List event instances in a Feishu calendar over a bounded time range.
• list_chat_members — List members of one Feishu chat visible to the authorized user.
• list_chats — List Feishu chats visible to the authorized user.
• list_department_users — List users in a Feishu department visible to the app.
• list_departments — List child departments below a Feishu department visible to the app.
• list_document_blocks — List a Feishu docx document's structured blocks (one page), for reading document structure and rich content.
• list_document_history — List historical versions of a Feishu docx document.
• list_drive_comments — List comments on a Feishu Drive document or supported file.
• list_drive_files — List files, folders, and online documents inside a Feishu Drive folder.
• list_drive_permissions — List collaborators and permission roles on a Feishu Drive resource.
• list_drive_previews — List available preview artifacts and generation states for a Feishu Drive file.
• list_drive_secure_labels — List secure labels available to the current Feishu user.
• list_drive_versions — List one page of tagged version history for a Feishu Drive file.
• list_feed_group_items — List active and deleted feed cards in one group, optionally resolving each chat.
• list_feed_groups — List user feed groups, preserving both active and soft-deleted groups across auto-pagination.
• list_feed_shortcuts — List one version-locked page of user feed shortcuts and optionally attach complete chat details.
• list_initiated_approval_instances — List approval instances initiated by the connected user.
• list_mail_messages — List message IDs in a Feishu mailbox folder or label.
• list_mail_signatures — List the authorized user's Feishu mail signatures and default usages.
• list_message_flags — List active and canceled user message flags, optionally auto-paginating and enriching feed flags with messages.
• list_messages — List messages from one Feishu chat or thread with user-identity history permissions.
• list_okr_alignments — List the objectives aligned from or to a Feishu OKR objective.
• list_okr_categories — List enabled and disabled Feishu OKR categories configured by the tenant.
• list_okr_cycles — List Feishu OKR cycles visible to a user.
• list_okr_progress — List progress records for an objective or key result.
• list_sheet_charts — List charts on a sub-sheet.
• list_sheet_conditional_formats — List conditional formats on a sub-sheet.
• list_sheet_filter_views — List filter views on a sub-sheet.
• list_sheet_filters — List filters on a sub-sheet.
• list_sheet_float_images — List float images on a sub-sheet.
• list_sheet_history — List spreadsheet edit history versions.
• list_sheet_pivot_tables — List pivot tables on a sub-sheet.
• list_sheet_sparklines — List sparklines on a sub-sheet.
• list_slides_history — List historical versions of a Feishu Slides presentation.
• list_tasks — List Feishu tasks related to the caller with server-side status filters.
• list_thread_messages — List messages inside a Feishu message thread.
• list_vc_meeting_events — List participant and lifecycle events from one Feishu video meeting.
• list_whiteboard_nodes — List the raw nodes in a Feishu whiteboard, including Mermaid or PlantUML source metadata.
• list_wiki_members — List members of a Feishu Wiki space.
• list_wiki_nodes — List nodes in a Feishu Wiki space or below one parent node.
• list_wiki_spaces — List Feishu Wiki spaces accessible to the caller.
• manage_minutes_todos — Add, update, or delete multiple todo items in one Feishu Minutes record. [write]
• manage_task_assignees — Add or remove assignees on a Feishu task. [write]
• manage_task_followers — Add or remove followers on a Feishu task. [write]
• manage_task_reminders — List, add, or remove reminders on a Feishu task. [write]
• manage_tasklist_members — Add or remove members on a Feishu tasklist. [write]
• merge_sheet_range — Merge cells in a range. [write]
• modify_mail_messages — Add or remove labels and move Feishu mail messages in batches of 20. [write]
• move_base_block — Move and order a Base resource block. [write]
• move_drive_item — Move a Feishu Drive file or folder and return a task ID when Feishu processes the move asynchronously. [write]
• move_sheet_dimension — Move a contiguous row or column range to a new position. [write]
• move_sheet_range — Move a cell range. [write]
• move_wiki_node — Move a Feishu Wiki node to another space or parent node. [write]
• overwrite_markdown_file — Overwrite an existing Feishu Drive Markdown file with a complete JSON Markdown string. [write]
• patch_markdown_file — Fetch a Markdown file, replace literal text or a JavaScript regular expression locally, and overwrite only when matches exist. [write]
• patch_okr — Update content, notes, score, or deadline on an objective or key result. [write]
• preview_docs_media — Download the source-file preview of Feishu document media into connector transit storage.
• put_typed_table — Write a DataFrame-friendly typed table while preserving numbers, booleans, and real dates. [write]
• query_base_data — Run the Base data-query DSL for server-side grouping, aggregation, filtering, sorting, and Top N analysis.
• query_calendar_freebusy — Query a Feishu user's free/busy periods and RSVP status.
• query_feed_group_items — Look up specific chat feed cards in one group and optionally attach complete chat details.
• query_my_attendance_tasks — Query the current authorized user's attendance tasks and clock-in records for a work-date range.
• recall_sent_mail — Request asynchronous recall of one delivered Feishu mail message within its recall window. [write]
• reject_approval_task — Reject a pending approval task. [write]
• remind_approval_tasks — Send reminders for one or more tasks in an approval instance. [write]
• remove_base_attachments — Validate a Base attachment field and remove selected file tokens from one record cell. [destructive]
• remove_chat_members — Remove users or bots from a Feishu chat. [destructive]
• remove_drive_permission — Remove a collaborator permission from a Feishu Drive resource. [destructive]
• remove_feed_shortcuts — Remove up to 10 chats from the authorized user's feed shortcuts. [destructive]
• remove_wiki_member — Remove a member from a Feishu Wiki space. [destructive]
• rename_base_block — Rename a Base resource block. [write]
• rename_base_view — Rename a Base view. [write]
• render_slide_screenshot — Render one SML 2.0 slide XML fragment and store the decoded screenshot in connector transit storage.
• reopen_task — Reopen a completed Feishu task. [write]
• reorder_okrs — Replace the objective or key-result order with an explicit ID sequence. [write]
• replace_cells — Find and replace matching text in a sub-sheet. [write]
• replace_minutes_speaker — Replace a transcript speaker with another Feishu user in one Minutes record. [write]
• replace_minutes_summary — Replace the AI-generated summary of one Feishu Minutes record. [write]
• replace_minutes_words — Batch-replace words in the transcript of one Feishu Minutes record. [write]
• replace_slide_elements — Replace or insert structural elements on one Slides page, with SML boilerplate added for common shape replacements. [write]
• replace_slides — Replace multiple Slides pages by creating each replacement before its old page and then deleting the old page. [write]
• reply_all_mail — Reply to all participants of a Feishu mail message. [write]
• reply_calendar_event — Accept, decline, or tentatively accept a Feishu calendar event invitation. [write]
• reply_mail — Reply to a Feishu mail message, preserving conversation headers. [write]
• reply_message — Reply to a Feishu message as the authorized user, optionally inside the message thread. [write]
• resize_sheet_range — Resize rows or columns using pixels, standard size, or row auto-fit. [write]
• revert_document — Revert a Feishu docx document to a historical version and return the background task state. [write]
• revert_drive_version — Revert a Feishu Drive file to a specific historical version. [write]
• revert_sheet_history — Start an asynchronous revert to a spreadsheet history version. [write]
• revert_slides_history — Revert a Feishu Slides presentation to a historical version and return its task metadata. [write]
• rollback_approval_task — Roll back an approval task to one or more earlier nodes. [destructive]
• search_approvals — Search approval definitions the connected user can initiate.
• search_base_field_options — Search the options of a single-select or multi-select field in a Feishu Base.
• search_base_records — Search records by keyword within selected fields of a Feishu Base table.
• search_bitable_records — Read rows (records) from a Feishu Bitable table, with optional field selection, filter, and sort.
• search_calendar_events — Search Feishu calendar events by text, time range, and attendee identifiers.
• search_cells — Find cell coordinates matching text or a regular expression.
• search_chats — Search Feishu chats visible to the authorized user by name.
• search_documents — Search Feishu documents, Wiki nodes, spreadsheets, Base apps, files, folders, and slides.
• search_drive_items — Search Feishu Drive documents, Wiki nodes, spreadsheets, Base apps, files, folders, and slides.
• search_mail_messages — Search Feishu mail by text, addresses, subject, state, and creation time.
• search_messages — Search messages across Feishu chats with keyword, sender, chat, mention, attachment, and time filters.
• search_minutes — Search Feishu Minutes by text, owners, participants, and creation time.
• search_tasklists — Search Feishu tasklists by name and ownership.
• search_tasks — Search Feishu tasks by text, members, completion state, and due range.
• search_users — Search Feishu users by keyword, open_id list, or relationship filters using user identity.
• search_vc_meetings — Search Feishu video meetings by text, people, rooms, and time range.
• send_mail — Compose a new email, create a Feishu draft, and send it immediately. [write]
• send_mail_draft — Send an existing Feishu mail draft immediately or at a scheduled time. [write]
• send_mail_read_receipt — Send a system-generated RFC 3798-style read receipt for a message that requested one. [write]
• send_rich_message — Send text, Markdown, image, file, audio, video, or raw Feishu content, uploading URL media before sending. [write]
• send_vc_meeting_message — Send a text message or reaction through the app's in-meeting bot. [write]
• set_base_view_card — Replace the card configuration of a Base view. [write]
• set_base_view_filter — Replace the filter configuration of a Base view. [write]
• set_base_view_group — Replace the grouping configuration of a Base view. [write]
• set_base_view_sort — Replace the sorting configuration of a Base view. [write]
• set_base_view_timebar — Replace the timeline configuration of a Base view. [write]
• set_base_view_visible_fields — Replace the visible field configuration of a Base view. [write]
• set_cells — Write values, formulas, styles, comments, or validation to an A1 range. [write]
• set_sheet_cell_image — Fetch an image from a public URL, upload it to a Feishu spreadsheet, and embed it into one cell. [write]
• set_sheet_dropdown — Set dropdown validation across every cell in a range. [write]
• set_task_ancestor — Set or clear the ancestor of a Feishu task. [write]
• share_mail_to_chat — Create a Feishu mail share card for one message or thread and send it to an IM recipient. [write]
• sort_sheet_range — Sort a cell range by one or more columns. [write]
• submit_base_form — Submit JSON field values to a shared Base form. [write]
• submit_drive_export — Submit an asynchronous Feishu Drive document export and return a handle for status polling. [write]
• submit_drive_import — Fetch a source file, upload it as Feishu import media, and submit an asynchronous Drive import task. [write]
• submit_wiki_move_to_drive — Move a Wiki node out of its knowledge space into Drive and return an asynchronous task handle. [write]
• subscribe_mail_events — Subscribe a user mailbox to Feishu message-received events before consuming the corresponding push event. [write]
• suggest_calendar_times — Suggest available meeting times for Feishu users and chats.
• transfer_approval_task — Transfer a pending approval task to another user. [write]
• trash_mail_messages — Move Feishu mail messages to trash in batches of 20. [destructive]
• triage_mail_messages — Auto-paginate compact mailbox summaries through list or search APIs with a stable continuation token.
• ungroup_sheet_dimension — Ungroup rows or columns in a sub-sheet. [write]
• unhide_sheet_dimension — Unhide rows or columns in a sub-sheet. [write]
• unmerge_sheet_range — Unmerge cells in a range. [write]
• unsubscribe_mail_events — Unsubscribe a user mailbox from Feishu message-received events. [destructive]
• update_app_slash_command — Update the description, localized descriptions, or icon of a slash command selected by ID or name. [write]
• update_base_dashboard — Update a Base dashboard name or theme. [write]
• update_base_dashboard_block — Update a Base dashboard block name or data configuration. [write]
• update_base_field — Update one field in a Feishu Base table. [write]
• update_base_form — Update the name or description of a Base form. [write]
• update_base_form_questions — Update up to ten Base form questions by question ID. [write]
• update_base_record — Update one record in a Feishu Base table. [write]
• update_base_role — Delta-merge changes into a Base role configuration. [write]
• update_base_table — Rename a table in a Feishu Base. [write]
• update_base_workflow — Replace a Base workflow definition while preserving its enabled state. [write]
• update_calendar_event — Update Feishu calendar event fields and incrementally add or remove attendees. [write]
• update_chat — Update a Feishu chat's name or description. [write]
• update_document — Update a Feishu document with a high-level text or block operation instead of manually orchestrating docx block APIs. [write]
• update_document_cover — Upload an image from a public URL and set it as a Feishu docx document cover. [write]
• update_drive_comment — Mark a Feishu Drive comment as solved or unresolved. [write]
• update_drive_permission — Change a collaborator's permission role on a Feishu Drive resource. [write]
• update_drive_secure_label — Set the secure label of a Feishu Drive file or document. [write]
• update_mail_draft — Replace the complete content of an existing Feishu mail draft. [write]
• update_mail_template — Fetch and fully replace a mail template after merging provided JSON fields; concurrent writes are last-write-wins. [write]
• update_minutes_title — Update the title of one Feishu Minutes record. [write]
• update_okr_indicator — Find the first indicator for an objective or key result and update its current value. [write]
• update_okr_progress — Update the content or rate of an OKR progress record. [write]
• update_okr_weights — Replace objective or key-result weights with explicit ID and weight pairs. [write]
• update_sheet — Rename, move, hide, show, or recolor one sub-sheet. [write]
• update_sheet_chart — Update a chart object. [write]
• update_sheet_conditional_format — Update a conditional format object. [write]
• update_sheet_dropdowns — Apply one dropdown configuration to multiple sheet-prefixed ranges. [write]
• update_sheet_filter — Update a filter object. [write]
• update_sheet_filter_view — Update a filter view object. [write]
• update_sheet_float_image — Update a float image object. [write]
• update_sheet_pivot_table — Update a pivot table object. [write]
• update_sheet_sparkline — Update a sparkline object. [write]
• update_task — Update the editable attributes of a Feishu task. [write]
• upload_base_attachments — Validate a Base attachment field, upload one or more files from public URLs, and append them to one record cell. [write]
• upload_docs_media — Upload an image or attachment from a public URL to a Feishu document block, using multipart upload above 20 MB. [write]
• upload_drive_file — Upload a file from a public URL to Feishu Drive, automatically using the three-step multipart protocol above 20 MB. [write]
• upload_minutes_media — Upload audio or video from a public URL to Drive and create a Feishu Minutes recording from the resulting file token. [write]
• upload_okr_image — Upload an image from a public URL for use in Feishu OKR progress rich text. [write]
• upload_slides_media — Upload an image of at most 20 MB to a Slides presentation for use as an XML <img> file token. [write]
• upload_task_attachment — Upload a file from a public URL as an attachment to a Feishu Task resource. [write]
• upsert_base_record — Create a Base record when recordId is omitted, or update that record when recordId is provided. [write]
• verify_sheet_formulas — Scan formulas for errors across selected sheets or ranges.

Safety

• Untagged actions are reads (get / list / search) — safe to run directly.
• Actions tagged [write] change Feishu state — confirm the exact payload and effect with the user before running.
• Actions tagged [destructive] remove or overwrite data — always confirm the target and get explicit approval first.

First-time setup

These are one-time steps — do not repeat them on every call. Run a step only when a command fails for the matching reason.

• oo: command not found — install the oo CLI (other platforms: https://cli.oomol.com/install-guide.md):

  curl -fsSL https://cli.oomol.com/install.sh | bash    # macOS / Linux
  

  irm https://cli.oomol.com/install.ps1 | iex           # Windows PowerShell
  

• Not signed in / authentication error — sign in to your OOMOL account once:

  oo auth login
  

• scope_missing / credential_expired / app_not_ready / app_not_found — Feishu is not connected, or the connection expired or lacks a scope. Connect once (auth type: OAuth2) at:

  https://console.oomol.com/app-connections?provider=feishu
  

• HTTP 402 / OOMOL_INSUFFICIENT_CREDIT — billing stop. Recharge at https://console.oomol.com/billing/token-recharge before retrying.

Resources

• Feishu homepage: https://www.feishu.cn