dingtalk-todo

Automate DingTalk todo creation, update, deletion, and queries via API.

Updated Mar 23, 2026
One-click install
npx skills add https://github.com/farrrr/dingtalk-openapi-skills --skill dingtalk-todo-farrrr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dingtalk-todo
Source: https://github.com/farrrr/dingtalk-openapi-skills/tree/main/dingtalk-skills/skills/dingtalk-todo
Command: npx skills add https://github.com/farrrr/dingtalk-openapi-skills --skill dingtalk-todo-farrrr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

DingTalk todo task API — create, update, delete tasks, manage executor status, query org todo list. Covers both work todos (third-party with detailUrl) and personal todos. Trigger keywords: 待辦, todo, 任務, task, 執行者, executor, 待處理, pending.

Core Features & Use Cases

  • Create, update, delete work todos and personal todos
  • Manage executor statuses and query organization todo lists
  • Support work todos requiring detailUrl and personal todos using user tokens

Quick Start

Create a new work todo for a given unionId with a subject and detailUrl, then update or query existing tasks as needed.

Frequently Asked Questions about dingtalk-todo

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage DingTalk todos via API for organizational workflows?

To manage DingTalk todos via API, you can automate creation, update, deletion, and query operations for both work and personal todos using DingTalk v1.0.0 APIs with openapi authentication.

What's the difference between work todos and personal todos in DingTalk API integration?

DingTalk work todos require a detailUrl and use third-party integration, whereas personal todos require user tokens for authentication when creating, updating, or querying tasks.

How do I create a work todo in DingTalk using a unionId?

To create a DingTalk work todo, provide a target unionId, a subject, and a detailUrl, then execute the API call. You can subsequently update or query the existing task as needed.

Do I need openapi authentication to query an organization todo list in DingTalk?

Yes, querying a DingTalk organization todo list and managing executor statuses requires openapi authentication to access the v1.0.0 APIs for both work and personal todos.

Can I update executor status for pending DingTalk tasks through an API?

Yes, you can update executor statuses for pending DingTalk tasks by applying the update operations through the v1.0.0 API, covering both work and personal todo categories.

What are the limitations of using DingTalk todo APIs for task automation?

DingTalk todo APIs require proper detailUrl configuration for work todos and valid user tokens for personal todos, limiting automation without proper openapi authentication setup.