CRITICAL — Before starting, you MUST first use the Read tool to read ../lark-shared/SKILL.md, which contains authentication and permission handling
Shortcuts (recommended for priority use)
Shortcut is a high-level wrapper for common operations (lark-cli contact +<verb> [flags]). For operations with a Shortcut, use it first.
| Shortcut | Description |
|---|---|
+search-user |
Search users (results sorted by relevance) |
+get-user |
Get user info (omit user_id for self; provide user_id for specific user) |
Known Limitations
External tenant users are not searchable via API
+search-user, +get-user, and GET /contact/v3/users only return users within the same tenant.
Users from other organizations (external Lark accounts) will not appear in search results and their open_id / user_id cannot be retrieved via the contact API — even with a tenant access token (bot identity).
Workaround options:
| Scenario | Solution |
|---|---|
| Add external user to Wiki/Doc | Invite as guest via admin console → use open_id returned after invitation |
| Share document with external user | Use open_sharing: anyone_readable (link-based, no Lark account required) |
Obtain external user's open_id |
Ask the user to look up their own open_id in Lark profile settings |
# After admin-console invitation, use openid directly:
lark-cli wiki members create \
--params '{"space_id":"<space_id>"}' \
--data '{"member_id":"ou_XXXXXX","member_type":"openid","member_role":"member"}'