Skip to main content
Use delegations when another DID needs access to a path in your space. Use share links when you want a simpler handoff that can be accepted later.

​
Create a delegation

The CLI prefixes short actions with tinycloud. automatically, so kv/get becomes tinycloud.kv/get.

​
Inspect and revoke

Share links are built on delegations. The CLI’s share receive command still requires an authenticated TinyCloud profile. For accountless browser receipt, use the Web SDK’s static TinyCloudWeb.receiveShare() helper.
In @tinycloud/cli 0.7.7, tc share list and tc share revoke appear in command help but are not backed by working SDK operations. Do not rely on them. Use a short expiry, or retain the underlying delegation CID and revoke it through the SDK as shown in Sharing links.

​
DID and expiry rules

  • Use a PKH DID for user-to-user delegations
  • did:key is for session-key style identities
  • Expiry can be relative (1h, 7d) or an absolute ISO timestamp
The CLI source treats delegation create as the primitive, and share as a convenience flow on top of it.