---
title: "Create Group Dataset Collaborators"
method: POST
path: "/v2/datasets/{dataset_id}/groups"
tags: ["datasets"]
---

# Create Group Dataset Collaborators

`POST /v2/datasets/{dataset_id}/groups`

Share a dataset with groups.

## Path parameters

- `dataset_id` string, uuid4, required

## Request body

- GroupCollaboratorCreate[]
  - `role` 'owner' | 'editor' | 'annotator' | 'viewer'
  - `group_id` string, uuid4, required

## Response `200`

Successful Response

- GroupCollaborator[]
  - `id` string, uuid4, required
  - `permissions` Permission[]
    - `action` union, required
      - 'update' | 'delete' | 'read_api_keys' | 'change_role_to_admin' | 'change_role_to_manager' | 'change_role_to_user' | 'change_role_to_read_only'
      - 'update' | 'list_members' | 'join' | 'request_to_join'
      - 'update_role' | 'delete'
      - 'update' | 'delete' | 'rename' | 'share' | 'create_run' | 'delete_run' | 'rename_run' | 'move_run' | 'export_data' | 'configure_human_feedback' | 'record_human_feedback' | 'log_data' | 'toggle_metric' | 'edit_alert' | 'create_stage' | 'edit_stage' | 'configure_crown_logic' | 'delete_data' | 'set_metric' | 'edit_run_tags' | 'dismiss_alert' | 'edit_slice' | 'edit_edit' | 'update_control_bindings' | 'use_control_runtime'
      - 'update' | 'delete' | 'share' | 'export' | 'autotune_apply'
      - 'update' | 'delete'
      - 'update' | 'delete'
      - 'update' | 'delete'
      - 'update' | 'delete'
      - 'update' | 'delete' | 'share' | 'export' | 'rename'
      - 'update' | 'delete' | 'share' | 'read_secrets'
      - 'rename' | 'delete' | 'delete_log_data' | 'read_settings' | 'update_settings' | 'read_cost_settings' | 'read_ai_usage'
      - 'update' | 'delete' | 'share' | 'record_annotation'
      - 'create' | 'read' | 'update' | 'delete' — Actions on Agent Control's org-scoped ``control`` resource.
    - `allowed` boolean, required
    - `message` string, nullable
  - `role` 'owner' | 'editor' | 'annotator' | 'viewer', required
  - `created_at` string, date-time, required
  - `group_id` string, uuid4, required
  - `group_name` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/galileo/apis/fastapi.md) · [All operations](https://skmtc.net/galileo/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/galileo/fastapi/versions/441b96da8c30/schema)