---
title: "Api Playgrounds Update"
method: PUT
path: "/api/playgrounds/{playground_id}/"
tags: ["playgrounds"]
---

# Api Playgrounds Update

`PUT /api/playgrounds/{playground_id}/`

PUT handler with superadmin lock and field protection.

Same as patch() - checks lock and field protection before delegating.

## Path parameters

- `playground_id` string, required

## Headers

- `Authorization` string, required

## Request body

- PlaygroundUpdateRequest
  - `name` string, required
  - `description` string, nullable

## Response `200`

- PlaygroundDetail
  - `id` string, required
  - `name` string, required
  - `description` string, nullable
  - `dataset_id` string, required
  - `state_version` integer
  - `created_by` Editor, required
    - `id` integer, required
    - `email` string, required
    - `name` string, required
    - `username` string
    - `first_name` string
    - `last_name` string
  - `updated_by` Editor, required
    - `id` integer, required
    - `email` string, required
    - `name` string, required
    - `username` string
    - `first_name` string
    - `last_name` string
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `tags` GenericTagDisplay[], required
    - `id` string, required
    - `name` string, required
    - `color` string, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `columns` PlaygroundColumnDetail[], required
    - `id` string, required
    - `name` string, required
    - `order` integer
    - `column_type` 'prompt' — * `prompt` - Prompt
    - `source_type` 'prompt' | 'log' | 'scratch' — * `prompt` - Prompt * `log` - Log * `scratch` - Scratch
    - `linked_prompt_id` string, required
    - `linked_prompt_version` integer, nullable
    - `experiment_id` string
    - `task_tracker_id` string, nullable, required
    - `run_status` string, required
    - `run_progress` string, required
    - `run_error_message` string, required
    - `prompt` unknown
    - `is_archived` boolean
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required

---

[API](https://skmtc.net/keywordsai/apis/api-reference.md) · [All operations](https://skmtc.net/keywordsai/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/keywordsai/api-reference/revisions/c26d550029f8/schema)