---
title: "Scheduler Tick"
method: POST
path: "/api/v1/decision/tick"
tags: ["Decision", "Decision Layer"]
---

# Scheduler Tick

`POST /api/v1/decision/tick`

Main scheduler tick - process videos for optimization.

Called every 5 minutes by GCP Cloud Scheduler.

Flow:
1. Get ready videos from OPTIMIZE and REOPT queues
2. For each video, run should_optimize() check
3. Create VideoDecision for eligible videos
4. Send to Optimization Layer
5. Move optimized videos to MEASURE queue

Returns:
    TickResponse with processing summary

## Query parameters

- `authorization` string, nullable

## Response `200`

Successful Response

- TickResponse — Response from scheduler tick endpoint.
  - `success` boolean, required
  - `processed` integer, required
  - `optimized` integer, required
  - `skipped` integer, required
  - `errors` integer, required
  - `duration_ms` number, required
  - `decisions` object[]
  - `skip_reasons` object

## Other responses

- `401` — Unauthorized - Invalid scheduler token
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.dev/primetime/apis/primetime-media-api.md) · [All operations](https://skmtc.dev/primetime/apis/primetime-media-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/primetime/primetime-media-api/revisions/9da9a9f64e11/schema)