---
title: "Bulk update account max videos limits"
method: PUT
path: "/accounts/tracked/max-videos/bulk"
tags: ["Track Accounts"]
---

# Bulk update account max videos limits

`PUT /accounts/tracked/max-videos/bulk`

## Request

- Base URL: `https://viral.app/api/v1`
- URL: `https://viral.app/api/v1/accounts/tracked/max-videos/bulk`
- Auth: API key in header `x-api-key`

Updates a tracked account setting for multiple accounts at once, selected by accountIds or by scope (every internal, competitor or tracked account; paused accounts only with includePaused). The new limit is clamped onto each account's platform options — Snapchat supports only Pause, 10, or 30 (its public surface stops at the ~29 most recent Spotlights), so higher or unlimited values are stored as 30 for Snapchat accounts in the selection.

## Request body

- object: Request body for updating multiple tracked account settings: accountIds, or a scope that targets every tracked account it names
  - `accountIds` string[]: The tracked accounts to change (at least one), unless scope is given.
  - `scope` 'internal' | 'competitors' | 'all': Targets every tracked account of the organization instead of a list of ids: internal = the organization's own accounts, competitors = competitor accounts, all = both. Paused accounts (limit 0) are left out unless includePaused is true.
  - `includePaused` boolean: With scope: also target paused accounts (limit 0), which a limit resumes. Leave it out unless the user asks to resume paused accounts too.
  - `newMaxVideos` union, required: Video tracking limit for an account. Allowed values: 0, 10, 30, 60, 100, 200, 300, 400, 500, 1000, 2000, 999999999. Use 0 to pause tracking: nothing syncs for the account until a limit is set again (resume), and its existing videos stay available; pausing requires the Data Retention plan feature. Finite values (10, 30, 60, 100, 200, 300, 400, 500, 1000, 2000) sync that many latest videos and are subject to plan limits. Use 999999999 for unlimited account video tracking; this requires the Unlimited Video Tracking plan feature.
    - unknown
    - unknown
    - unknown
    - unknown
    - unknown
    - unknown
    - unknown
    - unknown
    - unknown
    - unknown
    - unknown
    - unknown

## Response `200`

OK

- object: Result of updating multiple tracked account settings
  - `successCount` number, required
  - `failedCount` number, required
  - `totalRequested` number, required
  - `creditsConsumed` number, required
  - `failedAccountIds` string[]

## Other responses

- `400`: 400
- `401`: 401
- `402`: 402
- `404`: 404
- `408`: 408
- `429`: 429
- `500`: 500

---

[API](https://skmtc.dev/viral/apis/viral-app-api.md) · [All operations](https://skmtc.dev/viral/apis/viral-app-api/llms.txt) · [OpenAPI document](https://skmtc.dev/viral/apis/viral-app-api/revisions/31e97fa79ef1?raw)