---
title: "Update tracking settings for a video"
method: PATCH
path: "/v1/tracking/videos/{id}"
tags: ["Tracking"]
---

# Update tracking settings for a video

`PATCH /v1/tracking/videos/{id}`

## Request

- Base URL: `https://api.virlo.ai`
- URL: `https://api.virlo.ai/v1/tracking/videos/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Request body

- V1UpdateTrackingDto
  - `status` 'active' | 'paused'
  - `scrape_cadence` 'six_hours' | 'twelve_hours' | 'daily' | 'every_other_day' | 'weekly' | 'bi_weekly' | 'monthly': How often to collect metrics and generate an AI report

## Response `200`

Updated video

- TrackedVideoResponseDto
  - `data` TrackedVideoDataDto, required
    - `platform_video_id` string, nullable
    - `title` string, nullable
    - `description` string, nullable
    - `thumbnail_url` string, nullable
    - `duration` number, nullable: Video length in seconds.
    - `published_at` string, nullable
    - `author_handle` string, nullable
    - `author_name` string, nullable
    - `author_avatar_url` string, nullable
    - `latest_transcript` string, nullable
    - `analysis` object, nullable: Latest AI analysis payload for this video.
    - `analysis_updated_at` string, nullable
    - `id` string, required
    - `platform` 'tiktok' | 'youtube' | 'instagram', required
    - `url` string, required
    - `tracking_account_id` string, nullable
    - `status` 'active' | 'paused' | 'deleted', required
    - `scrape_cadence` string, required
    - `enrichment_status` string, required
    - `latest_views` number, nullable
    - `latest_likes` number, nullable
    - `latest_comments` number, nullable
    - `latest_shares` number, nullable
    - `latest_bookmarks` number, nullable
    - `growth_rate` number, nullable: Growth rate since last scrape (view-based)
    - `last_scraped_at` string, nullable
    - `next_scrape_at` string, nullable
    - `created_at` string, required
    - `updated_at` string, required

## Other responses

- `400`: Invalid request parameters
- `401`: Unauthorized - missing or invalid API key
- `404`: Tracked video not found
- `429`: Rate limit exceeded (`rate_limit_exceeded`); see the Retry-After header

---

[API](https://skmtc.dev/virlo/apis/virlo-public-api.md) · [All operations](https://skmtc.dev/virlo/apis/virlo-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/virlo/apis/virlo-public-api/revisions/3b69c6145087?raw)