DingTalk Workspace CLI

DingTalk (Singapore) Private Limited·Alibaba.DingTalkWorkspaceCLI

dws — DingTalk Workspace on the command line, built for humans and AI agents.

dws — DingTalk Workspace on the command line, built for humans and AI agents. Why dws? - For humans — --help for usage, --dry-run to preview requests, -f table/json/raw for output formats. - For AI agents — structured JSON responses + built-in Agent Skills, ready out of the box. - For enterprise admins — zero-trust architecture: OAuth device-flow auth + domain allowlisting + least-privilege scoping. Not a single byte can bypass authentication and audit.

winget install --id Alibaba.DingTalkWorkspaceCLI --exact --source winget

Latest 1.0.60·August 27, 2026

Release Notes

This release promotes the sealed v1.0.60-beta.3 contents to stable. Changed

  • Document, Drive, and Sheet workflows — adds Drive quota, task polling, export, permission, comment, public-link, history-version, revision, floating image, and delegated-access workflows; hardens document import, large Markdown writes, download handling, and readback verification.
  • Collaboration and automation commands — adds dedicated Chat Thread commands, AITable datasource management, Agoal scorecard search, OA approval attachment upload, and reviewed Whiteboard workflows.
  • Agent-safe CLI contracts (#1161) — publishes stricter pagination, result, confirmation, routing, and error contracts across report, Sheet, Minutes, AiSearch, Contact, Task, Wiki, and document commands, plus reviewed argument aliases for Agoal, DevApp, AITable, and Chat shortcuts.
  • DWS OpenAPI escape hatch — supports file-backed parameters and request bodies, multipart uploads, pagination, and bounded binary downloads while tightening redirect, credential-pair, Keychain migration, and error-handling behavior.
  • Supported command surface — removes the retired Education and College vendor extensions and improves command typo guidance, fork admission, and Reviewer Router merge recovery without weakening protected-main checks. Changes since v1.0.60-beta.3 Added
  • Drive local-file comments (#1151) — adds the complete global comment lifecycle for Drive files through the shared document comment service, including create-v2, list-v2, reply, update, delete, batch query, direct-reply listing, resolve, restore, and reaction replies. The existing create and list leaves retain their legacy behavior and output contract with deprecation guidance for an explicit migration.
  • Markdown comment reads (#1151) — adds comment listing for native Markdown files with global, inline, resolution-status, and cursor filters, and exposes direct-reply listing across the shared Doc and Sheet comment lifecycle.
  • Chat Thread commands — adds thirteen chat thread leaves for topic-circle creation, Thread publishing, reading, replying, forwarding, recall, emoji reactions, and text emotions. Parameters keep the original chat group / chat message names, including --conversation-id, --topic-id, and the existing forward flags.
  • Doc-business delegation auth — the drive, doc, sheet, wiki, and markdown command groups now accept a persistent --principal-user-id flag. When set, the first invocation of each doc-business tool key per node within a session is gated by a check_capability verification on behalf of the principal; granting the capability is an out-of-band action the principal completes on the server side, and the CLI never calls grant_capability. A denied check surfaces the server's denial message and blocks the original call.
  • Dry-run consistency — checkCapability now executes in dry-run mode as well, ensuring preview and execution behaviors are consistent. In dry-run, the check routes through the ReadTool channel (real network request) instead of CallTool (which would go through EchoRunner and always deny).
  • Dry-run pre-check in helpers — dry-run mode now invokes the delegation auth validator before rendering the preview, ensuring commands that would be denied at execution time are also blocked at preview time.
  • Local rejection for node-less commands — commands that lack a node identifier (e.g. search/list/create without nodeId) now return a clear client-side error (DELEGATION_AUTH_NOT_SUPPORTED, exit code 3) when --principal-user-id is set, instead of forwarding an incomplete request to the server.
  • Concurrency safety — the per-session checked map in the delegation auth decorator is now protected by a sync.Mutex, preventing data races under concurrent tool invocations.
  • Markdown dry-run parity — the markdown fetch/create/overwrite/patch/diff commands now run the same check_capability delegation gate on their dry-run previews as doc/drive do; a dry-run combined with --principal-user-id is verified against the command's real first delegated call before any preview is rendered, and a denied principal blocks the preview. Changed
  • Report latest lookup — scans bounded, strictly advancing outbox pages, reconciles duplicate IDs, and reads back the uniquely newest report instead of failing on the first continuation page.
  • Sheet create-with-data result — returns the already probed sheetId at the top level while preserving legacy .result.nodeId and outer requestId, avoids repeating the sheet-list probe, keeps the main-compatible single readback check, and reports post-create partial/unknown state without unsafe whole-workflow retries.
  • Sheet workflow routing — distinguishes local analysis from Excel-to-online import, exposes template discovery and apply routes, and preserves the full data-validation tri-state contract.
  • Received-report helper and routing — restores same-profile sender resolution before inbox filtering, keeps Mono and Multi helpers identical, uses bounded complete pagination, renders epoch timestamps in the Shanghai timezone, fails closed instead of returning incomplete data, and keeps midnight query windows valid. Fixed
  • Minutes pagination results (#1112) — publishes list, search, and transcript continuation and exhaustion evidence through the unified meta.pagination envelope, while keeping business-scope completeness separate from endpoint exhaustion.
  • Chat Thread create result — returns the created group's openConversationId and omits internal openCid / cid fields, matching chat group create --thread.
  • Doc agent routing and import defaults — aligns document and drive Skill guidance with the executable CLI contract, preserves structured heading and attachment routes, publishes required shortcut arguments, and resolves the current profile's default document target before an import is submitted.
  • Reviewer Router preflight — defers App-owned merge attempts while GitHub reports transiently unknown mergeability, avoiding false reconciliation failures without weakening approval or required-check enforcement.

Installer type: zip

x64CCE1CB02FECE17443957441207849F3DD465BB3261377DEDC349D27046CEDCB6
arm649AFF0FF67DF946E1C552C999E3AC594EB5B2159922AAF0472DEC671796F3EC1F

Details

Homepage
https://github.com/DingTalk-Real-AI/dingtalk-workspace-cli
License
Apache-2.0
Publisher
DingTalk (Singapore) Private Limited
Support
https://github.com/DingTalk-Real-AI/dingtalk-workspace-cli/issues
Privacy Policy
https://terms.alicdn.com/legal-agreement/terms/suit_bu1_dingtalk/suit_bu1_dingtalk202102181006_34132.html
Copyright
Copyright 2026 Alibaba Group
Moniker
dws

Tags

dingdingdingtalk

Older versions (55)

1.0.59
x645393A0D5E00C70B58833C60610AD3A772926CA5E4EB38C360928E3D2552451BC
arm648C1A8EAA527A56197FD1A26D21B0F6C8B8B0E2270D1AD4C1D97519F4CAB0F094
1.0.58
x64B8C50D9111115EAFDB466978F1DD8F9421BCC2D5FAC848023108353DC5A236CB
arm64E1303DED8A863BE9AFFC41C89AC1A889A14374888702B749C8D0507AD6ABD202
1.0.57
x64DB574ED014217F871ACAFED95BC0DD9ED760BAE032601259B985465907791990
arm648F5A21677948D25CD8DAEDFD47C9B1AD7836633DAD597FEB627E59C34994C513
1.0.56
x64C779C821A11E68945CEE1548B6BA870DEDFF092F6065A1621233E8A91DC72F36
arm642C7DAE62AB40215E23AE03D1B7949771A299B78DA47003BFB8A2D7346E99443D
1.0.55
x649E273FA5F069A2606921AA5D325849A2245A1BB6D81329F5AA02376421C2330C
arm642C417F8957B683D5E354FEFEB9F06115BB020F957DBB3C4DBE078B2D1275E3F0
1.0.54
x6412B44ABEA0940B39960BDFCBE2033FF904544A9D042095CD17DE9A9F423BB30D
arm64A09DC09537BE654DC4559104A546372D4F13CCDA2EB0E445D09863B4E83778E7
1.0.52
x64B760EFD557470E86AD4F35C4617BA9B93112EBF055E821AE404FC162C32C19CD
arm641A2253C4BE0870F1D64F2480B949455CFC15DD2F6FDA6B7AC0CC8E30ECF91F44
1.0.51
x6485446092B155488F59BFB874A53DA5720327D47CBE9ED934B2CE37B498212A4E
arm64E4686C4FAFD4F118228B1748A741A5078A984D6ACAF3D4AE4B0570A0AABA6B92
1.0.50
x64F4C9C41B498EC2EE1496E27089A7EE30F2DB410630D0B4BEC845E170757CFCE1
arm64D7DB0107C0FDB617A924E0932A6DE55074D53C37E8583C227CA56F201428012D
1.0.49
x649A88936F930D25B8839C9890CF90B1F0699502AAF68CA80C82960E6344E025EB
arm6492ED45B5C392FAE08A2AE30330044B3D54346EC3646423CB848582F27ECCAF86
1.0.48
x6432F7BBB81BD1A85E10DFCC617F5680BD0CFC96E018ED691722E07E1AAA340D53
arm64B2A931E12F155124AE8A37E67052EDC9A8B7D2C377B9052AECFC5486929AD15B
1.0.47
x6498F36DB005FDBAC9699E509820678B23E0F26ACEA7ECB58B74EC4531DB0D8C9B
arm64FC7AFBC00AD6B48FCFFF0D98C8A4FA1DC818D8421CFA732BE77375057B43A74B
1.0.46
x647644AE70230E5CE6599B67FC6528D02387E925216A33798C1C723407653AED72
arm64DCFD676E3D4632F23C70DE41666DEAE636940CA72A059C72A6B47623D77513BE
1.0.45
x647D8E2140D3D3F3A66CCA31916331766E205463CB96760B938851F0D7DFE2C90F
arm64239DC4DEB6F5806690CF5BA2531A8DB5DE6D3BBEEC3CDB928D32A8309628F0A9
1.0.44
x642446E6818E1CFE4879D780291400D6CFA57E445612B0E602FAF3CC8C37594642
arm64710B93B10EA6D8C5178E9DAC7F20CD0A853B0F8C06221A2540D1390EEB00315F
1.0.43
x64CEA73D2C6EB0CD26C8FEE71BE6C9C05E852449AAFEE42DCE049D19FF7D54DC2E
arm64AC9D4399ADCEE3258E2BCB686D1B99172FDBF5D33DD7A5E0ACC04F9CD84A7749
1.0.42
x644ECEFD60FB37710CC4971265E298B3758F38C71F4C6905C80474E760AD86BBE3
arm643B2B325EF3872710EF2817EA592DC4BE46E3B6231BD0472C003D2C2C5F653FFB
1.0.41
x6497F5814C4447ACFE0DA843F1BDE938132C20F8E644D0C1D05CCB2679EA652FD5
arm64F903DA511E08B6E1F4ABD2415B7111854B9C3082A914FB7AF5DFCD676C928F9D
1.0.40
x646E73E1B2D824CC8B11AA95C2972EFB1151859B02A34C606AA11A34B3FDFD8450
arm64968136AF973DB7A5D8EE3295FB14669FA7DF7DA2CB0C464B28FADE9EA7A934AD
1.0.39
x64012797A72AA1B7471630A391D10C64EFB355F7BD7FF56CA226CF648ED366207B
arm643AC572EE1DB4BD91396AB4E87FD50B4F0518BE1804FF816A7164B55D23E43C95
1.0.38
x641388C68352DAE44CA4343D1FAA284E5DDB6BE2AB928067E496F718075CCF5749
arm64419854C6DC05D1471E16348ACEF6820EAE4848CDBAC1A64894A8E5A8D479C1DD
1.0.37
x64A9994B04A852464FE741B75788F8DC4497DAB23B200E5CC88E61A1B4F758FFF0
arm64AD87BBAEBB28CE4072D07A7ABBE9594936A609F2D4274C1D89F592CB1278431D
1.0.36
x64A039B022E2BEDA67DDFB23CCF8DB1A6FCC431748B7ECCC26F41DD66A452F2B89
arm64F3821A8F61F4D9A77E71C03B19578DF74354D189D5C94E563E3D6CE46B684EE1
1.0.35
x648543B63140FBF0579B1B8B8CBCDBF5CA2646BD1CA2A72C3896766329B45D202E
arm648F23D25DB0CD5D576B4CB6BED4F7B63A5F8490FC511897967C262F0E086B6D3F
1.0.34
x64CF759FC4F08754A8089B36DE4032D54CC3AF38D3722E154361E9AEB29ECAABA0
arm64C414E4461DEE9FCB339D0249FAC6A19CE1390B74A0286B34C5CA01096833B095
1.0.33
x64609F5086EFE609202F9DF3F2FD8E31FB93EB74E68DDF62ABA6D934D75844B4E2
arm6456419D5858352EBED19966CBC6F1FD57153F4EAB36DECB5CDDDA5BA74BA52E50
1.0.32
x64AC2FE016DD7BD284DC8180B59AD8F3371EF8F4A065FEF567F4210BA69D4A49F0
arm643C4F617A61D55D411C896E5A7BCCC0A8335ED5ED3A707BEC728FA62604DB19FD
1.0.30
x64BBFFF7D0EFDEFFEC854D54F14F659949614B77F5779CAB24BA18689248DDBDF2
arm6478067A3A0307EF1BE57A47EC0C64469C4148E44323EC94F526BD40B14719B354
1.0.29
x64C5E02D212547E4B4D285B05674E68F28F5DECCCCDC29F011027BE97AABAB50C4
arm64CBED69D97D3695974797E580034DA04348DFF886BFC1DCF766E149883D168570
1.0.28
x64B38231A9AC81887CA514F9B6AEE002D81CCDC394310481D5E13E5AAEFBC32230
arm648B5948ECCF3A6750E8B8F29B9F8F92DB84A1815DE26E7CF57DCC045AA54EF5E3
1.0.27
x640F6B7F3D8A5ABFE1FE4CFEF3160C820A2A0703B7A24A29405EE9D57A140ADCE9
arm64D91CA3E58B629B81CA0D4E51A11D30F47E59DCC10B58A9FF31457BA3428C56AD
1.0.26
x64ED5D33BB1D54245B94A26689A23E3EB95B402CF180EF9EC9C4E85D891517E6C0
arm64F6E0F7DF3511908A2E4270F26AB2CC8E23FCE556B5891D2CC09F0F67633F8BE7
1.0.25
x644EFF3A0850ED2219A985B0A0CBDE12DCBF8B2302C3F06E37679B973B82352ADA
arm641286BF0F08360096D10C6AFCE7C9FF15ECFC140DF3E955627AF1CC425CD81582
1.0.24
x649CBC9FD3550962E51DDC6930FA2E7EC42DD0644A9CB2CA438BD0759909D31446
arm64ED2EFE665C02775FD29227F80EDF80915AD02F4D7C0B176EDEC8C3379FCB9142
1.0.23
x641761500E9F20ADB27ACC9030FCA705FDFA924FE253FDDAC472E59D46A2D323A2
arm648367D131B8FC225A128CA589201AAF0BFE8CA46A1935B1D838E3C37227AA7EE8
1.0.22
x644BD644C4BDE1D736EB8FC204D6BFD1ECD08314FD6F664008DD67D73A1A6B2223
arm64CA6D70B18715D4AB511172CADFB64818820565F76C90CEBCF8FBA48B6E599FF1
1.0.21
x642051B16AB44AFCDE51003A77200EA882AF4DE6D8DBBE075C184536AECD7F1E1E
arm6424C62F206FDF2F0CFB5E8FFF3682C14DBC7AC7951A35E33A6C67CBC8C89950C3
1.0.20
x6473A52B388299D5B35CB1135B5295254BFD4039AB7AA5FF7BEC4DB040FD30DDEC
arm645529EC2DE42F5FFBC1C13AD3493DC53D8F4C2761455EFD780796BC02C9674146
1.0.18
x64B54E07D660A24CECB0785D9A837573954D20A96A49DBE5C2B982BB3A7963B3D6
arm64E2CEE72C5D72EE3AD724268DB58AE96F223B8A70C158D7CEC7DE970BBDE29D2A
1.0.17
x64CBBD2C188E7BA155BC9E85B36472DEAEF5C4DEFB3BBB136A360B007CDB39419B
arm645E96582201EE1DB635D0552E94CADDE2C3578367749C07971C0145B5765F8F1A
1.0.16
x64DD679EBFC25E5E01038603A435E76F8040AC9E4D15B401FE823B2E53B39DADEF
arm647B8626DAB85503BC1909C189A87B3101AC70F00120EF31A384300FD4E1CD28AB
1.0.15
x64E351612A3409AB367ED0D01EE4A37420CC8F485890775C7224CB972833051475
arm64B5C5C7F3DA6F143F4B18A242991CC9E2FFD2F5F9F8C02D55F820E036516D511F
1.0.14
x6440DF1ADE5A311A081760F286B969FE52E70B450186BF38D8CBCE409E666BA926
arm640B75506FC38150523AC6DC2E1ACD1B31957DF63BBD3BE362B0497F6216EBC627
1.0.13
x643A519D6F39911048387CBC471042C65A230014EB2B8ECF2E7FF13E88C9303643
arm64EC353E68D4CF4C53856D5352D9FBF97E68F0C44F21F791E75FAD2CD7044EC1B5
1.0.12
x6486DA21CE5889628F4376D825E0FC6F48D5A7D739AEEE9B5F2F22B38E7B6FCA38
arm645735441C424D68EA0E16FA1CC3DF5217DC5207E3435A7B59B8CA08343DD4BA1B
1.0.11
x64761F471AB7DD1A30952003123339076C7A71B8274BF2550C499EE561CB947A65
arm6498535246ACCC82049DEB0ED58F1BD1A898ACE4AE62F231B15E48EEC387700696
1.0.10
x6469D6910F071FFCCF2CCECB9D7CC397A9EF01ECA3AEBBEAF716BA6398211E7CC1
arm64AB38AC0C62F64146985148D5D94811963A498C343B73B179DCD43762EF55A88F
1.0.9
x64FD4E046039C107449E54E70274ABF6A57E31763463D1711D4388E1045FFA9CFD
arm64AA8268F555BF13E3D33E7AAE7110FAEF81733C1E79D6488F1B776AA326132C13
1.0.8
x647DC4E568B1386423784E6BAF17FE675C11EB6C075BD887DCB0EDE53CDDED85E8
arm64032711BCC58D225F1FA88F9F059E2D8B86F576643ED6B6CD5C03A6CE770E7FB1
1.0.7
x6406F842260886C586942BEA2B1B92913370DCC92BDBEEFE723FAFEA0AD41BFB37
arm6497CD7A27D3536D4F9ECF01F405035571A9ED905966EE778503DD2A979BBEDD11
1.0.6
x648A95BC283F94441DDCCF884B1E441A96F1A8B20C614B4280ED7140E3C5602C31
arm64EA081C793A5355B7BB7252862C3D667B7F2FE783C46C8CA34CF07BF6754BE1CE
1.0.5
x646AE0A842A91BA3BBB2B98458C3214E1FB844F584F544D56E833159F279657E1E
arm6489F94D9939C1D9D4DEBC16FC33451F10B7B8DE3DEEADD1F938B33063A8DC6ED2
1.0.4
x64E851EB7DA3627A7209D4329C348A6ACEDD9A122F588D727DCE4DFBD0A89542AB
arm64013933E8D45A7C51723E68155F0D5D0301A3966F76408563895F6088EF552762
1.0.3
x6421ADA051C8687D02E1515D32FE8E01DF53D0D9B6FDE09D9FA123D8DAC9F6FF0B
arm640043AA7CB5C5058E52416224A60916EC050AF8CB64798EE5873EA74BEB4189FA
1.0.0
x6449448487590C6578F727F4ED9926711989405431D7FE854C9AB60B8CFE6030D5
arm645ABA0591898723614FFFF839992124768895C4A684B82380F75D80AAF74FBE19