# create_drive

## nominal.experimental.drives.create_drive(client, id, *, description=None, workspace_rid=None)

Create a managed drive.

Parameters:
:   - **client** ([*NominalClient*](https://dev.nominal.io/python/ref/generated/nominal.core.NominalClient.md#nominal.core.NominalClient "nominal.core.client.NominalClient"))

      Client providing authentication and workspace configuration.
    - **id** ([*str*](https://docs.python.org/3/builtins/stdtypes.html#str "(in Python v3.15)"))

      Identifier for the drive, unique within the workspace. Up to 100 letters,
      digits, `.`, `-`, and `_`, starting with a letter or digit; ids starting
      with `nominal.` in any casing are reserved.
    - **description** ([*str*](https://docs.python.org/3/builtins/stdtypes.html#str "(in Python v3.15)") *|* *None*)

      Free-text description of the drive.
    - **workspace_rid** ([*str*](https://docs.python.org/3/builtins/stdtypes.html#str "(in Python v3.15)") *|* *None*)

      Workspace to create the drive in. Defaults to the client’s workspace.

Returns:
:   The created drive.

Raises:
:   [**NominalAlreadyExistsError**](https://dev.nominal.io/python/ref/generated/nominal.exceptions.NominalAlreadyExistsError.md#nominal.exceptions.NominalAlreadyExistsError "nominal.exceptions.NominalAlreadyExistsError") – A drive with this id already exists in the workspace.

Return type:
:   [*Drive*](https://dev.nominal.io/python/ref/generated/nominal.experimental.drives.Drive.md#nominal.experimental.drives.Drive "nominal.experimental.drives.drive.Drive")
