Document create collection

api-reference/tilebox.datasets/Dataset.collection.mdx

@@ -21,7 +21,7 @@ A collection object.
 
 <RequestExample>
 ```python Python
-collections = dataset.collection("My-collection")
+collection = dataset.collection("My-collection")
 ```
 </RequestExample>
 

api-reference/tilebox.datasets/Dataset.create_collection.mdx

@@ -0,0 +1,26 @@
+---
+title: Dataset.create_collection
+icon: layer-group
+---
+
+```python
+def Dataset.create_collection(name: str) -> Collection
+```
+
+Create a collection in the dataset.
+
+## Parameters
+
+<ParamField path="name" type="string">
+  The name of the collection
+</ParamField>
+
+## Returns
+
+The created collection object.
+
+<RequestExample>
+```python Python
+collection = dataset.create_collection("My-collection")
+```
+</RequestExample>

api-reference/tilebox.datasets/Dataset.get_or_create_collection.mdx

@@ -0,0 +1,26 @@
+---
+title: Dataset.get_or_create_collection
+icon: layer-group
+---
+
+```python
+def Dataset.get_or_create_collection(name: str) -> Collection
+```
+
+Get a collection by its name. If the collection does not exist, it will be created.
+
+## Parameters
+
+<ParamField path="name" type="string">
+  The name of the collection
+</ParamField>
+
+## Returns
+
+A collection object.
+
+<RequestExample>
+```python Python
+collection = dataset.get_or_create_collection("My-collection")
+```
+</RequestExample>

datasets/collections.mdx

@@ -10,11 +10,13 @@ Collections group data points within a dataset. They help represent logical grou
 
 This section provides a quick overview of the API for listing and accessing collections. Below are some usage examples for different scenarios.
 
-| Method                | API Reference                                                                   | Description                                   |
-| --------------------- | ------------------------------------------------------------------------------- | --------------------------------------------- |
-| `dataset.collections` | [Listing collections](/api-reference/tilebox.datasets/Dataset.collections)      | List all available collections for a dataset. |
-| `dataset.collection`  | [Accessing a collection](/api-reference/tilebox.datasets/Dataset.collection)    | Access an individual collection by its name.  |
-| `collection.info`     | [Collection information](/api-reference/tilebox.datasets/Collection.info)       | Request information about a collection.       |
+| Method                             | API Reference                                                                                          | Description                                      |
+| ---------------------------------- | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------ |
+| `dataset.collections`              | [Listing collections](/api-reference/tilebox.datasets/Dataset.collections)                             | List all available collections for a dataset.    |
+| `dataset.create_collection`        | [Creating a collection](/api-reference/tilebox.datasets/Dataset.create_collection)                     | Create a collection in a dataset.                |
+| `dataset.get_or_create_collection` | [Accessing or creating a collection](/api-reference/tilebox.datasets/Dataset.get_or_create_collection) | Get a collection, create it if it doesn't exist. |
+| `dataset.collection`               | [Accessing a collection](/api-reference/tilebox.datasets/Dataset.collection)                           | Access an individual collection by its name.     |
+| `collection.info`                  | [Collection information](/api-reference/tilebox.datasets/Collection.info)                              | Request information about a collection.          |
 
 Refer to the examples below for common use cases when working with collections. These examples assume that you have already [created a client](/datasets/introduction#creating-a-datasets-client) and [listed the available datasets](/api-reference/tilebox.datasets/Client.datasets).
 
@@ -48,6 +50,24 @@ print(collections)
 
 [dataset.collections](/api-reference/tilebox.datasets/Dataset.collections) returns a dictionary mapping collection names to their corresponding collection objects. Each collection has a unique name within its dataset.
 
+## Creating collections
+
+To create a collection in a dataset, use [dataset.create_collection()](/api-reference/tilebox.datasets/Dataset.create_collection). This method returns the created collection object.
+
+<CodeGroup>
+```python Python
+collection = dataset.create_collection("My-collection")
+```
+</CodeGroup>
+
+Alternatively, you can use [dataset.get_or_create_collection()](/api-reference/tilebox.datasets/Dataset.get_or_create_collection) to get a collection by its name. If the collection does not exist, it will be created.
+
+<CodeGroup>
+```python Python
+collection = dataset.get_or_create_collection("My-collection")
+```
+</CodeGroup>
+
 ## Accessing individual collections
 
 Once you have listed the collections for a dataset using [dataset.collections()](/api-reference/tilebox.datasets/Dataset.collections), you can access a specific collection by retrieving it from the resulting dictionary with its name. Use [collection.info()](/api-reference/tilebox.datasets/Collection.info) to get details (name, availability, and count) about it.

mint.json

@@ -158,6 +158,8 @@
         "api-reference/tilebox.datasets/Client.datasets",
         "api-reference/tilebox.datasets/Client.dataset",
         "api-reference/tilebox.datasets/Dataset.collections",
+        "api-reference/tilebox.datasets/Dataset.create_collection",
+        "api-reference/tilebox.datasets/Dataset.get_or_create_collection",
         "api-reference/tilebox.datasets/Dataset.collection",
         "api-reference/tilebox.datasets/Collection.info",
         "api-reference/tilebox.datasets/Collection.load",