INinvoiceninja
task_schedulers

Update task scheduler

Changed on

Update task scheduler

put/api/v1/task_schedulers/{id}

Request

Path parameters

idstring string required

The Scheduler Hashed ID

Headers

X-API-SECRETstring
Example:password

The API secret as defined by the .env variable API_SECRET. Only needed for self hosted users, and only applicable on the login route.

X-Requested-Withstring required
Example:XMLHttpRequest

Used to send the XMLHttpRequest header

Request body

pausedboolean

The scheduler paused state

repeat_everystring

Accepted values (DAY,WEEK,MONTH,3MONTHS,YEAR)

start_frominteger

Timestamp when we should start the scheduler, default is today

jobstring

Job, we can find list of available jobs in Scheduler model

date_rangestring

The string representation of the date range of data to be returned

date_keystring

The date column to search between.

start_datestring

The start date to search between

end_datestring

The end date to search between

report_keysstring[]

Example request

{
  "repeat_every": "DAY",
  "start_from": 1652898504,
  "job": "create_credit_report",
  "date_range": "last7",
  "date_key": "created_at",
  "start_date": "2022-10-31",
  "end_date": "2022-10-31",
  "report_keys": [
    "['name','date']"
  ]
}

Response

success

Changes

  • 8e82a2bd77e0Revision changes
    • breaking

      the response's body type changed from no type to object for status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • e61df65649e2Revision changes
    • breaking

      the response's body type changed from object to no type for status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status