Adelantar un Test Clock

POST

https://app.recurrente.com/api/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.

Authentication

X-SECRET-KEYstring

Tu clave secreta de API.

Una llave de cuenta (sk_live_..., sk_test_...) opera sobre su propia cuenta y, con X-ACCOUNT-ID, sobre sus cuentas conectadas.

Una llave de organización (sk_org_live_..., sk_org_test_...) alcanza todas las cuentas de una organización y solo sirve para leer: saldos, movimientos y reportes. Para operar sobre una cuenta debe nombrarla con X-ACCOUNT-ID; omitirlo en una lectura devuelve todas las cuentas de la organización. Cualquier otro endpoint responde 403 con code: organization_key_unsupported.

Tu clave secreta de API. Una llave de cuenta (`sk_live_...`, `sk_test_...`) opera sobre su propia cuenta y, con `X-ACCOUNT-ID`, sobre sus cuentas conectadas. Una llave de organización (`sk_org_live_...`, `sk_org_test_...`) alcanza todas las cuentas de una organización y solo sirve para leer: saldos, movimientos y reportes. Para operar sobre una cuenta debe nombrarla con `X-ACCOUNT-ID`; omitirlo en una lectura devuelve todas las cuentas de la organización. Cualquier otro endpoint responde `403` con `code: organization_key_unsupported`.

Path parameters

idstringRequired

Request

This endpoint expects an object.

frozen_atdatetimeRequired

next_charge_outcomeenumOptional

Allowed values:

Response

Avance aceptado

idstring

namestring

statusenum

frozen_atdatetime

next_charge_outcomeenum

advancing_todatetime or nullOptional

last_errorstring or nullOptional

Errors

422

Unprocessable Entity Error

$	curl -X POST https://app.recurrente.com/api/test_clocks/id/advance \
>	-H "X-SECRET-KEY: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"frozen_at": "2026-08-01T00:00:00Z"
>	}'

1	{
2	"id": "clock_abc123",
3	"name": "UAT julio",
4	"status": "ready",
5	"frozen_at": "2024-01-15T09:30:00Z",
6	"next_charge_outcome": "success",
7	"advancing_to": "2024-01-15T09:30:00Z",
8	"last_error": "string"
9	}