---
title: "Edit pod"
method: PUT
path: "/pods/{id}"
tags: ["Support API Key Authentication"]
---

# Edit pod

`PUT /pods/{id}`

Endpoint to edit an existing pod with the provided details.

## Path parameters

- `id` string, uuid, required

## Request body

- CustomTemplateRequest
  - `name` string
  - `description` string, nullable
  - `docker_image` string, required
  - `docker_image_digest` string
  - `docker_image_tag` string, nullable
  - `category` 'DOCKER' | 'PYTORCH' | 'NVIDIA' | 'TENSOR_FLOW' | 'OPEN_AI' | 'UBUNTU'
  - `volumes` string[]
  - `environment` object
  - `entrypoint` string
  - `internal_ports` integer[]
  - `is_private` boolean
  - `readme` string, nullable
  - `startup_commands` string
  - `container_start_immediately` boolean
  - `health_check_command` string, nullable
  - `docker_credential_id` union
    - string
    - string, uuid
  - `one_time_template` boolean
  - `is_temporary` boolean
  - `docker_image_size` integer, nullable
  - `supports_docker` boolean
  - `supports_volume_encryption` boolean

## Response `200`

Pod edited successfully

- TemplateResponse
  - `id` string, uuid, required
  - `name` string, required
  - `description` string, nullable, required
  - `docker_image` string, required
  - `docker_image_tag` string, required
  - `docker_image_digest` string, nullable, required
  - `docker_image_size` integer, nullable, required
  - `category` 'DOCKER' | 'PYTORCH' | 'NVIDIA' | 'TENSOR_FLOW' | 'OPEN_AI' | 'UBUNTU', required
  - `validator_only` boolean, nullable, required
  - `volumes` string[], nullable, required
  - `environment` object, nullable, required
  - `entrypoint` string, nullable, required
  - `internal_ports` integer[], nullable, required
  - `user_id` string, uuid, nullable, required
  - `is_private` boolean, nullable, required
  - `readme` string, nullable, required
  - `startup_commands` string, nullable, required
  - `status` string, nullable, required
  - `is_temporary` boolean, nullable, required
  - `is_created_from_official_template` boolean, nullable, required
  - `docker_credential_id` string, uuid, nullable, required
  - `one_time_template` boolean, nullable, required
  - `container_start_immediately` boolean, nullable, required
  - `verify_ssh_connection` boolean, nullable, required
  - `health_check_command` string, nullable, required
  - `verification_logs` string, nullable, required
  - `download_count` integer, nullable, required
  - `supports_docker` boolean, nullable
  - `supports_volume_encryption` boolean
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `compatibility` TemplateCompatibilityInfo
    - `is_compatible` boolean, nullable, required
    - `template_cuda_version` number, nullable, required
    - `gpu_min_cuda_required` number, nullable, required
    - `driver_max_cuda_supported` number, nullable, required
    - `reason` string, nullable, required

## Other responses

- `400` — Invalid input
- `404` — Pod not found
- `422` — Validation Error
- `500` — Internal server error

---

[API](https://skmtc.dev/lium/apis/lium-backend-api.md) · [All operations](https://skmtc.dev/lium/apis/lium-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/lium/lium-backend-api/revisions/57db0a9348db/schema)