> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zype.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Encoder

Update an existing live encoder

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Live (V3)",
    "version": "1.0.0",
    "description": "Live (V3) API for managing live streaming encoders"
  },
  "servers": [
    {
      "url": "https://api.zype.com"
    }
  ],
  "components": {
    "securitySchemes": {
      "api_key": {
        "type": "apiKey",
        "name": "api_key",
        "in": "query"
      }
    }
  },
  "security": [
    {
      "api_key": []
    }
  ],
  "paths": {
    "/v3/live/encoders/{id}": {
      "put": {
        "summary": "Update Encoder",
        "description": "Update an existing live encoder",
        "operationId": "updateEncoder",
        "tags": [
          "Live Encoders"
        ],
        "parameters": [
          {
            "$ref": "#/paths/~1v3~1live~1encoders~1%7Bid%7D/get/parameters/0"
          }
        ],
        "requestBody": {
          "description": "Encoder configuration to update",
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "title": "V3EncoderUpdateRequest",
                "type": "object",
                "required": [
                  "encoder"
                ],
                "properties": {
                  "encoder": {
                    "type": "object",
                    "title": "V3EncoderUpdateProperties",
                    "properties": {
                      "name": {
                        "type": "string",
                        "description": "Name for the encoder"
                      },
                      "event_profile_id": {
                        "type": "string",
                        "description": "HLS profile ID for the encoder output. Available profiles: CMAF 1080p @ 30fps (70e05a7a-f5e4-4a5b-9e4d-c0b9c5d9056c), CMAF 720p @ 30fps (e201c104-c58d-4fcd-bb29-cca4cb46803a), CMAF 1080p @ 60fps (e1deb531-fb06-464f-b859-4ecec656ee6b), CMAF 720p @ 60fps (4356814e-aa38-4e0b-b1bb-0bc9b824de35)"
                      },
                      "mqcs_input_switch_enabled": {
                        "type": "boolean",
                        "description": "When enabled, MediaPackage automatically switches to the input presenting the best Media Quality Confidence Score (MQCS)."
                      },
                      "live_inputs_attributes": {
                        "type": "array",
                        "description": "List of live inputs to update",
                        "items": {
                          "type": "object",
                          "properties": {
                            "_id": {
                              "type": "string",
                              "description": "ID of the live input to update"
                            },
                            "_destroy": {
                              "type": "boolean",
                              "description": "Set to true to delete this live input"
                            },
                            "ip_whitelist": {
                              "type": "array",
                              "description": "List of IP addresses/CIDR blocks allowed to stream (1-2 entries required)",
                              "items": {
                                "type": "string"
                              }
                            },
                            "hostname": {
                              "type": "string",
                              "description": "Hostname for the live input (1-63 characters, alphanumeric and hyphens only)"
                            }
                          }
                        }
                      },
                      "live_destinations_attributes": {
                        "type": "array",
                        "description": "List of live destinations to create orupdate",
                        "items": {
                          "type": "object",
                          "properties": {
                            "_id": {
                              "type": "string",
                              "description": "ID of the live destination to update (if not provided, a new destination will be created)"
                            },
                            "_destroy": {
                              "type": "boolean",
                              "description": "Set to true to delete this live destination"
                            },
                            "destination_type": {
                              "type": "string",
                              "description": "Type of destination (required when creating a new destination)",
                              "enum": [
                                "hls",
                                "rtmp"
                              ]
                            },
                            "name": {
                              "type": "string",
                              "description": "Name of the destination"
                            },
                            "enabled": {
                              "type": "boolean",
                              "description": "Whether this destination is enabled"
                            },
                            "start_over_window": {
                              "type": "integer",
                              "description": "DVR window duration in seconds (HLS only, 10800-1209600)"
                            },
                            "playlist_window_duration": {
                              "type": "integer",
                              "description": "Live playlist window duration in seconds (HLS only, 0-10800)"
                            },
                            "username": {
                              "type": "string",
                              "description": "Username for RTMP authentication (RTMP only)"
                            },
                            "password": {
                              "type": "string",
                              "description": "Password for RTMP authentication (RTMP only)"
                            },
                            "stream_key": {
                              "type": "string",
                              "description": "Stream key for the RTMP destination (RTMP only)"
                            },
                            "primary_url": {
                              "type": "string",
                              "description": "Primary RTMP URL for streaming (RTMP only)"
                            },
                            "backup_url": {
                              "type": "string",
                              "description": "Backup RTMP URL for failover (RTMP only)"
                            },
                            "auth_enabled": {
                              "type": "boolean",
                              "description": "Whether authentication is enabled (RTMP only)"
                            },
                            "resolution": {
                              "type": "integer",
                              "description": "Output resolution (RTMP only)",
                              "enum": [
                                720,
                                1080
                              ]
                            },
                            "rtmp_external_profile_id": {
                              "type": "string",
                              "description": "External profile ID for RTMP destination (RTMP only)"
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Encoder updated successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/paths/~1v3~1live~1encoders/post/responses/201/content/application~1json/schema"
                }
              }
            }
          },
          "404": {
            "description": "Encoder not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/paths/~1live_events~1%7Bid%7D/get/responses/404/content/application~1json/schema"
                }
              }
            }
          },
          "422": {
            "description": "Unprocessable entity - validation errors or hostname taken",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/paths/~1live_events/post/responses/422/content/application~1json/schema"
                }
              }
            }
          }
        }
      }
    }
  }
}
```