Saltar al contenido principal
POST
Crear un calendario

Autorizaciones

Authorization
string
header
requerido

Autenticación con token Bearer (formato: "Bearer {token}")

Encabezados

X-Request-Id
string

A unique identifier for tracing the request across services.

X-Idempotency-Key
string

Clave de idempotencia opcional para reintentos seguros. También acepta Idempotency-Key como nombre de encabezado alternativo. Si se envía la misma clave nuevamente y la solicitud original ya fue procesada, se devuelve la respuesta en caché con X-Idempotency-Replayed: true.

Consulte Reintentos e idempotencia para más detalles.

Parámetros de ruta

contextId
string
requerido

The unique identifier of the reconciliation context.

Cuerpo

application/json

Detalles del calendario

Payload para crear una programación de conciliación

cronExpression
string
requerido

Expresión cron que define la frecuencia de la programación

Required string length: 1 - 100
Ejemplo:

"0 0 * * *"

enabled
boolean

Si la programación debe activarse de inmediato

Ejemplo:

true

Respuesta

Calendario creado.

La respuesta incluye el encabezado X-Idempotency-Replayed.

Si el valor es false, la solicitud acaba de ser procesada. Si el valor es true, la respuesta es una repetición de una solicitud procesada anteriormente.

Consulte Reintentos e idempotencia para más detalles.

Programación de conciliación basada en cron

id
string<uuid>

Identificador único de la programación

Ejemplo:

"019c96a0-2b20-7123-9a1b-2c3d4e5f6a7b"

contextId
string<uuid>

Contexto al que pertenece esta programación

Ejemplo:

"019c96a0-2a10-7dfe-b5c1-8a1b2c3d4e5f"

cronExpression
string

Expresión cron que define la programación

Maximum string length: 100
Ejemplo:

"0 0 * * *"

enabled
boolean

Si la programación está activa

Ejemplo:

true

lastRunAt
string<date-time>

Hora de la última ejecución exitosa en formato RFC 3339

Ejemplo:

"2025-01-15T10:30:00Z"

nextRunAt
string<date-time>

Hora de la próxima ejecución programada en formato RFC 3339

Ejemplo:

"2025-01-16T00:00:00Z"

createdAt
string<date-time>

Marca de tiempo de creación en formato RFC 3339

Ejemplo:

"2025-01-15T10:30:00Z"

updatedAt
string<date-time>

Marca de tiempo de la última actualización en formato RFC 3339

Ejemplo:

"2025-01-15T10:30:00Z"