PicoBot/.qoder/skills/lark-wiki/references/lark-wiki-space-create.md
ooodc a7883dbed9 refactor(todo): 重构待办事项管理逻辑及更新状态规则
- 移除 TodoItem 中的 priority、created_at 和 updated_at 字段
- 强制每个任务都必须有唯一 id,且由用户负责生成
- 修改合并模式逻辑,merge=true 下保留未提及的旧任务
- 支持已完成和已取消任务重新激活(状态改回 pending 或 in_progress)
- 禁止 in_progress 状态退回到 pending,必须标记为 completed 或 cancelled
- 优化状态转换校验,允许特定状态间合法切换
- 简化任务变更消息,移除详细的新增/更新/移除统计
- 更新文档和示例,明确 id 必须由用户生成和使用
- 修复和补充测试,增强状态转换和合并模式验证
- 调整任务时间戳生成逻辑,统一使用当前时间及索引
- 该变更提供更合理的任务状态机械及管理模式,提升稳定性和易用性
2026-06-13 09:22:33 +08:00

1.5 KiB

lark-wiki +space-create

Create a wiki space. OpenAPI: POST /open-apis/wiki/v2/spaces. This is the project-initialization entry point — the alternative is hand-writing wiki spaces create --params '{...}'.

The underlying spaces.create API is flagged danger: true in the schema browser, but it is not confirmation-gated (no --yes). A space created by mistake is recoverable via wiki +delete-space.

Usage

lark-cli wiki +space-create \
  --name <space_name> \
  [--description <text>] \
  [--as user]

Flags

Flag Type Required Default Description
--name string Yes Wiki space name. Blank/whitespace is rejected (an unnamed space is almost always an accident)
--description string No Wiki space description
--as enum No user User identity only — the create API does not accept a tenant/bot token; --as bot is rejected upfront

Output

{
  "space_id": "7160145948494381236",
  "name": "Engineering Wiki",
  "description": "team docs",
  "space_type": "team",
  "visibility": "private",
  "open_sharing": "closed"
}

There is no url field — the create API does not return one.

Notes

  • Only --as user is supported; this command declares AuthTypes: ["user"] and the framework rejects --as bot with a clear message.
  • --dry-run previews the POST /open-apis/wiki/v2/spaces request (and surfaces the blank-name validation error early).

Required Scope

wiki:space:write_only