OpenSearch/docs/java-rest/high-level/ml/post-calendar-event.asciidoc

41 lines
1.2 KiB
Plaintext

--
:api: post-calendar-event
:request: PostCalendarEventRequest
:response: PostCalendarEventResponse
--
[role="xpack"]
[id="{upid}-{api}"]
=== Post calendar events API
Adds new ScheduledEvents to an existing {ml} calendar.
The API accepts a +{request}+ and responds
with a +{response}+ object.
[id="{upid}-{api}-request"]
==== Post calendar events request
A +{request}+ is constructed with a calendar ID object
and a non-empty list of scheduled events.
["source","java",subs="attributes,callouts,macros"]
--------------------------------------------------
include-tagged::{doc-tests-file}[{api}-request]
--------------------------------------------------
<1> Non-null existing calendar ID
<2> Non-null, non-empty collection of `ScheduledEvent` objects
[id="{upid}-{api}-response"]
==== Post calendar events response
The returned +{response}+ contains the added `ScheduledEvent` objects:
["source","java",subs="attributes,callouts,macros"]
--------------------------------------------------
include-tagged::{doc-tests-file}[{api}-response]
--------------------------------------------------
<1> The `ScheduledEvent` objects that were added to the calendar
include::../execution.asciidoc[]