create_drive
Idempotent
Create a new Huly Drive space or retrieve an existing one with the same name. Specify members, owners, privacy, and auto-join settings.
Instructions
Idempotently create a Huly Drive space. If an active Drive with the same exact name already exists, returns it with created=false. Initial members and owners accept account UUIDs, exact emails, or exact person names; omitted lists default to the caller.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | a string that will be trimmed | |
| description | No | Plain-text Drive description. | |
| private | No | Whether the Drive is private. Defaults to false. | |
| autoJoin | No | Whether workspace members should auto-join the Drive. Defaults to false. | |
| members | No | Initial Drive members. Each entry may be an account UUID, exact email address, or exact person name. When omitted, the caller is added. | |
| owners | No | Initial Drive owners. Each entry may be an account UUID, exact email address, or exact person name. When omitted, the caller is the owner. |
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. |