---
title: "Update video archive properties"
method: PUT
path: "/videos/{id}/"
tags: ["videos"]
---

# Update video archive properties

`PUT /videos/{id}/`

Use this method to update a video archive properties.

## Path parameters

- `id` integer, required

## Request body

- VideoArchiveRequest
  - `camera_group` integer, required
  - `name` string, nullable, required
  - `url` string, nullable
  - `camera` integer, nullable
  - `router_url` string, nullable
  - `stream_settings` CameraStreamSettingsRequest — Serializer mixin that raises ValidationError if excess fields are presented. Can be used in nested serializers
    - `detectors` DetectorsRequest — Serializer mixin that raises ValidationError if excess fields are presented. Can be used in nested serializers
      - `face` DetectorParametersRequest — Serializer mixin that raises ValidationError if excess fields are presented. Can be used in nested serializers
        - `filter_max_size` integer
        - `filter_min_quality` number, float
        - `filter_min_size` integer
        - `fullframe_crop_rot` boolean
        - `fullframe_use_png` boolean
        - `jpeg_quality` integer
        - `overall_only` boolean
        - `post_best_track_frame` boolean
        - `post_best_track_normalize` boolean
        - `post_first_track_frame` boolean
        - `post_last_track_frame` boolean
        - `realtime_post_every_interval` boolean
        - `realtime_post_first_immediately` boolean
        - `realtime_post_interval` number, float
        - `roi` string
        - `track_interpolate_bboxes` boolean
        - `track_max_duration_frames` integer
        - `track_miss_interval` integer
        - `track_overlap_threshold` number, float
        - `track_send_history` boolean
        - `tracker_type` string
        - `track_deep_sort_matching_threshold` number, float
        - `track_deep_sort_filter_unconfirmed_tracks` boolean
        - `filter_track_min_duration_frames` integer
      - `body` DetectorParametersRequest — Serializer mixin that raises ValidationError if excess fields are presented. Can be used in nested serializers
        - `filter_max_size` integer
        - `filter_min_quality` number, float
        - `filter_min_size` integer
        - `fullframe_crop_rot` boolean
        - `fullframe_use_png` boolean
        - `jpeg_quality` integer
        - `overall_only` boolean
        - `post_best_track_frame` boolean
        - `post_best_track_normalize` boolean
        - `post_first_track_frame` boolean
        - `post_last_track_frame` boolean
        - `realtime_post_every_interval` boolean
        - `realtime_post_first_immediately` boolean
        - `realtime_post_interval` number, float
        - `roi` string
        - `track_interpolate_bboxes` boolean
        - `track_max_duration_frames` integer
        - `track_miss_interval` integer
        - `track_overlap_threshold` number, float
        - `track_send_history` boolean
        - `tracker_type` string
        - `track_deep_sort_matching_threshold` number, float
        - `track_deep_sort_filter_unconfirmed_tracks` boolean
        - `filter_track_min_duration_frames` integer
      - `car` DetectorParametersRequest — Serializer mixin that raises ValidationError if excess fields are presented. Can be used in nested serializers
        - `filter_max_size` integer
        - `filter_min_quality` number, float
        - `filter_min_size` integer
        - `fullframe_crop_rot` boolean
        - `fullframe_use_png` boolean
        - `jpeg_quality` integer
        - `overall_only` boolean
        - `post_best_track_frame` boolean
        - `post_best_track_normalize` boolean
        - `post_first_track_frame` boolean
        - `post_last_track_frame` boolean
        - `realtime_post_every_interval` boolean
        - `realtime_post_first_immediately` boolean
        - `realtime_post_interval` number, float
        - `roi` string
        - `track_interpolate_bboxes` boolean
        - `track_max_duration_frames` integer
        - `track_miss_interval` integer
        - `track_overlap_threshold` number, float
        - `track_send_history` boolean
        - `tracker_type` string
        - `track_deep_sort_matching_threshold` number, float
        - `track_deep_sort_filter_unconfirmed_tracks` boolean
        - `filter_track_min_duration_frames` integer
    - `disable_drops` boolean
    - `ffmpeg_format` string
    - `ffmpeg_params` string[]
    - `imotion_threshold` number, float
    - `play_speed` number, float
    - `rot` string
    - `router_timeout_ms` integer
    - `router_verify_ssl` boolean
    - `start_stream_timestamp` integer
    - `stream_data_filter` string
    - `use_stream_timestamp` boolean
    - `video_transform` string
    - `enable_recorder` boolean
    - `enable_liveness` boolean
    - `record_audio` boolean
    - `use_rtsp_time` boolean
  - `case` integer, nullable

## Response `200`

- VideoArchive
  - `id` integer, required
  - `camera_group` integer, required
  - `name` string, nullable, required
  - `url` string, nullable
  - `camera` integer, nullable
  - `processing_start_date` string, date-time, required — Video processing start date
  - `active` boolean, required — Processing is active
  - `router_url` string, nullable
  - `screenshot` string, uri, required — Screenshot URL
  - `stream_settings` CameraStreamSettings — Serializer mixin that raises ValidationError if excess fields are presented. Can be used in nested serializers
    - `detectors` Detectors — Serializer mixin that raises ValidationError if excess fields are presented. Can be used in nested serializers
      - `face` DetectorParameters — Serializer mixin that raises ValidationError if excess fields are presented. Can be used in nested serializers
        - `filter_max_size` integer
        - `filter_min_quality` number, float
        - `filter_min_size` integer
        - `fullframe_crop_rot` boolean
        - `fullframe_use_png` boolean
        - `jpeg_quality` integer
        - `overall_only` boolean
        - `post_best_track_frame` boolean
        - `post_best_track_normalize` boolean
        - `post_first_track_frame` boolean
        - `post_last_track_frame` boolean
        - `realtime_post_every_interval` boolean
        - `realtime_post_first_immediately` boolean
        - `realtime_post_interval` number, float
        - `roi` string
        - `track_interpolate_bboxes` boolean
        - `track_max_duration_frames` integer
        - `track_miss_interval` integer
        - `track_overlap_threshold` number, float
        - `track_send_history` boolean
        - `tracker_type` string
        - `track_deep_sort_matching_threshold` number, float
        - `track_deep_sort_filter_unconfirmed_tracks` boolean
        - `filter_track_min_duration_frames` integer
      - `body` DetectorParameters — Serializer mixin that raises ValidationError if excess fields are presented. Can be used in nested serializers
        - `filter_max_size` integer
        - `filter_min_quality` number, float
        - `filter_min_size` integer
        - `fullframe_crop_rot` boolean
        - `fullframe_use_png` boolean
        - `jpeg_quality` integer
        - `overall_only` boolean
        - `post_best_track_frame` boolean
        - `post_best_track_normalize` boolean
        - `post_first_track_frame` boolean
        - `post_last_track_frame` boolean
        - `realtime_post_every_interval` boolean
        - `realtime_post_first_immediately` boolean
        - `realtime_post_interval` number, float
        - `roi` string
        - `track_interpolate_bboxes` boolean
        - `track_max_duration_frames` integer
        - `track_miss_interval` integer
        - `track_overlap_threshold` number, float
        - `track_send_history` boolean
        - `tracker_type` string
        - `track_deep_sort_matching_threshold` number, float
        - `track_deep_sort_filter_unconfirmed_tracks` boolean
        - `filter_track_min_duration_frames` integer
      - `car` DetectorParameters — Serializer mixin that raises ValidationError if excess fields are presented. Can be used in nested serializers
        - `filter_max_size` integer
        - `filter_min_quality` number, float
        - `filter_min_size` integer
        - `fullframe_crop_rot` boolean
        - `fullframe_use_png` boolean
        - `jpeg_quality` integer
        - `overall_only` boolean
        - `post_best_track_frame` boolean
        - `post_best_track_normalize` boolean
        - `post_first_track_frame` boolean
        - `post_last_track_frame` boolean
        - `realtime_post_every_interval` boolean
        - `realtime_post_first_immediately` boolean
        - `realtime_post_interval` number, float
        - `roi` string
        - `track_interpolate_bboxes` boolean
        - `track_max_duration_frames` integer
        - `track_miss_interval` integer
        - `track_overlap_threshold` number, float
        - `track_send_history` boolean
        - `tracker_type` string
        - `track_deep_sort_matching_threshold` number, float
        - `track_deep_sort_filter_unconfirmed_tracks` boolean
        - `filter_track_min_duration_frames` integer
    - `disable_drops` boolean
    - `ffmpeg_format` string
    - `ffmpeg_params` string[]
    - `imotion_threshold` number, float
    - `play_speed` number, float
    - `rot` string
    - `router_timeout_ms` integer
    - `router_verify_ssl` boolean
    - `start_stream_timestamp` integer
    - `stream_data_filter` string
    - `use_stream_timestamp` boolean
    - `video_transform` string
    - `enable_recorder` boolean
    - `enable_liveness` boolean
    - `record_audio` boolean
    - `use_rtsp_time` boolean
  - `source_len` number, float, required — Source length in seconds
  - `health_status` Status, required
    - `enabled` boolean, required — `true` for the camera enabled through findface-video-manager
    - `status` string, required — Status code
    - `msg` string, required — Status description
    - `statistic` object, required — Various findface-video-worker statistics
    - `code` string, required — `Status` color code for UI.
    - `code_desc` string, required — `Status` description for UI.
  - `finished` boolean, required — `true` if the video processing is finished
  - `queued` boolean, required — `true` if the video is in the processing queue
  - `face_count` integer, required — Number of created faces
  - `file_size` integer, required — Video file size in the archive
  - `created_date` string, date-time, required — Object creation date
  - `body_count` integer, required — Number of created bodies
  - `car_count` integer, required — Number of created cars
  - `case` integer, nullable
  - `face_cluster_count` integer, nullable, required — Count of face clusters created from this video
  - `body_cluster_count` integer, nullable, required — Count of body clusters created from this video
  - `car_cluster_count` integer, nullable, required — Count of car clusters created from this video
  - `frame_height` integer, required — Frame height in pixels
  - `frame_width` integer, required — Frame width in pixels
  - `error` string, required — Processing error

---

[API](https://skmtc.dev/ntechlab/apis/internal-api-documentation.md) · [All operations](https://skmtc.dev/ntechlab/apis/internal-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ntechlab/internal-api-documentation/revisions/fe217a895bc7/schema)