> ## Documentation Index
> Fetch the complete documentation index at: https://docs.encord.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Label Validation Collections

Collections are saved groups of data units or labels that let you curate subsets of your data and perform bulk actions on them, such as sending items to annotation, running bulk classifications, or exporting a curated Dataset.

## Filter Presets

Filter presets are saved groups of filter criteria that you can reuse across Label Validation.

### Create Filter Preset

Create a Filter Preset based on raw JSON.

<CodeGroup>
  ```python Template theme={"dark"}

  # Import dependencies
  from encord import EncordUserClient

  from encord.orm.filter_preset import ActiveFilterPresetDefinition, FilterDefinition
  from encord.orm.filter_preset import FilterPreset as OrmFilterPreset

  SSH_PATH = "<file-path-to-ssh-key>"
  PROJECT_ID = "<project-unique-id>"

  # Initialize the user client
  user_client = EncordUserClient.create_with_ssh_private_key(
      ssh_private_key_path=SSH_PATH
  )

  # Get project
  project = user_client.get_project(PROJECT_ID)


  # Define the filter preset structure

  # Create a preset with the defined filter preset
  preset = project.create_filter_preset(
      name="<name-for-your-preset>",
      filter_preset= ActiveFilterPresetDefinition(global_filters=FilterDefinition(
          filters= [{'key':'<key-name>',
          'include':True or False,
          'values' : [<filter-values>],
          'type': '<client-metadata-type'}]
      )
   ))

  # Output the result
  print(f"Preset created with UUID: {preset.uuid}")
  print("Preset contents: ", preset.get_filter_preset_json())

  ```

  ```python Example theme={"dark"}

  # Import dependencies
  from encord import EncordUserClient

  from encord.orm.filter_preset import ActiveFilterPresetDefinition, FilterDefinition
  from encord.orm.filter_preset import FilterPreset as OrmFilterPreset

  SSH_PATH = "/Users/chris-encord/sdk-ssh-private-key.txt"
  PROJECT_ID = "2dd135b6-0ab2-49b1-9b38-b5c685107790"

  # Initialize the user client
  user_client = EncordUserClient.create_with_ssh_private_key(
      ssh_private_key_path=SSH_PATH
  )

  # Get project
  project = user_client.get_project(PROJECT_ID)


  # Define the filter preset structure

  # Create a preset with the defined filter preset
  preset = project.create_filter_preset(
      name="Cherries and Apples",
      filter_preset= ActiveFilterPresetDefinition(global_filters=FilterDefinition(
          filters= [{'key':'Fruit',
          'include':True,
          'values' : ['Cherries', 'Apples'],
          'type': 'client_meta_enum'}]
      )
    )
   )

  # Output the result
  print(f"Preset created with UUID: {preset.uuid}")
  print("Preset contents: ", preset.get_filter_preset_json())

  ```
</CodeGroup>

### Update Filter Presets

<Note>All arguments are optional when updating a filter preset.</Note>

<CodeGroup>
  ```python Template theme={"dark"}

  # Import dependencies
  from encord import EncordUserClient

  from encord.orm.filter_preset import ActiveFilterPresetDefinition, FilterDefinition
  from encord.orm.filter_preset import FilterPreset as OrmFilterPreset

  SSH_PATH = "<file-path-to-ssh-key>"
  PROJECT_ID = "<project-unique-id>"
  PRESET_ID = "<preset-unique-id>"

  # Initialize the user client
  user_client = EncordUserClient.create_with_ssh_private_key(
      ssh_private_key_path=SSH_PATH
  )

  # Get project
  project = user_client.get_project(PROJECT_ID)

  # Create a preset with the defined filter preset
  preset = project.get_filter_preset(filter_preset_uuid=PRESET_ID)
  preset.update_preset(
      name="<updated-preset-name>",
      filter_preset= ActiveFilterPresetDefinition(global_filters=FilterDefinition(
          filters= [{'key':'<key-name>',
          'include':True or False,
          'values' : [<filter-values>],
          'type': '<client-metadata-type>'}]
      )
    )
   )

  # Output the result
  print(f"Updated Preset with UUID: {preset.uuid}")


  ```

  ```python Example theme={"dark"}

  # Import dependencies
  from encord import EncordUserClient

  from encord.orm.filter_preset import ActiveFilterPresetDefinition, FilterDefinition
  from encord.orm.filter_preset import FilterPreset as OrmFilterPreset

  SSH_PATH = "/Users/chris-encord/sdk-ssh-private-key.txt"
  PROJECT_ID = "2dd135b6-0ab2-49b1-9b38-b5c685107790"
  PRESET_ID = "b19d1b00-25e4-467c-acf0-c930e0b74ee1"

  # Initialize the user client
  user_client = EncordUserClient.create_with_ssh_private_key(
      ssh_private_key_path=SSH_PATH
  )

  # Get project
  project = user_client.get_project(PROJECT_ID)

  # Define the filter preset structure (with only global_filters, no local_filters)

  # Create a preset with the defined filter preset
  preset = project.get_filter_preset(filter_preset_uuid=PRESET_ID)
  preset.update_preset(
      name="Cherries, Apples, Blueberries",
      filter_preset= ActiveFilterPresetDefinition(global_filters=FilterDefinition(
          filters= [{'key':'Fruit',
          'include':True,
          'values' : ['Cherries', 'Blueberries', 'Apples'],
          'type': 'client_meta_enum'}]
      )
    )
  )

  # Output the result
  print(f"Updated Preset with UUID: {preset.uuid}")

  ```
</CodeGroup>

### List Filter Presets

List all Filter Presets in Active by name with their unique identifier.

<CodeGroup>
  ```python Template theme={"dark"}

  # Import dependencies
  from encord import EncordUserClient

  SSH_PATH = "file-path-to-ssh-private-key"
  PROJECT_ID = "<project_hash>"

  user_client: EncordUserClient = EncordUserClient.create_with_ssh_private_key(
      ssh_private_key_path=SSH_PATH
  )

  # Get project
  project = user_client.get_project(PROJECT_ID)

  # Get Preset Filters for the project
  presets = project.list_filter_presets()

  # List Preset Filters by name and UUID
  for preset in presets:
      print(preset.name, preset.uuid)

  ```

  ```python Example theme={"dark"}
  # Import dependencies
  from encord import EncordUserClient

  SSH_PATH = "/Users/chris-encord/sdk-ssh-private-key.txt"
  PROJECT_ID = "5fdb3d88-b88c-4a00-8aa9-e7e836024cdd"


  user_client: EncordUserClient = EncordUserClient.create_with_ssh_private_key(
      ssh_private_key_path=SSH_PATH
  )

  # Get project
  project = user_client.get_project(PROJECT_ID)

  # Get Preset Filters for the project
  presets = project.list_filter_presets()

  # List Preset Filters by name and UUID
  for preset in presets:
      print(preset.name, preset.uuid)

  ```
</CodeGroup>

### Delete Presets

Use the following code template to delete a preset filter in Active.

```python Template theme={"dark"}

# Import dependencies
from encord import EncordUserClient

SSH_PATH = "file-path-to-ssh-private-key"
PROJECT_ID = "<project-unique-id>"

# Preset ID to delete
PRESET_ID = "unique-preset-filter-id"  

user_client: EncordUserClient = EncordUserClient.create_with_ssh_private_key(
    ssh_private_key_path=SSH_PATH
)

# Get project
project = user_client.get_project(PROJECT_ID)

# Delete Preset Filter
project.delete_filter_preset(PRESET_ID)

```

### View Preset JSON

This code outputs the filters that make up the Active filter preset in a JSON file format.

<CodeGroup>
  ```python Template theme={"dark"}
  # Import dependencies
  from encord import EncordUserClient

  from encord.orm.filter_preset import FilterPreset as OrmFilterPreset

  SSH_PATH = "<file-path-to-ssh-private-key>"
  PROJECT_ID = "<project-unique-id>"
  PRESET_ID = "<uuid-of-the-preset-filter>"

  user_client: EncordUserClient = EncordUserClient.create_with_ssh_private_key(
      ssh_private_key_path=SSH_PATH
  )

  # Get project
  project = user_client.get_project(PROJECT_ID)

  # Get filter preset and return the JSON representation
  filter_preset_json = project.get_filter_preset(filter_preset_uuid=PRESET_ID).get_filter_preset_json()

  # Output the result
  print("\nFormatted Output:\n")
  print(filter_preset_json)

  ```

  ```python Example theme={"dark"}
  # Import dependencies
  from encord import EncordUserClient

  from encord.orm.filter_preset import FilterPreset as OrmFilterPreset

  SSH_PATH = "/Users/chris-encord/ssh-private-key.txt"
  PRESET_ID = "fc8c2d43-d7d5-4f40-a3e4-1bebb7b71d2f"

  user_client: EncordUserClient = EncordUserClient.create_with_ssh_private_key(
      ssh_private_key_path=SSH_PATH
  )

  # Get project
  project = user_client.get_project(PROJECT_ID)

  # Get filter preset and return the JSON representation
  filter_preset_json = project.get_filter_preset(filter_preset_uuid=PRESET_ID).get_filter_preset_json()

  # Output the result
  print("\nFormatted Output:\n")
  print(filter_preset_json)

  ```
</CodeGroup>

***

## Collections

Active supports two types of Collections: Frame Collections and Label Collections.

Frame Collections are groups of frames (images and video frames) you selected by filtering, sorting, inspecting, and analyzing the data units in Active.

Label Collections are groups of labels, on your frames (images and video frames), that you selected by filtering, sorting, inspecting, and analyzing the labels on your data units in Active.

### List Collections

List all Collections in an Active Project by name with their unique identifier.

<CodeGroup>
  ```python Template List ALL Collections theme={"dark"}

  from encord import EncordUserClient
  from encord.objects.coordinates import BoundingBoxCoordinates
  from encord.orm.collection import ProjectCollectionType, ProjectDataCollectionItemRequest, ProjectLabelCollectionItemRequest, ProjectCollectionBulkItemResponse

  SSH_PATH = "<file-path-to-ssh-private-key>"

  PROJECT_ID = "<unique-annotate-project-id>"

  user_client = EncordUserClient.create_with_ssh_private_key(
      ssh_private_key_path=SSH_PATH
  )

  project = user_client.get_project(PROJECT_ID)

  print(project.title)

  collections = project.list_collections()
  for collection in collections:
      print(collection.name, collection.collection_type, collection.uuid)

  ```

  ```python Example List ALL Collections theme={"dark"}

  from encord import EncordUserClient
  from encord.objects.coordinates import BoundingBoxCoordinates
  from encord.orm.collection import ProjectCollectionType, ProjectDataCollectionItemRequest, ProjectLabelCollectionItemRequest, ProjectCollectionBulkItemResponse

  SSH_PATH = "/Users/chris-encord/sdk-ssh-private-key.txt"

  PROJECT_ID = "5fdb3d88-b88c-4a00-8aa9-e7e836024cdd"

  user_client = EncordUserClient.create_with_ssh_private_key(
      ssh_private_key_path=SSH_PATH
  )

  project = user_client.get_project(PROJECT_ID)

  print(project.title)

  collections = project.list_collections()
  for collection in collections:
      print(collection.name, collection.collection_type, collection.uuid)

  ```
</CodeGroup>

### List FRAME Collections

List all **FRAME** Collections in an Active Project by name with their unique identifier.

<CodeGroup>
  ```python Template List FRAME Collections theme={"dark"}

  from encord import EncordUserClient
  from encord.objects.coordinates import BoundingBoxCoordinates
  from encord.orm.collection import ProjectCollectionType, ProjectDataCollectionItemRequest, ProjectLabelCollectionItemRequest, ProjectCollectionBulkItemResponse

  SSH_PATH = "<file-path-to-ssh-private-key>"

  PROJECT_ID = "<unique-annotate-project-id>"

  user_client = EncordUserClient.create_with_ssh_private_key(
      ssh_private_key_path=SSH_PATH
  )

  project = user_client.get_project(PROJECT_ID)

  print(project.title)

  collections = project.list_collections()

  for collection in collections:
      # Check if the collection type is 'FRAME'
      if collection.collection_type == ProjectCollectionType.FRAME:
          print(collection.name, collection.collection_type, collection.uuid)

  ```

  ```python Example List FRAME Collections theme={"dark"}

  from encord import EncordUserClient
  from encord.objects.coordinates import BoundingBoxCoordinates
  from encord.orm.collection import ProjectCollectionType, ProjectDataCollectionItemRequest, ProjectLabelCollectionItemRequest, ProjectCollectionBulkItemResponse

  SSH_PATH = "/Users/chris-encord/sdk-ssh-private-key.txt"

  PROJECT_ID = "5fdb3d88-b88c-4a00-8aa9-e7e836024cdd"

  user_client = EncordUserClient.create_with_ssh_private_key(
      ssh_private_key_path=SSH_PATH
  )

  project = user_client.get_project(PROJECT_ID)

  print(project.title)

  collections = project.list_collections()

  for collection in collections:
      # Check if the collection type is 'FRAME'
      if collection.collection_type == ProjectCollectionType.FRAME:
          print(collection.name, collection.collection_type, collection.uuid)

  ```
</CodeGroup>

### List LABEL Collections

List all **LABEL** Collections in an Active Project by name with their unique identifier.

<CodeGroup>
  ```python Template List LABEL Collections theme={"dark"}

  from encord import EncordUserClient
  from encord.objects.coordinates import BoundingBoxCoordinates
  from encord.orm.collection import ProjectCollectionType, ProjectDataCollectionItemRequest, ProjectLabelCollectionItemRequest, ProjectCollectionBulkItemResponse

  SSH_PATH = "<file-path-to-ssh-private-key>"

  PROJECT_ID = "<unique-annotate-project-id>"

  user_client = EncordUserClient.create_with_ssh_private_key(
      ssh_private_key_path=SSH_PATH
  )

  pproject = user_client.get_project(PROJECT_ID)

  print(project.title)

  collections = project.list_collections()

  # Specify LABEL Collections
  if collection.collection_type == ProjectCollectionType.LABEL:
          print(collection.name, collection.collection_type, collection.uuid)

  ```

  ```python Example List LABEL Collections theme={"dark"}

  from encord import EncordUserClient
  from encord.objects.coordinates import BoundingBoxCoordinates
  from encord.orm.collection import ProjectCollectionType, ProjectDataCollectionItemRequest, ProjectLabelCollectionItemRequest, ProjectCollectionBulkItemResponse

  SSH_PATH = "/Users/chris-encord/sdk-ssh-private-key.txt"

  PROJECT_ID = "5fdb3d88-b88c-4a00-8aa9-e7e836024cdd"

  user_client = EncordUserClient.create_with_ssh_private_key(
      ssh_private_key_path=SSH_PATH
  )

  project = user_client.get_project(PROJECT_ID)

  print(project.title)

  collections = project.list_collections()

  # Specify LABEL Collections
  if collection.collection_type == ProjectCollectionType.LABEL:
          print(collection.name, collection.collection_type, collection.uuid)

  ```
</CodeGroup>

### Create Collection

Create a Collection with a meaningful name and description in a Folder.

<CodeGroup>
  ```python Template theme={"dark"}
  from encord import EncordUserClient
  from encord.objects.coordinates import BoundingBoxCoordinates
  from encord.orm.collection import ProjectCollectionType, ProjectDataCollectionItemRequest, ProjectLabelCollectionItemRequest

  SSH_PATH = "<file-path-to-ssh-private-key>"

  PROJECT_ID = "<unique-annotate-project-id>"

  user_client = EncordUserClient.create_with_ssh_private_key(
      ssh_private_key_path=SSH_PATH
  )

  project = user_client.get_project(PROJECT_ID)

  collection = project.create_collection(name="Test Collection 1", description="A useful and meaningful description for the Collection.", collection_type= "<FRAME-or-LABEL>")

  print(collection)
  ```

  ```python Create FRAME Collection theme={"dark"}

  from encord import EncordUserClient
  from encord.objects.coordinates import BoundingBoxCoordinates
  from encord.orm.collection import ProjectCollectionType, ProjectDataCollectionItemRequest, ProjectLabelCollectionItemRequest

  SSH_PATH = "/Users/chris-encord/sdk-ssh-private-key.txt"

  PROJECT_ID = "5fdb3d88-b88c-4a00-8aa9-e7e836024cdd"

  user_client = EncordUserClient.create_with_ssh_private_key(
      ssh_private_key_path=SSH_PATH
  )

  project = user_client.get_project(PROJECT_ID)

  collection = project.create_collection(name="FRAME Collection 1", description="A useful and meaningful description for the Collection.", collection_type= "FRAME")

  print(collection)

  ```

  ```python Create LABEL Collection theme={"dark"}

  from encord import EncordUserClient
  from encord.objects.coordinates import BoundingBoxCoordinates
  from encord.orm.collection import ProjectCollectionType, ProjectDataCollectionItemRequest, ProjectLabelCollectionItemRequest

  SSH_PATH = "/Users/chris-encord/sdk-ssh-private-key.txt"

  PROJECT_ID = "5fdb3d88-b88c-4a00-8aa9-e7e836024cdd"

  user_client = EncordUserClient.create_with_ssh_private_key(
      ssh_private_key_path=SSH_PATH
  )

  project = user_client.get_project(PROJECT_ID)

  collection = project.create_collection(name="LABEL Collection 1", description="A useful and meaningful description for the Collection.", collection_type= "LABEL")

  print(collection)

  ```
</CodeGroup>

### Add Items to a Collection

You need the data hash of the data units in your Annotate Project to add the data units to an Active Collection.

<AccordionGroup>
  <Accordion title="Get Data ID">
    #### Get Data ID

    Use the following code to get the Data ID (unique ID for data units from Dataset) from your Annotate Project:

    <CodeGroup>
      ```python Template Get Data ID  theme={"dark"}

      # Import dependencies
      from encord import EncordUserClient

      SSH_PATH = "<file-path-to-ssh-private-key>"

      PROJECT_ID = "<project-unique-id>"

      user_client = EncordUserClient.create_with_ssh_private_key(
          ssh_private_key_path=SSH_PATH
      )


      # Specify Project. Replace <project_hash> with the hash of your Project.
      project = user_client.get_project(PROJECT_ID)

      # Get label rows for your Project
      label_rows = project.list_label_rows_v2()

      # Iterate through label rows and print data hashes and titles
      for label_row in label_rows:
          print(f"Data hash: {label_row.data_hash}")
          print(f"Data title: {label_row.data_title}")
          print("---")  # Separator for readability

      ```

      ```python Example Get Data ID theme={"dark"}

      # Import dependencies
      from encord import EncordUserClient

      SSH_PATH = "/Users/chris-encord/sdk-ssh-private-key.txt"

      PROJECT_ID = "2dd135b6-0ab2-49b1-9b38-b5c685107790"

      user_client = EncordUserClient.create_with_ssh_private_key(
          ssh_private_key_path=SSH_PATH
      )


      # Specify Project. Replace <project_hash> with the hash of your Project.
      project = user_client.get_project(PROJECT_ID)

      # Get label rows for your Project
      label_rows = project.list_label_rows_v2()

      # Iterate through label rows and print data hashes and titles
      for label_row in label_rows:
          print(f"Data hash: {label_row.data_hash}")
          print(f"Data title: {label_row.data_title}")
          print("---")  # Separator for readability

      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="Get Annotation ID">
    #### Get Annotation ID

    You need the Data ID, frame number, AND the Annotation ID (Object Hash) for the label or classification you want to add to the LABEL Collection.

    The following code gets the Annotation ID for all the labels in an Annotate Project

    <CodeGroup>
      ```python Template Get Annotation ID  theme={"dark"}

      # Import dependencies
      from encord import EncordUserClient

      SSH_PATH = "<file-path-to-ssh-private-key>"

      PROJECT_ID = "<project-unique-id>"

      user_client = EncordUserClient.create_with_ssh_private_key(
          ssh_private_key_path=SSH_PATH
      )


      # Specify Project. Replace <project_hash> with the hash of your Project.
      project = user_client.get_project(PROJECT_ID)

      # Get label rows for your Project
      label_rows = project.list_label_rows_v2()

      # Iterate through label rows and print data hashes, titles, and label hashes
      for label_row in label_rows:
          print(f"Data hash: {label_row.data_hash}")
          print(f"Data title: {label_row.data_title}")
          print(f"Label hash: {label_row.data_hash}")
          print("---")  # Separator for readability

      ```

      ```python Example Get Annotation ID theme={"dark"}

      # Import dependencies
      from encord import EncordUserClient

      SSH_PATH = "/Users/chris-encord/sdk-ssh-private-key.txt"

      PROJECT_ID = "2dd135b6-0ab2-49b1-9b38-b5c685107790"

      user_client = EncordUserClient.create_with_ssh_private_key(
          ssh_private_key_path=SSH_PATH
      )


      # Specify Project. Replace <project_hash> with the hash of your Project.
      project = user_client.get_project(PROJECT_ID)

      # Get label rows for your Project
      label_rows = project.list_label_rows_v2()

      # Iterate through label rows and print data hashes, titles, and label hashes
      for label_row in label_rows:
          print(f"Data hash: {label_row.data_hash}")
          print(f"Data title: {label_row.data_title}")
          print(f"Label hash: {label_row.data_hash}")
          print("---")  # Separator for readability

      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="Add Items to FRAMES Collection">
    #### Add Items to FRAMES Collection

    You need the Data ID and frame number of the frames you want to add to a Collection.

    <CodeGroup>
      ```python Template FRAMES theme={"dark"}

      # Import dependencies
      from encord import EncordUserClient
      from encord.collection import ProjectCollection
      from encord.orm.filter_preset import FilterPreset
      from encord.objects.coordinates import BoundingBoxCoordinates
      from encord.orm.collection import ProjectCollectionType, ProjectDataCollectionItemRequest, ProjectLabelCollectionItemRequest


      # Define constants
      SSH_PATH = "<file-path-to-ssh-private-key>"

      PROJECT_ID = "<project-unique-id>"

      COLLECTION_ID = "<collection-unique-id>"

      # Initialize the user client using the SSH private key
      user_client = EncordUserClient.create_with_ssh_private_key(
          ssh_private_key_path=SSH_PATH
      )

      # Fetch the specific Project by ID
      project = user_client.get_project(PROJECT_ID)


      # Fetch the specific collection by hash
      collection = project.get_collection(COLLECTION_ID)

      # Add items to the collection and capture the response
      response = collection.add_items([ProjectDataCollectionItemRequest(data_uuid="<data-unique-id>", frame=<frame-number>)])

      # Print the success message
      print(f"Added items to collection {COLLECTION_ID}.")

      # Check if there were any failed items
      if isinstance(response, ProjectCollectionBulkItemResponse):
          failed_items = response.failed_items
          if failed_items:
              print("The following items failed to be added to the collection:")
              for failed_item in failed_items:
                  # Assuming failed_item is an instance of either ProjectDataCollectionItemRequest or ProjectLabelCollectionItemRequest
                  print(f"Failed item: {failed_item}")
          else:
              print("All items were added successfully.")
      else:
          print("Unexpected response format.")

      ```

      ```python Example FRAME theme={"dark"}

      # Import dependencies
      from encord import EncordUserClient
      from encord.collection import ProjectCollection
      from encord.orm.filter_preset import FilterPreset
      from encord.objects.coordinates import BoundingBoxCoordinates
      from encord.orm.collection import ProjectCollectionType, ProjectDataCollectionItemRequest, ProjectLabelCollectionItemRequest, ProjectCollectionBulkItemResponse

      # Define constants
      SSH_PATH = "/Users/chris-encord/sdk-ssh-private-key.txt"
      PROJECT_ID = "2dd135b6-0ab2-49b1-9b38-b5c685107790"
      COLLECTION_ID = "76863c3b-533d-4e67-a09b-ccc81d933674"

      # Initialize the user client using the SSH private key
      user_client = EncordUserClient.create_with_ssh_private_key(
          ssh_private_key_path=SSH_PATH
      )

      # Fetch the project
      project = user_client.get_project(PROJECT_ID)

      # Fetch the specific collection by hash
      collection = project.get_collection(COLLECTION_ID)

      # Add items to the collection and capture the response
      response = collection.add_items([ProjectDataCollectionItemRequest(data_uuid="08a38705-0497-4e28-9c0e-d10f1ad150fa", frame=0)])

      # Print the success message
      print(f"Added items to collection {COLLECTION_ID}.")

      # Check if there were any failed items
      if isinstance(response, ProjectCollectionBulkItemResponse):
          failed_items = response.failed_items
          if failed_items:
              print("The following items failed to be added to the collection:")
              for failed_item in failed_items:
                  # Assuming failed_item is an instance of either ProjectDataCollectionItemRequest or ProjectLabelCollectionItemRequest
                  print(f"Failed item: {failed_item}")
          else:
              print("All items were added successfully.")
      else:
          print("Unexpected response format.")


      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="Add items to LABEL Collection">
    #### Add Items to LABEL Collection

    You need the Data ID, frame number, AND the Annotation ID to add items to a LABEL Collection.

    <CodeGroup>
      ```python Template LABEL theme={"dark"}

      # Import dependencies
      from encord import EncordUserClient
      from encord.collection import ProjectCollection
      from encord.orm.filter_preset import FilterPreset
      from encord.objects.coordinates import BoundingBoxCoordinates
      from encord.orm.collection import ProjectCollectionType, ProjectDataCollectionItemRequest, ProjectLabelCollectionItemRequest


      # Define constants
      SSH_PATH = "<file-path-to-ssh-private-key>"

      PROJECT_ID = "<project-unique-id>"

      COLLECTION_ID = "<collection-unique-id>"

      # Initialize the user client using the SSH private key
      user_client = EncordUserClient.create_with_ssh_private_key(
          ssh_private_key_path=SSH_PATH
      )


      # Fetch the specified Project by ID
      project = user_client.get_project(PROJECT_ID)


      # Fetch the specific Collection by ID
      collection = project.get_collection(COLLECTION_ID)


      # Add items to the collection and capture the response
      response = collection.add_items([ProjectLabelCollectionItemRequest(data_uuid="<data-unique-id>", frame=<frame-number>, annotation_id="<annotation-unique-id>")])

      # Print the success message
      print(f"Added items to collection {COLLECTION_ID}.")

      # Check if there were any failed items
      if isinstance(response, ProjectCollectionBulkItemResponse):
          failed_items = response.failed_items
          if failed_items:
              print("The following items failed to be added to the collection:")
              for failed_item in failed_items:
                  # Assuming failed_item is an instance of ProjectLabelCollectionItemRequest
                  print(f"Failed item: {failed_item}")
          else:
              print("All items were added successfully.")
      else:
          print("Unexpected response format.")

      ```

      ```python Example LABEL theme={"dark"}

      # Import dependencies
      from encord import EncordUserClient
      from encord.collection import ProjectCollection
      from encord.orm.filter_preset import FilterPreset
      from encord.objects.coordinates import BoundingBoxCoordinates
      from encord.orm.collection import ProjectCollectionType, ProjectDataCollectionItemRequest, ProjectLabelCollectionItemRequest, ProjectCollectionBulkItemResponse


      # Define constants
      SSH_PATH = "/Users/chris-encord/sdk-ssh-private-key.txt"
      PROJECT_ID = "2dd135b6-0ab2-49b1-9b38-b5c685107790"
      COLLECTION_ID = "578b343b-ecb1-4948-b203-f1446fb9ceab"

      # Initialize the user client using the SSH private key
      user_client = EncordUserClient.create_with_ssh_private_key(
          ssh_private_key_path=SSH_PATH
      )

      # Fetch the specified Project by ID
      project = user_client.get_project(PROJECT_ID)

      # Fetch the specific Collection by ID
      collection = project.get_collection(COLLECTION_ID)

      # Add items to the collection and capture the response
      response = collection.add_items([ProjectLabelCollectionItemRequest(data_uuid="7be6cfcf-e2d4-494f-98f5-91e5ef1c8d1b", frame=435, annotation_id="4kybTAWK")])

      # Print the success message
      print(f"Added items to collection {COLLECTION_ID}.")

      # Check if there were any failed items
      if isinstance(response, ProjectCollectionBulkItemResponse):
          failed_items = response.failed_items
          if failed_items:
              print("The following items failed to be added to the collection:")
              for failed_item in failed_items:
                  # Assuming failed_item is an instance of ProjectLabelCollectionItemRequest
                  print(f"Failed item: {failed_item}")
          else:
              print("All items were added successfully.")
      else:
          print("Unexpected response format.")


      ```
    </CodeGroup>
  </Accordion>
</AccordionGroup>

### Add Items to a Collection using Presets

The code to add items to a Frame Collection or a Label Collection is the same.

You can find the Preset ID for your preset in the Active UI.

![Get Preset ID](https://storage.googleapis.com/docs-media.encord.com/static/img/active/active-get-preset-id.gif)

<CodeGroup>
  ```python Template theme={"dark"}

  # Import dependencies
  from encord import EncordUserClient
  from encord.collection import ProjectCollection
  from encord.orm.filter_preset import FilterPreset
  from encord.objects.coordinates import BoundingBoxCoordinates
  from encord.orm.collection import ProjectCollectionType, ProjectDataCollectionItemRequest, ProjectLabelCollectionItemRequest


  # Define constants
  SSH_PATH = "<file-path-to-ssh-private-key>"

  PROJECT_ID = "<project-unique-id>"

  COLLECTION_ID = "<collection-unique-id>"

  PRESET_ID = "<preset-unique-id>"

  # Initialize the user client using the SSH private key
  user_client = EncordUserClient.create_with_ssh_private_key(
      ssh_private_key_path=SSH_PATH
  )

  # Fetch the specific Project by ID
  project = user_client.get_project(PROJECT_ID)


  # Fetch the specific Collection by ID
  collection = project.get_collection(COLLECTION_ID)


  collection.add_preset_items(PRESET_ID)

  print(f"Added items to collection {COLLECTION_ID}.")


  ```

  ```python Example theme={"dark"}

  # Import dependencies
  from encord import EncordUserClient
  from encord.collection import ProjectCollection
  from encord.orm.filter_preset import FilterPreset
  from encord.objects.coordinates import BoundingBoxCoordinates
  from encord.orm.collection import ProjectCollectionType, ProjectDataCollectionItemRequest, ProjectLabelCollectionItemRequest


  # Define constants
  SSH_PATH = "/Users/chris-encord/sdk-ssh-private-key.txt"

  PROJECT_ID = "2dd135b6-0ab2-49b1-9b38-b5c685107790"

  COLLECTION_ID = "fdc0775e-2694-4191-946e-c3364d00fdc3"

  PRESET_ID = "65eb2e39-c7a4-4aae-bdc6-cce00efdfedf"

  # Initialize the user client using the SSH private key
  user_client = EncordUserClient.create_with_ssh_private_key(
      ssh_private_key_path=SSH_PATH
  )

  # Fetch the specific Project by ID
  project = user_client.get_project(PROJECT_ID)


  # Fetch the specific Collection by ID
  collection = project.get_collection(COLLECTION_ID)


  collection.add_preset_items(PRESET_ID)

  print(f"Added items to collection {COLLECTION_ID}.")


  ```
</CodeGroup>

### Remove Items from a Collection

Remove items from a Frame or Label Collection.

<AccordionGroup>
  <Accordion title="Get Data ID">
    #### Get Data ID

    Use the following code to get the Data ID (unique ID for data units from Dataset) from your Annotate Project:

    <CodeGroup>
      ```python Template Get Data ID  theme={"dark"}

      # Import dependencies
      from encord import EncordUserClient

      SSH_PATH = "<file-path-to-ssh-private-key>"

      PROJECT_ID = "<project-unique-id>"

      user_client = EncordUserClient.create_with_ssh_private_key(
          ssh_private_key_path=SSH_PATH
      )


      # Specify Project. Replace <project_hash> with the hash of your Project.
      project = user_client.get_project(PROJECT_ID)

      # Get label rows for your Project
      label_rows = project.list_label_rows_v2()

      # Iterate through label rows and print data hashes and titles
      for label_row in label_rows:
          print(f"Data hash: {label_row.data_hash}")
          print(f"Data title: {label_row.data_title}")
          print("---")  # Separator for readability

      ```

      ```python Example Get Data ID theme={"dark"}

      # Import dependencies
      from encord import EncordUserClient

      SSH_PATH = "/Users/chris-encord/sdk-ssh-private-key.txt"

      PROJECT_ID = "2dd135b6-0ab2-49b1-9b38-b5c685107790"

      user_client = EncordUserClient.create_with_ssh_private_key(
          ssh_private_key_path=SSH_PATH
      )


      # Specify Project. Replace <project_hash> with the hash of your Project.
      project = user_client.get_project(PROJECT_ID)

      # Get label rows for your Project
      label_rows = project.list_label_rows_v2()

      # Iterate through label rows and print data hashes and titles
      for label_row in label_rows:
          print(f"Data hash: {label_row.data_hash}")
          print(f"Data title: {label_row.data_title}")
          print("---")  # Separator for readability

      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="Get Annotation ID">
    #### Get Annotation ID

    You need the Data ID AND the Annotation ID (Object Hash) for the label or classification you want to remove from the LABEL Collection.

    The following code gets the Annotation ID for all the labels in an Annotate Project

    <CodeGroup>
      ```python Template Get Annotation ID  theme={"dark"}

      # Import dependencies
      from encord import EncordUserClient

      SSH_PATH = "<file-path-to-ssh-private-key>"

      PROJECT_ID = "<project-unique-id>"

      user_client = EncordUserClient.create_with_ssh_private_key(
          ssh_private_key_path=SSH_PATH
      )


      # Specify Project. Replace <project_hash> with the hash of your Project.
      project = user_client.get_project(PROJECT_ID)

      # Get label rows for your Project
      label_rows = project.list_label_rows_v2()

      # Iterate through label rows and print data hashes and titles
      for label_row in label_rows:
          print(f"Data hash: {label_row.data_hash}")
          print(f"Data title: {label_row.data_title}")
          print("---")  # Separator for readability

      ```

      ```python Example Get Annotation ID theme={"dark"}

      # Import dependencies
      from encord import EncordUserClient

      SSH_PATH = "/Users/chris-encord/sdk-ssh-private-key.txt"

      PROJECT_ID = "2dd135b6-0ab2-49b1-9b38-b5c685107790"

      user_client = EncordUserClient.create_with_ssh_private_key(
          ssh_private_key_path=SSH_PATH
      )


      # Specify Project. Replace <project_hash> with the hash of your Project.
      project = user_client.get_project(PROJECT_ID)

      # Get label rows for your Project
      label_rows = project.list_label_rows_v2()

      # Iterate through label rows and print data hashes and titles
      for label_row in label_rows:
          print(f"Data hash: {label_row.data_hash}")
          print(f"Data title: {label_row.data_title}")
          print("---")  # Separator for readability

      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="Remove Items from FRAME Collections">
    #### Remove Items from FRAME Collections

    You need the Data ID of frames to remove items from a FRAME Collection.

    <CodeGroup>
      ```python Template FRAMES theme={"dark"}

      # Import dependencies
      from encord import EncordUserClient
      from encord.collection import ProjectCollection
      from encord.orm.filter_preset import FilterPreset
      from encord.objects.coordinates import BoundingBoxCoordinates
      from encord.orm.collection import ProjectCollectionType, ProjectDataCollectionItemRequest, ProjectLabelCollectionItemRequest


      # Define constants
      SSH_PATH = "<file-path-to-ssh-private-key>"

      PROJECT_ID = "<project-unique-id>"

      COLLECTION_ID = "<collection-unique-id>"

      # Initialize the user client using the SSH private key
      user_client = EncordUserClient.create_with_ssh_private_key(
          ssh_private_key_path=SSH_PATH
      )

      # Fetch the specific Project by ID
      project = user_client.get_project(PROJECT_ID)


      # Fetch the specific Collection by ID
      collection = project.get_collection(COLLECTION_ID)


      # Add images or video frames to a FRAMES Collection
      collection.remove_items([ProjectDataCollectionItemRequest(data_uuid="<data-unique-id>", frame=0)])

      print(f"Removed items to collection {COLLECTION_ID}.")


      ```

      ```python Example FRAME theme={"dark"}

      # Import dependencies
      from encord import EncordUserClient
      from encord.collection import ProjectCollection
      from encord.orm.filter_preset import FilterPreset
      from encord.objects.coordinates import BoundingBoxCoordinates
      from encord.orm.collection import ProjectCollectionType, ProjectDataCollectionItemRequest, ProjectLabelCollectionItemRequest


      # Define constants
      SSH_PATH = "/Users/chris-encord/sdk-ssh-private-key.txt"

      PROJECT_ID = "2dd135b6-0ab2-49b1-9b38-b5c685107790"

      COLLECTION_ID = "fdc0775e-2694-4191-946e-c3364d00fdc3"

      # Initialize the user client using the SSH private key
      user_client = EncordUserClient.create_with_ssh_private_key(
          ssh_private_key_path=SSH_PATH
      )

      # Fetch the specific Project by ID
      project = user_client.get_project(PROJECT_ID)


      # Fetch the specific Collection by ID
      collection = project.get_collection(COLLECTION_ID)


      collection.remove_items([ProjectDataCollectionItemRequest(data_uuid="08a38705-0497-4e28-9c0e-d10f1ad150fa", frame=0)])

      print(f"Removed items to collection {COLLECTION_ID}.")


      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="Remove Items from LABEL Collections">
    #### Remove Items from LABEL Collections

    You need the Data ID and Annotation ID to remove items from LABEL Collections.

    <CodeGroup>
      ```python Template LABEL theme={"dark"}

      # Import dependencies
      from encord import EncordUserClient
      from encord.collection import ProjectCollection
      from encord.orm.filter_preset import FilterPreset
      from encord.objects.coordinates import BoundingBoxCoordinates
      from encord.orm.collection import ProjectCollectionType, ProjectDataCollectionItemRequest, ProjectLabelCollectionItemRequest


      # Define constants
      SSH_PATH = "<file-path-to-ssh-private-key>"

      PROJECT_ID = "<project-unique-id>"

      COLLECTION_ID = "<collection-unique-id>"

      # Initialize the user client using the SSH private key
      user_client = EncordUserClient.create_with_ssh_private_key(
          ssh_private_key_path=SSH_PATH
      )


      # Fetch the specified Project by ID
      project = user_client.get_project(PROJECT_ID)


      # Fetch the specific Collection by ID
      collection = project.get_collection(COLLECTION_ID)


      collection.remove_items([ProjectLabelCollectionItemRequest(data_uuid="data-unique-id", frame=<frame-number>, annotation_id="<annotation-unique-id>")])

      print(f"Removed items to collection {COLLECTION_ID}.")

      ```

      ```python Example LABEL theme={"dark"}

      # Import dependencies
      from encord import EncordUserClient
      from encord.collection import ProjectCollection
      from encord.orm.filter_preset import FilterPreset
      from encord.objects.coordinates import BoundingBoxCoordinates
      from encord.orm.collection import ProjectCollectionType, ProjectDataCollectionItemRequest, ProjectLabelCollectionItemRequest


      # Define constants
      SSH_PATH = "/Users/chris-encord/sdk-ssh-private-key.txt"

      PROJECT_ID = "2dd135b6-0ab2-49b1-9b38-b5c685107790"

      COLLECTION_ID = "578b343b-ecb1-4948-b203-f1446fb9ceab"

      # Initialize the user client using the SSH private key
      user_client = EncordUserClient.create_with_ssh_private_key(
          ssh_private_key_path=SSH_PATH
      )


      # Fetch the specified Project by ID
      project = user_client.get_project(PROJECT_ID)


      # Fetch the specific Collection by ID
      collection = project.get_collection(COLLECTION_ID)


      collection.remove_items([ProjectLabelCollectionItemRequest(data_uuid="7be6cfcf-e2d4-494f-98f5-91e5ef1c8d1b", frame=435, annotation_id="4kybTAWK")])

      print(f"Removed items to collection {COLLECTION_ID}.")

      ```
    </CodeGroup>
  </Accordion>
</AccordionGroup>

### Remove Items From a Collection using Presets

The code to remove items from a Frame Collection or a Label Collection is the same.

You can find the Preset ID for your preset in the Active UI.

![Get Preset ID](https://storage.googleapis.com/docs-media.encord.com/static/img/active/active-get-preset-id.gif)

<CodeGroup>
  ```python Template theme={"dark"}

  # Import dependencies
  from encord import EncordUserClient
  from encord.collection import ProjectCollection
  from encord.orm.filter_preset import FilterPreset
  from encord.objects.coordinates import BoundingBoxCoordinates
  from encord.orm.collection import ProjectCollectionType, ProjectDataCollectionItemRequest, ProjectLabelCollectionItemRequest


  # Define constants
  SSH_PATH = "<file-path-to-ssh-private-key>"

  PROJECT_ID = "<project-unique-id>"

  COLLECTION_ID = "<collection-unique-id>"

  PRESET_ID = "<preset-unique-id>"

  # Initialize the user client using the SSH private key
  user_client = EncordUserClient.create_with_ssh_private_key(
      ssh_private_key_path=SSH_PATH
  )

  # Fetch the specific Project by ID
  project = user_client.get_project(PROJECT_ID)


  # Fetch the specific Collection by ID
  collection = project.get_collection(COLLECTION_ID)


  collection.remove_preset_items(PRESET_ID)

  print(f"Removed items from Collection {COLLECTION_ID}.")


  ```

  ```python Example theme={"dark"}

  # Import dependencies
  from encord import EncordUserClient
  from encord.collection import ProjectCollection
  from encord.orm.filter_preset import FilterPreset
  from encord.objects.coordinates import BoundingBoxCoordinates
  from encord.orm.collection import ProjectCollectionType, ProjectDataCollectionItemRequest, ProjectLabelCollectionItemRequest


  # Define constants
  SSH_PATH = "/Users/chris-encord/sdk-ssh-private-key.txt"

  PROJECT_ID = "2dd135b6-0ab2-49b1-9b38-b5c685107790"

  COLLECTION_ID = "fdc0775e-2694-4191-946e-c3364d00fdc3"

  PRESET_ID = "65eb2e39-c7a4-4aae-bdc6-cce00efdfedf"

  # Initialize the user client using the SSH private key
  user_client = EncordUserClient.create_with_ssh_private_key(
      ssh_private_key_path=SSH_PATH
  )

  # Fetch the specific Project by ID
  project = user_client.get_project(PROJECT_ID)


  # Fetch the specific Collection by ID
  collection = project.get_collection(COLLECTION_ID)


  collection.remove_preset_items(PRESET_ID)

  print(f"Removed items from Collection {COLLECTION_ID}.")


  ```
</CodeGroup>

### List all Items in a Collection

<AccordionGroup>
  <Accordion title="List All Frames in a Collection">
    #### List all Frames in a Collection

    Lists all FRAMES in a Collection.

    <CodeGroup>
      ```python Template theme={"dark"}

      # Import dependencies
      from encord import EncordUserClient
      from encord.collection import ProjectCollection
      from encord.orm.filter_preset import FilterPreset
      from encord.objects.coordinates import BoundingBoxCoordinates
      from encord.orm.collection import ProjectCollectionType, ProjectDataCollectionItemRequest, ProjectLabelCollectionItemRequest

      # Define constants
      SSH_PATH = "<file-path-to-private-ssh-key>"
      PROJECT_ID = "<project-unique-id>"
      COLLECTION_ID = "<collection-unique-id>"

      # Initialize the user client using the SSH private key
      user_client = EncordUserClient.create_with_ssh_private_key(
          ssh_private_key_path=SSH_PATH
      )

      # Fetch the specified Project by ID
      project = user_client.get_project(PROJECT_ID)

      # Fetch the specific Collection by ID
      collection = project.get_collection(COLLECTION_ID)

      frame_list = []

      # Iterate over frames
      for label_row, frames in collection.list_frames():
          frame_list.extend(frames)
          for frame in frames:
              print(f"UUID: {label_row.data_hash}, Frame number: {frame.frame}")  

      ```

      ```python Example theme={"dark"}

      # Import dependencies
      from encord import EncordUserClient
      from encord.collection import ProjectCollection
      from encord.orm.filter_preset import FilterPreset
      from encord.objects.coordinates import BoundingBoxCoordinates
      from encord.orm.collection import ProjectCollectionType, ProjectDataCollectionItemRequest, ProjectLabelCollectionItemRequest

      # Define constants
      SSH_PATH = "/Users/chris-encord/sdk-ssh-private-key.txt"
      PROJECT_ID = "2dd135b6-0ab2-49b1-9b38-b5c685107790"
      COLLECTION_ID = "fdc0775e-2694-4191-946e-c3364d00fdc3"

      # Initialize the user client using the SSH private key
      user_client = EncordUserClient.create_with_ssh_private_key(
          ssh_private_key_path=SSH_PATH
      )

      # Fetch the specified Project by ID
      project = user_client.get_project(PROJECT_ID)

      # Fetch the specific Collection by ID
      collection = project.get_collection(COLLECTION_ID)

      frame_list = []

      # Iterate over frames
      for label_row, frames in collection.list_frames():
          frame_list.extend(frames)
          for frame in frames:
              print(f"UUID: {label_row.data_hash}, Frame number: {frame.frame}")  

      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="List All Labels in a Collection">
    #### List All Labels in a Collection

    Lists all annotations (object labels and classifications) in a Label Collection with the frame ID and frame number.

    <CodeGroup>
      ```python Template List Annotations in Collection theme={"dark"}

      # Import dependencies
      from encord import EncordUserClient
      from encord.collection import ProjectCollection
      from encord.orm.filter_preset import FilterPreset
      from encord.objects.coordinates import BoundingBoxCoordinates
      from encord.orm.collection import ProjectCollectionType, ProjectDataCollectionItemRequest, ProjectLabelCollectionItemRequest

      # Define constants
      SSH_PATH = "<file-path-to-private-key>"
      PROJECT_ID = "<project-unique-id>"
      COLLECTION_ID = "<collection-unique-id>"

      # Initialize the user client using the SSH private key
      user_client = EncordUserClient.create_with_ssh_private_key(
          ssh_private_key_path=SSH_PATH
      )

      # Fetch the specified Project by ID
      project = user_client.get_project(PROJECT_ID)

      # Fetch the specific Collection by ID
      collection = project.get_collection(COLLECTION_ID)

      annotation_list = []

      # Iterate over annotations
      for label_row, annotations in collection.list_annotations():
          annotation_list.extend(annotations)
          for annotation in annotations:
              print(f"UUID: {label_row.data_hash}, Frame number: {annotation.frame}, Annotation: {annotation.annotation_id}")  

      ```

      ```python Example List Annotations in Collection theme={"dark"}

      # Import dependencies
      from encord import EncordUserClient
      from encord.collection import ProjectCollection
      from encord.orm.filter_preset import FilterPreset
      from encord.objects.coordinates import BoundingBoxCoordinates
      from encord.orm.collection import ProjectCollectionType, ProjectDataCollectionItemRequest, ProjectLabelCollectionItemRequest

      # Define constants
      SSH_PATH = "/Users/chris-encord/sdk-ssh-private-key.txt"
      PROJECT_ID = "2dd135b6-0ab2-49b1-9b38-b5c685107790"
      COLLECTION_ID = "578b343b-ecb1-4948-b203-f1446fb9ceab"

      # Initialize the user client using the SSH private key
      user_client = EncordUserClient.create_with_ssh_private_key(
          ssh_private_key_path=SSH_PATH
      )

      # Fetch the specified Project by ID
      project = user_client.get_project(PROJECT_ID)

      # Fetch the specific Collection by ID
      collection = project.get_collection(COLLECTION_ID)

      annotation_list = []

      # Iterate over annotations
      for label_row, annotations in collection.list_annotations():
          annotation_list.extend(annotations)
          for annotation in annotations:
              print(f"UUID: {label_row.data_hash}, Frame number: {annotation.frame}, Annotation: {annotation.annotation_id}")  

      ```
    </CodeGroup>
  </Accordion>
</AccordionGroup>