[role="xpack"] [testenv="platinum"] [[ml-put-calendar-job]] === Add {anomaly-jobs} to calendar API ++++ Add jobs to calendar ++++ Adds an {anomaly-job} to a calendar. [[ml-put-calendar-job-request]] ==== {api-request-title} `PUT _ml/calendars//jobs/` [[ml-put-calendar-job-prereqs]] ==== {api-prereq-title} * If the {es} {security-features} are enabled, you must have `manage_ml` or `manage` cluster privileges to use this API. See {stack-ov}/security-privileges.html[Security privileges]. [[ml-put-calendar-job-path-parms]] ==== {api-path-parms-title} ``:: (Required, string) Identifier for the calendar. ``:: (Required, string) An identifier for the {anomaly-jobs}. It can be a job identifier, a group name, or a comma-separated list of jobs or groups. [[ml-put-calendar-job-example]] ==== {api-examples-title} [source,js] -------------------------------------------------- PUT _ml/calendars/planned-outages/jobs/total-requests -------------------------------------------------- // CONSOLE // TEST[skip:setup:calendar_outages_openjob] The API returns the following results: [source,js] ---- { "calendar_id": "planned-outages", "job_ids": [ "total-requests" ] } ---- // TESTRESPONSE