---
title: "Adelantar un Test Clock"
method: POST
path: "/test_clocks/{id}/advance"
tags: ["testClocks"]
---

# Adelantar un Test Clock

`POST /test_clocks/{id}/advance`

Inicia un avance asíncrono. El clock pasa a `advancing` y vuelve a `ready`
al terminar. `next_charge_outcome` aplica una vez y después vuelve a `success`.

## Path parameters

- `id` string, required

## Headers

- `X-SECRET-KEY` string, required

## Request body

- object
  - `frozen_at` string, date-time, required
  - `next_charge_outcome` 'success' | 'decline'

## Response `202`

Avance aceptado

- TestClock
  - `id` string, required
  - `name` string, required
  - `status` 'ready' | 'advancing' | 'failed' | 'deleted', required
  - `frozen_at` string, date-time, required
  - `advancing_to` string, date-time, nullable
  - `next_charge_outcome` 'success' | 'decline', required
  - `last_error` string, nullable

## Other responses

- `422` — Avance inválido

---

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