lark-project

Use the workitem.query command with a full MQL statement selecting explicit fields from `space`.`work_item_type`. First call workitem.meta-fields to confirm field keys, and paginate with session_id when you need complete results.

Call workitem.create with the work item type and a fields array. You must first fetch the template ID via workitem.meta-fields with field_keys=["template"], since the template is required, and use role_operate-style role arrays for role assignments.

MQL is Meego's SQL-like query language requiring SELECT and FROM clauses with backtick-quoted identifiers. It supports array functions like array_contains and any_match, relative date functions, node attribute functions, and relation chain queries, but forbids count(), SUM(), and GROUP BY.

Yes. For node-flow items use workflow.transition with action confirm or rollback; for state-flow items use workflow.transition-state after fetching the transition_id via workflow.list-state-transitions. Always get the real node_id from workitem.get first.

workhour.list-schedule accepts at most 20 users per call and a maximum 3-month time span per request. Split larger teams into parallel batches and longer ranges into monthly chunks, then aggregate only after all batches complete.

Common causes include using English field keys instead of configured names, querying date-range fields directly instead of their __field_start_time subfields, or missing the __ prefix on role fields. Verify field configuration with workitem.meta-fields before retrying.