ATatlassian
Schedule on-calls

List next on-call responders

Lists the next on-call responders at a specific time for the schedule with given id in the request.<br> <br> Permissions required: Permission to access to the schedule:

  • the user has read-only administrative right.
  • the schedule's assigned team is one of the teams that the user belongs to.
  • the user is added to a rotation of the schedule as a responder.
  • a team is added to a rotation of the schedule as a responder, and the user is a member of this team.
  • an escalation is added to a rotation of the schedule as a responder, and the user is a member of this escalation.
  • there is an override to the user in the schedule.
get/api/{cloudId}/v1/schedules/{scheduleId}/next-on-calls

Request

  • Base URL
    https://api.atlassian.com/jsm/ops
  • URL
    https://api.atlassian.com/jsm/ops/api/{cloudId}/v1/schedules/{scheduleId}/next-on-calls
  • Auth
    • HTTP basic
    • or OAuth 2
      Authorization code: https://auth.stg.atlassian.com/authorize
      Token URL: https://auth.stg.atlassian.com/oauth/token scopes: read:ops-config:jira-service-management

Path parameters

scheduleIdstring required

ID of the schedule.

Query parameters

flatboolean

When enabled, returns only the user names of all next on-call participants in user type. Otherwise, returns the complete flattening tree for next on-calls.

datestring date-time

The date for which the schedule's next on-calls are requested.

Response

Returned if the request is successful.

OR

Changes

No recorded changes to this operation across all 5 revisions of this API.