---
title: "Create Annotation Queue"
method: POST
path: "/annotation_queues"
tags: ["annotation_queue"]
---

# Create Annotation Queue

`POST /annotation_queues`

Create an annotation queue at the organization level.

The creator will automatically be granted the 'owner' role.
Optionally accepts a list of annotator emails. Users that don't exist in the organization will be invited.
Optionally copies templates from an existing queue if copy_templates_from_queue_id is provided.

## Request body

- CreateAnnotationQueueRequest
  - `name` Name, required — Global name class for handling unique naming across the application.
    - `value` string, required
    - `append_suffix_if_duplicate` boolean
  - `description` string, nullable
  - `annotator_emails` string[]
  - `copy_templates_from_queue_id` string, uuid4, nullable — Optional ID of an existing annotation queue to copy templates from

## Response `200`

Successful Response

- AnnotationQueueResponse
  - `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
  - `name` string, required
  - `description` string, nullable, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `created_by_user` UserInfo, required — A user's basic information, used for display purposes.
    - `id` string, uuid4, required
    - `email` string, required
    - `first_name` string, nullable
    - `last_name` string, nullable
  - `num_log_records` integer
  - `num_annotators` integer
  - `num_users` integer
  - `num_templates` integer
  - `num_logs_annotated` object, nullable
  - `progress` object, nullable
  - `overall_progress` number, nullable
  - `templates` AnnotationTemplateDB[]
    - `name` string, required
    - `include_explanation` boolean, required
    - `criteria` string, nullable
    - `constraints` union, required
      - ApiSchemasAnnotationLikeDislikeConstraints
        - `annotation_type` 'like_dislike', required
      - ApiSchemasAnnotationStarConstraints
        - `annotation_type` 'star', required
      - ApiSchemasAnnotationScoreConstraints
        - `annotation_type` 'score', required
        - `min` integer, required
        - `max` integer, required
      - ApiSchemasAnnotationTagsConstraints
        - `annotation_type` 'tags', required
        - `tags` string[], required
        - `allow_other` boolean
      - ApiSchemasAnnotationTextConstraints
        - `annotation_type` 'text', required
      - ApiSchemasAnnotationChoiceConstraints
        - `annotation_type` 'choice', required
        - `choices` string[], required
        - `allow_other` boolean
      - TreeChoiceDBConstraints
        - `annotation_type` 'tree_choice', required
        - `choices_tree` ApiSchemasAnnotationTreeChoiceNodeOutput[], required
          - `label` string, required
          - `id` string, required
          - `children` ApiSchemasAnnotationTreeChoiceNodeOutput[]
        - `choices_tree_yaml` string, required
    - `id` string, uuid4, required
    - `created_at` string, date-time, required
    - `created_by` string, uuid4, nullable, required
    - `position` integer, required
    - `usage_count` integer, required — Number of annotation ratings using the template.

## Other responses

- `422` — Validation Error

---

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