POST datetime

cron_next

1 credit

Get the next N run times for a cron expression

Endpoint

POST /api/v1/tools/datetime/cron_next

Body Parameters

after string | null optional default: null

count integer optional default: 5

expression string required

Example

input Request

{
    "after": "2024-01-15T00:00:00",
    "count": 3,
    "expression": "0 9 * * 1-5"
}

output Response

{
    "next": [
        "2024-01-15T09:00:00",
        "2024-01-16T09:00:00",
        "2024-01-17T09:00:00"
    ],
    "expression": "0 9 * * 1-5"
}

Response Format

HTTP/1.1 200 OK SUCCESS

{
  "success": true,
  "data": {
    "next": [
        "2024-01-15T09:00:00",
        "2024-01-16T09:00:00",
        "2024-01-17T09:00:00"
    ],
    "expression": "0 9 * * 1-5"
},
  "meta": {
    "tool": "cron_next",
    "credits_consumed": 1
  }
}

HTTP/1.1 422 Unprocessable Entity ERROR

{
  "success": false,
  "data": null,
  "error": {
    "code": "validation_error",
    "message": "The given data was invalid."
  }
}

Code Examples

Request Example

lightbulb Developer Tip

Credits are deducted before execution. If the upstream tool fails, credits are automatically refunded to your account.