OPopenobserve
OnCall

Arrange cover for a bounded window

post/api/{org_id}/oncall/teams/{team_id}/overrides

Request

Path parameters

org_idstring required

Organization name

team_idstring required

Team ID

Request body

covering_forstring nullable

Optional: "cover tonight" is real even before whose shift tonight is has been worked out.

end_atinteger required

Micros, exclusive — a cover ending exactly when the next begins does not overlap it.

reasonstring nullable
rotation_idstring nullable

Omitted means the primary; an unknown rotation is refused, or a cover staffs nothing.

start_atinteger required

Micros, inclusive.

user_emailstring required

Must be a user of this org: an override outranks every layer, so a bad address is no pager.

Response

Success

covering_forstring nullable

Who is being covered. Optional: "cover tonight" is a real request even when nobody has worked out whose shift tonight is.

created_atinteger required
created_bystring required
end_atinteger required

Exclusive, so two back-to-back overrides never both cover the instant between them — the same rule the handover boundary follows.

idstring required
org_idstring required
reasonstring nullable
rotation_idstring required

Which rotation is being covered.

A cover stands in for one position. Covering two of them is two covers, said out loud, rather than one that silently lands the same person in both.

start_atinteger required

Inclusive.

team_idstring required
user_emailstring required

Who is actually holding the pager for this window.

Changes

No recorded changes to this operation across all 1 revision of this API.