create_access_link
Generate a workspace access link with customizable role, expiration, and space restrictions. Supports anonymous reusable links and personalized access.
Instructions
Create a Huly workspace access link. When role is omitted, role=GUEST. Supports anonymous reusable guest links by setting personalized=false with notBefore and expiration, and can restrict access to specific Huly space IDs via spaces.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| role | No | Workspace role granted by the link. Defaults to GUEST. | |
| firstName | No | a string that will be trimmed | |
| lastName | No | a string that will be trimmed | |
| navigateUrl | No | Optional URL/path Huly should open after the link is used. | |
| spaces | No | Optional Huly space IDs this link should grant access to. Use list_teamspaces, list_card_spaces, or other list tools to discover space IDs. | |
| notBefore | No | Unix timestamp in seconds before which the link is invalid. | |
| expiration | No | Unix timestamp in seconds after which the link expires. | |
| personalized | No | Whether the link is bound to one person. Omit to use Huly's personalized-link behavior. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes | The successful tool result. The same value is also serialized as JSON in the text content for clients that do not read structuredContent. | |
| warnings | No | Optional agent-visible warnings about degraded result fidelity. Omitted when the server returned the documented happy-path payload. |