Mingdao

Operate Mingdao through your OOMOL-connected account. This skill calls the mingdao 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 Mingdao. 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 "mingdao" --action "<action_name>"

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

oo connector run "mingdao" --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_role_members — Add users, departments, department trees, jobs or organization roles to an application role. [write]
batch_create_custom_actions — Create workflow, record-update or related-record custom action buttons. [write]
batch_create_records — Create multiple Mingdao worksheet records with the batch API’s string-encoded field values and URL-based attachments. [write]
batch_create_views — Create table, kanban, gallery, calendar, hierarchy, gantt, resource, detail or map views with their configuration. [write]
batch_delete_records — Delete multiple Mingdao worksheet records, optionally permanently instead of using the recycle bin. [destructive]
batch_update_records — Apply the same field updates to multiple Mingdao worksheet records and report successful and failed record IDs. [write]
create_app_items — Create blank worksheet or custom-page application items. [write]
create_app_sections — Create navigation sections in the connected Mingdao application. [write]
create_chart — Create a worksheet chart with dimensions, metrics, date ranges and filters. [write]
create_chatbot — Create a chatbot with a system prompt, welcome message and up to five preset questions. [write]
create_optionset — Create an application option set with ordered values, colors and scores. [write]
create_record — Create a Mingdao worksheet record using field IDs or aliases and URL-based attachment values. [write]
create_role — Create an application role with global or per-worksheet, view, field and page permissions. [write]
create_worksheet — Create a worksheet and its fields, including links to already-created worksheets. [write]
delete_record — Delete a Mingdao worksheet record, optionally permanently instead of using the recycle bin. [destructive]
delete_role — Delete an application role and revoke the access it grants. [destructive]
delete_worksheet — Delete a worksheet from the connected application. [destructive]
disable_optionset — Disable an existing application option set. [write]
generate_record_share_link — Generate a record share link with selected visible fields, optional password and expiration. Omitted or zero expiration means the link does not expire. [write]
get_app — Get the connected Mingdao application’s identity, metadata and navigation sections.
get_approval — Get the execution details, current steps and available operation metadata for an existing Mingdao record approval.
get_record — Get one Mingdao worksheet record with its dynamic field values and optional system fields.
get_related_records — Page through the records linked by a Mingdao record’s relationship field.
get_role — Get a Mingdao application role’s global, worksheet, field and custom-page permissions.
get_workflow — Get a Mingdao workflow’s input and output parameter definitions before triggering it.
get_worksheet — Get a Mingdao worksheet’s fields, views and metadata before querying or writing its records.
list_approvals — List approval executions for a Mingdao record, optionally selecting completed or incomplete executions.
list_knowledge — List Mingdao application knowledge bases, including their configured embedding models.
list_optionsets — List the reusable option sets in the connected Mingdao application.
list_record_discussions — Read a Mingdao record’s discussions, including replies, mentions and attachment metadata, with optional search and Markdown output.
list_record_logs — Read a Mingdao record’s change logs, optionally filtered by operators, field and date range.
list_records — Search, filter, sort and page through Mingdao worksheet records, with optional field selection and total count.
list_regions — List or search Mingdao geographic regions; omit the region ID to retrieve top-level regions.
list_roles — List the connected Mingdao application’s roles and their user, department, job and organization-role memberships.
list_workflows — List the existing webhook and packaged business process workflows available in the connected Mingdao application.
list_worksheets — List worksheets in the connected Mingdao application, optionally restricted to selected worksheet IDs.
lookup_departments — Look up departments in the Mingdao application’s organization, optionally matching an exact department name.
lookup_users — Look up users in the Mingdao application’s organization, optionally matching an exact user name.
pivot_records — Aggregate Mingdao worksheet records into a pivot table with grouping dimensions, filters, sorting and optional summary totals.
remove_role_members — Remove users, departments, department trees, jobs or organization roles from an application role. [destructive]
remove_user_from_all_roles — Remove a user from every role in the connected application. [destructive]
search_knowledge — Search Mingdao knowledge content using vector, keyword or hybrid retrieval. Knowledge bases with different embedding models must be searched in separate calls.
trigger_workflow — Trigger an existing Mingdao workflow with its defined parameters. Its configured steps may update or delete business data; the returned result does not imply that all downstream work has completed. [write]
update_custom_page — Replace the complete custom-page component layout, including inline charts, views, tabs, containers and filter groups. [write]
update_optionset — Update an option set’s name, keyed options, order, colors and scores. [write]
update_record — Update a Mingdao worksheet record, replacing, adding or removing supported field values. [write]
update_worksheet — Update worksheet metadata and add, edit or delete fields. [write]

Safety

Untagged actions are reads (get / list / search) — safe to run directly.
Actions tagged [write] change Mingdao 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 — Mingdao is not connected, or the connection expired or lacks a scope. Connect once (auth type: API key) at:
```
https://console.oomol.com/app-connections?provider=mingdao
```
HTTP 402 / OOMOL_INSUFFICIENT_CREDIT — billing stop. Recharge at https://console.oomol.com/billing/token-recharge before retrying.

Resources

Mingdao homepage: https://www.mingdao.com/