---
title: "Create Playground Prompt"
method: POST
path: "/projects/{project_id}/playgrounds/{playground_id}/prompts"
tags: ["playground_prompts"]
---

# Create Playground Prompt

`POST /projects/{project_id}/playgrounds/{playground_id}/prompts`

## Path parameters

- `project_id` string, uuid4, required
- `playground_id` string, uuid4, required

## Request body

- CreatePlaygroundPromptRequest
  - `playground_prompt_id` string, uuid4, nullable — If provided, the new prompt will be a copy of the existing one.

## Response `200`

Successful Response

- PlaygroundPromptResponse
  - `id` string, uuid4, required
  - `base_prompt` BasePrompt, required
    - `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
    - `version` integer, required
    - `version_id` string, uuid4, required
    - `name` string, required
    - `template` string, required
    - `settings` PromptRunSettingsOutput — 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
            - `name` string, required
      - `response_format` object, nullable
    - `raw` boolean
  - `template` string, nullable — Overrides the base prompt template if set.
  - `settings` PromptRunSettingsOutput — 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
          - `name` string, required
    - `response_format` object, nullable
  - `raw` boolean, required
  - `position` integer, required
  - `run_id` string, uuid4, 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/ec2affc66693/schema)