---
title: "Query Templates"
method: POST
path: "/templates/query"
tags: ["prompts"]
---

# Query Templates

`POST /templates/query`

Query prompt templates the user has access to.

Parameters
----------
params : ListPromptTemplateParams
    Query parameters for filtering and sorting.
pagination : PaginationRequestMixin
    Pagination parameters.

Returns
-------
ListPromptTemplateResponse
    Paginated list of prompt template responses that the user has access to.

## Query parameters

- `starting_token` integer
- `limit` integer

## Request body

- ListPromptTemplateParams
  - `filters` union[]
    - union
      - PromptTemplateNameFilter
        - `name` 'name'
        - `operator` 'eq' | 'ne' | 'contains' | 'one_of' | 'not_in', required
        - `value` union, required
          - string
          - string[]
        - `case_sensitive` boolean
      - PromptTemplateCreatedByFilter
        - `name` 'creator'
        - `operator` 'eq' | 'ne' | 'one_of' | 'not_in' | 'contains'
        - `value` union, required
          - string, uuid4
          - union[]
            - union
              - …
          - string
      - PromptTemplateUsedInProjectFilter
        - `name` 'used_in_project'
        - `value` string, uuid4, required
      - PromptTemplateNotInProjectFilter
        - `name` 'not_in_project'
        - `value` string, uuid4, required
  - `sort` union
    - PromptTemplateNameSort
      - `name` 'name'
      - `ascending` boolean
      - `sort_type` 'column'
    - PromptTemplateCreatedAtSort
      - `name` 'created_at'
      - `ascending` boolean
      - `sort_type` 'column'
    - PromptTemplateUpdatedAtSort
      - `name` 'updated_at'
      - `ascending` boolean
      - `sort_type` 'column'

## Response `200`

Successful Response

- ListPromptTemplateResponse
  - `starting_token` integer
  - `limit` integer
  - `paginated` boolean
  - `next_starting_token` integer, nullable
  - `templates` BasePromptTemplateResponse[]
    - `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` union, required
      - string
      - Name — Global name class for handling unique naming across the application.
        - `value` string, required
        - `append_suffix_if_duplicate` boolean
    - `template` string, required
    - `selected_version` BasePromptTemplateVersionResponse, required — Base response from API for a prompt template version.
      - `template` union, required
        - string
        - GalileoCoreSchemasSharedMessageMessage[]
          - `content` union, required
            - string
            - union[]
              - …
          - `role` union, required
            - string
            - 'agent' | 'assistant' | 'function' | 'system' | 'tool' | 'user'
      - `raw` boolean
      - `version` integer, required
      - `settings` PromptRunSettingsOutput, required — Prompt run settings.
        - `logprobs` boolean
        - `top_logprobs` integer
        - `echo` boolean
        - `n` integer
        - `reasoning_effort` string
        - `verbosity` string
        - `deployment_name` string, nullable
        - `model_alias` string
        - `temperature` number, nullable
        - `max_tokens` integer
        - `stop_sequences` string[], nullable
        - `top_p` number
        - `top_k` integer
        - `frequency_penalty` number
        - `presence_penalty` number
        - `tools` string
        - `tool_choice` union
          - string
          - OpenAIToolChoice
            - `type` string
            - `function` OpenAIFunction, required
              - …
        - `response_format` object, nullable
      - `output_type` string, nullable
      - `id` string, uuid4, required
      - `model_changed` boolean, required
      - `lines_added` integer
      - `lines_edited` integer
      - `lines_removed` integer
      - `settings_changed` boolean, required
      - `content_changed` boolean, 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
    - `selected_version_id` string, uuid4, required
    - `all_versions` BasePromptTemplateVersionResponse[]
      - `template` union, required
        - string
        - GalileoCoreSchemasSharedMessageMessage[]
          - `content` union, required
            - string
            - union[]
              - …
          - `role` union, required
            - string
            - 'agent' | 'assistant' | 'function' | 'system' | 'tool' | 'user'
      - `raw` boolean
      - `version` integer, required
      - `settings` PromptRunSettingsOutput, required — Prompt run settings.
        - `logprobs` boolean
        - `top_logprobs` integer
        - `echo` boolean
        - `n` integer
        - `reasoning_effort` string
        - `verbosity` string
        - `deployment_name` string, nullable
        - `model_alias` string
        - `temperature` number, nullable
        - `max_tokens` integer
        - `stop_sequences` string[], nullable
        - `top_p` number
        - `top_k` integer
        - `frequency_penalty` number
        - `presence_penalty` number
        - `tools` string
        - `tool_choice` union
          - string
          - OpenAIToolChoice
            - `type` string
            - `function` OpenAIFunction, required
              - …
        - `response_format` object, nullable
      - `output_type` string, nullable
      - `id` string, uuid4, required
      - `model_changed` boolean, required
      - `lines_added` integer
      - `lines_edited` integer
      - `lines_removed` integer
      - `settings_changed` boolean, required
      - `content_changed` boolean, 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
    - `all_available_versions` integer[], required
    - `total_versions` integer, required
    - `max_version` integer, 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

## 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/revisions/344acdc36dbb/schema)