Language

English Français 日本語 한국어 Español

Datadog Site

Site help
US1 US3 US5 EU AP1 US1-FED

On-Call

Configure your Datadog On-Call directly through the Datadog API.

Create on-call schedule

POST https://api.ap1.datadoghq.com/api/v2/on-call/scheduleshttps://api.datadoghq.eu/api/v2/on-call/scheduleshttps://api.ddog-gov.com/api/v2/on-call/scheduleshttps://api.datadoghq.com/api/v2/on-call/scheduleshttps://api.us3.datadoghq.com/api/v2/on-call/scheduleshttps://api.us5.datadoghq.com/api/v2/on-call/schedules

Overview

Create a new on-call schedule

Arguments

Query Strings

Name

Type

Description

include

string

Comma-separated list of included relationships to be returned. Allowed values: teams, layers, layers.members, layers.members.user.

Request

Body Data (required)

Expand All

Field

Type

Description

data [required]

object

The core data wrapper for creating a schedule, encompassing attributes, relationships, and the resource type.

attributes [required]

object

Describes the main attributes for creating a new schedule, including name, layers, time zone, and tags.

layers [required]

[object]

The layers of on-call coverage that define rotation intervals and restrictions.

effective_date [required]

date-time

The date/time when this layer becomes active (in ISO 8601).

end_date

date-time

The date/time after which this layer no longer applies (in ISO 8601).

interval [required]

object

Defines how frequently the rotation repeats, using days and/or seconds (up to certain limits).

days

int32

The number of full days in each rotation period.

seconds

int64

Extra seconds that may be added to extend the rotation beyond whole days.

members [required]

[object]

A list of members who participate in this layer's rotation.

user

object

Identifies the user participating in this layer as a single object with an id.

id

string

The user's ID.

name [required]

string

The name of this layer.

restrictions

[object]

Zero or more time-based restrictions (for example, only weekdays, during business hours).

end_day

enum

The weekday when the restriction period ends (Monday through Sunday). Allowed enum values: monday,tuesday,wednesday,thursday,friday,saturday,sunday

end_time

string

The time of day when the restriction ends (hh:mm:ss).

start_day

enum

The weekday when the restriction period starts (Monday through Sunday). Allowed enum values: monday,tuesday,wednesday,thursday,friday,saturday,sunday

start_time

string

The time of day when the restriction begins (hh:mm:ss).

rotation_start [required]

date-time

The date/time when the rotation for this layer starts (in ISO 8601).

name [required]

string

A human-readable name for the new schedule.

tags

[string]

A list of tags for categorizing or filtering the schedule.

time_zone [required]

string

The time zone in which the schedule is defined.

relationships

object

Gathers relationship objects for the schedule creation request, including the teams to associate.

teams

object

Associates the new schedule with one or more teams.

data

[object]

An array of team references for this schedule.

id

string

A unique identifier for the team.

type

enum

Teams resource type. Allowed enum values: teams

default: teams

type [required]

enum

Schedules resource type. Allowed enum values: schedules

default: schedules

{
  "data": {
    "attributes": {
      "layers": [
        {
          "effective_date": "2021-11-01T11:11:11+00:00",
          "end_date": "2021-11-21T11:11:11+00:00",
          "interval": {
            "days": 1
          },
          "members": [
            {
              "user": {
                "id": "string"
              }
            }
          ],
          "name": "Layer 1",
          "restrictions": [
            {
              "end_day": "friday",
              "end_time": "17:00:00",
              "start_day": "monday",
              "start_time": "09:00:00"
            }
          ],
          "rotation_start": "2021-11-06T11:11:11+00:00"
        }
      ],
      "name": "Example-On-Call",
      "tags": [
        "tag1",
        "tag2"
      ],
      "time_zone": "America/New_York"
    },
    "relationships": {
      "teams": {
        "data": [
          {
            "id": "00000000-7ea3-0000-000a-000000000000",
            "type": "teams"
          }
        ]
      }
    },
    "type": "schedules"
  }
}

Response

Created

Top-level container for a schedule object, including both the data payload and any related included resources (such as teams, layers, or members).

Expand All

Field

Type

Description

data

object

Represents the primary data object for a schedule, linking attributes and relationships.

attributes

object

Provides core properties of a schedule object, such as its name, time zone, and tags.

name

string

A short name for the schedule.

tags

[string]

A list of tags associated with this schedule.

time_zone

string

The time zone in which this schedule operates.

id

string

The schedule's unique identifier.

relationships

object

Groups the relationships for a schedule object, referencing layers and teams.

layers

object

Associates layers with this schedule in a data structure.

data

[object]

An array of layer references for this schedule.

id

string

The unique identifier of the layer in this relationship.

type

enum

Layers resource type. Allowed enum values: layers

default: layers

teams

object

Associates teams with this schedule in a data structure.

data

[object]

An array of team references for this schedule.

id

string

The unique identifier of the team in this relationship.

type

enum

Teams resource type. Allowed enum values: teams

default: teams

type

enum

Schedules resource type. Allowed enum values: schedules

default: schedules

included

[ <oneOf>]

Any additional resources related to this schedule, such as teams and layers.

Option 1

object

Provides a reference to a team, including ID, type, and basic attributes/relationships.

attributes

object

Encapsulates the basic attributes of a Team reference, such as name, handle, and an optional avatar or description.

avatar

string

URL or reference for the team's avatar (if available).

description

string

A short text describing the team.

handle

string

A unique handle/slug for the team.

name

string

The full, human-readable name of the team.

id

string

The team's unique identifier.

relationships

object

Collects the key relationship fields for a team reference, specifically on-call users.

oncall_users

object

Defines which users are on-call within a team, stored as an array of references.

data

[object]

The list of user references who are on-call for this team.

id

string

The unique identifier of the user.

type

enum

Users resource type. Allowed enum values: users

default: users

type

enum

Teams resource type. Allowed enum values: teams

default: teams

Option 2

object

Encapsulates a layer resource, holding attributes like rotation details, plus relationships to the members covering that layer.

attributes

object

Describes key properties of a Layer, including rotation details, name, start/end times, and any restrictions.

effective_date

date-time

When the layer becomes active (ISO 8601).

end_date

date-time

When the layer ceases to be active (ISO 8601).

interval

object

Defines how often the rotation repeats, using a combination of days and optional seconds.

days

int32

The number of days in each rotation cycle.

seconds

int64

Any additional seconds for the rotation cycle (up to 30 days).

name

string

The name of this layer.

restrictions

[object]

An optional list of time restrictions for when this layer is in effect.

end_day

enum

Defines the end day of the restriction within a Layer. Allowed enum values: monday,tuesday,wednesday,thursday,friday,saturday,sunday

end_time

string

The time of day the restriction ends (hh:mm:ss).

start_day

enum

Defines the start day of the restriction within a Layer. Allowed enum values: monday,tuesday,wednesday,thursday,friday,saturday,sunday

start_time

string

The time of day the restriction begins (hh:mm:ss).

rotation_start

date-time

The date/time when the rotation starts (ISO 8601).

id

string

A unique identifier for this layer.

relationships

object

Holds references to objects related to the Layer entity, such as its members.

members

object

Holds an array of references to the members of a Layer, each containing member IDs.

data

[object]

The list of members who belong to this layer.

id

string

The unique user ID of the layer member.

type

enum

Members resource type. Allowed enum values: members

default: members

type

enum

Layers resource type. Allowed enum values: layers

default: layers

Option 3

object

Represents a single member entry in a schedule, referencing a specific user.

id

string

The unique identifier for this schedule member.

relationships

object

Defines relationships for a schedule member, primarily referencing a single user.

user

object

Wraps the user data reference for a schedule member.

data

object

Points to the user data associated with this schedule member, including an ID and type.

id

string

The user's unique identifier.

type

enum

Users resource type. Allowed enum values: users

default: users

type

enum

Schedule Members resource type. Allowed enum values: members

default: members

Option 4

object

Represents a user object in the context of a schedule, including their id, type, and basic attributes.

attributes

object

Provides basic user information for a schedule, including a name and email address.

email

string

The user's email address.

name

string

The user's name.

id

string

The unique user identifier.

type

enum

Users resource type. Allowed enum values: users

default: users

{
  "data": {
    "attributes": {
      "name": "Primary On-Call",
      "tags": [],
      "time_zone": "America/New_York"
    },
    "id": "3653d3c6-0c75-11ea-ad28-fb5701eabc7d",
    "relationships": {
      "layers": {
        "data": [
          {
            "id": "67963b57-d67c-dfa7-b180-62ee9301d2f5",
            "type": "layers"
          }
        ]
      },
      "teams": {
        "data": [
          {
            "id": "00000000-da3a-0000-0000-000000000000",
            "type": "teams"
          }
        ]
      }
    },
    "type": "string"
  },
  "included": []
}

Bad Request

API error response.

Expand All

Field

Type

Description

errors [required]

[string]

A list of errors.

{
  "errors": [
    "Bad Request"
  ]
}

Unauthorized

API error response.

Expand All

Field

Type

Description

errors [required]

[string]

A list of errors.

{
  "errors": [
    "Bad Request"
  ]
}

Forbidden

API error response.

Expand All

Field

Type

Description

errors [required]

[string]

A list of errors.

{
  "errors": [
    "Bad Request"
  ]
}

Too many requests

API error response.

Expand All

Field

Type

Description

errors [required]

[string]

A list of errors.

{
  "errors": [
    "Bad Request"
  ]
}

Code Example

                          # Curl command
curl -X POST "https://api.ap1.datadoghq.com"https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.datadoghq.com"https://api.us3.datadoghq.com"https://api.us5.datadoghq.com/api/v2/on-call/schedules" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "layers": [
        {
          "effective_date": "2021-11-01T11:11:11+00:00",
          "end_date": "2021-11-21T11:11:11+00:00",
          "interval": {
            "days": 1
          },
          "members": [
            {
              "user": {
                "id": "string"
              }
            }
          ],
          "name": "Layer 1",
          "restrictions": [
            {
              "end_day": "friday",
              "end_time": "17:00:00",
              "start_day": "monday",
              "start_time": "09:00:00"
            }
          ],
          "rotation_start": "2021-11-06T11:11:11+00:00"
        }
      ],
      "name": "Example-On-Call",
      "tags": [
        "tag1",
        "tag2"
      ],
      "time_zone": "America/New_York"
    },
    "relationships": {
      "teams": {
        "data": [
          {
            "id": "00000000-7ea3-0000-000a-000000000000",
            "type": "teams"
          }
        ]
      }
    },
    "type": "schedules"
  }
}
EOF

Get on-call schedule

GET https://api.ap1.datadoghq.com/api/v2/on-call/schedules/{schedule_id}https://api.datadoghq.eu/api/v2/on-call/schedules/{schedule_id}https://api.ddog-gov.com/api/v2/on-call/schedules/{schedule_id}https://api.datadoghq.com/api/v2/on-call/schedules/{schedule_id}https://api.us3.datadoghq.com/api/v2/on-call/schedules/{schedule_id}https://api.us5.datadoghq.com/api/v2/on-call/schedules/{schedule_id}

Overview

Get an on-call schedule

Arguments

Path Parameters

Name

Type

Description

schedule_id [required]

string

The ID of the schedule

Query Strings

Name

Type

Description

include

string

Comma-separated list of included relationships to be returned. Allowed values: teams, layers, layers.members, layers.members.user.

Response

OK

Top-level container for a schedule object, including both the data payload and any related included resources (such as teams, layers, or members).

Expand All

Field

Type

Description

data

object

Represents the primary data object for a schedule, linking attributes and relationships.

attributes

object

Provides core properties of a schedule object, such as its name, time zone, and tags.

name

string

A short name for the schedule.

tags

[string]

A list of tags associated with this schedule.

time_zone

string

The time zone in which this schedule operates.

id

string

The schedule's unique identifier.

relationships

object

Groups the relationships for a schedule object, referencing layers and teams.

layers

object

Associates layers with this schedule in a data structure.

data

[object]

An array of layer references for this schedule.

id

string

The unique identifier of the layer in this relationship.

type

enum

Layers resource type. Allowed enum values: layers

default: layers

teams

object

Associates teams with this schedule in a data structure.

data

[object]

An array of team references for this schedule.

id

string

The unique identifier of the team in this relationship.

type

enum

Teams resource type. Allowed enum values: teams

default: teams

type

enum

Schedules resource type. Allowed enum values: schedules

default: schedules

included

[ <oneOf>]

Any additional resources related to this schedule, such as teams and layers.

Option 1

object

Provides a reference to a team, including ID, type, and basic attributes/relationships.

attributes

object

Encapsulates the basic attributes of a Team reference, such as name, handle, and an optional avatar or description.

avatar

string

URL or reference for the team's avatar (if available).

description

string

A short text describing the team.

handle

string

A unique handle/slug for the team.

name

string

The full, human-readable name of the team.

id

string

The team's unique identifier.

relationships

object

Collects the key relationship fields for a team reference, specifically on-call users.

oncall_users

object

Defines which users are on-call within a team, stored as an array of references.

data

[object]

The list of user references who are on-call for this team.

id

string

The unique identifier of the user.

type

enum

Users resource type. Allowed enum values: users

default: users

type

enum

Teams resource type. Allowed enum values: teams

default: teams

Option 2

object

Encapsulates a layer resource, holding attributes like rotation details, plus relationships to the members covering that layer.

attributes

object

Describes key properties of a Layer, including rotation details, name, start/end times, and any restrictions.

effective_date

date-time

When the layer becomes active (ISO 8601).

end_date

date-time

When the layer ceases to be active (ISO 8601).

interval

object

Defines how often the rotation repeats, using a combination of days and optional seconds.

days

int32

The number of days in each rotation cycle.

seconds

int64

Any additional seconds for the rotation cycle (up to 30 days).

name

string

The name of this layer.

restrictions

[object]

An optional list of time restrictions for when this layer is in effect.

end_day

enum

Defines the end day of the restriction within a Layer. Allowed enum values: monday,tuesday,wednesday,thursday,friday,saturday,sunday

end_time

string

The time of day the restriction ends (hh:mm:ss).

start_day

enum

Defines the start day of the restriction within a Layer. Allowed enum values: monday,tuesday,wednesday,thursday,friday,saturday,sunday

start_time

string

The time of day the restriction begins (hh:mm:ss).

rotation_start

date-time

The date/time when the rotation starts (ISO 8601).

id

string

A unique identifier for this layer.

relationships

object

Holds references to objects related to the Layer entity, such as its members.

members

object

Holds an array of references to the members of a Layer, each containing member IDs.

data

[object]

The list of members who belong to this layer.

id

string

The unique user ID of the layer member.

type

enum

Members resource type. Allowed enum values: members

default: members

type

enum

Layers resource type. Allowed enum values: layers

default: layers

Option 3

object

Represents a single member entry in a schedule, referencing a specific user.

id

string

The unique identifier for this schedule member.

relationships

object

Defines relationships for a schedule member, primarily referencing a single user.

user

object

Wraps the user data reference for a schedule member.

data

object

Points to the user data associated with this schedule member, including an ID and type.

id

string

The user's unique identifier.

type

enum

Users resource type. Allowed enum values: users

default: users

type

enum

Schedule Members resource type. Allowed enum values: members

default: members

Option 4

object

Represents a user object in the context of a schedule, including their id, type, and basic attributes.

attributes

object

Provides basic user information for a schedule, including a name and email address.

email

string

The user's email address.

name

string

The user's name.

id

string

The unique user identifier.

type

enum

Users resource type. Allowed enum values: users

default: users

{
  "data": {
    "attributes": {
      "name": "Primary On-Call",
      "tags": [],
      "time_zone": "America/New_York"
    },
    "id": "3653d3c6-0c75-11ea-ad28-fb5701eabc7d",
    "relationships": {
      "layers": {
        "data": [
          {
            "id": "67963b57-d67c-dfa7-b180-62ee9301d2f5",
            "type": "layers"
          }
        ]
      },
      "teams": {
        "data": [
          {
            "id": "00000000-da3a-0000-0000-000000000000",
            "type": "teams"
          }
        ]
      }
    },
    "type": "string"
  },
  "included": []
}

Unauthorized

API error response.

Expand All

Field

Type

Description

errors [required]

[string]

A list of errors.

{
  "errors": [
    "Bad Request"
  ]
}

Forbidden

API error response.

Expand All

Field

Type

Description

errors [required]

[string]

A list of errors.

{
  "errors": [
    "Bad Request"
  ]
}

Not Found

API error response.

Expand All

Field

Type

Description

errors [required]

[string]

A list of errors.

{
  "errors": [
    "Bad Request"
  ]
}

Too many requests

API error response.

Expand All

Field

Type

Description

errors [required]

[string]

A list of errors.

{
  "errors": [
    "Bad Request"
  ]
}

Code Example

                  # Path parameters
export schedule_id="3653d3c6-0c75-11ea-ad28-fb5701eabc7d"
# Curl command
curl -X GET "https://api.ap1.datadoghq.com"https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.datadoghq.com"https://api.us3.datadoghq.com"https://api.us5.datadoghq.com/api/v2/on-call/schedules/${schedule_id}" \
-H "Accept: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}"

Delete on-call schedule

DELETE https://api.ap1.datadoghq.com/api/v2/on-call/schedules/{schedule_id}https://api.datadoghq.eu/api/v2/on-call/schedules/{schedule_id}https://api.ddog-gov.com/api/v2/on-call/schedules/{schedule_id}https://api.datadoghq.com/api/v2/on-call/schedules/{schedule_id}https://api.us3.datadoghq.com/api/v2/on-call/schedules/{schedule_id}https://api.us5.datadoghq.com/api/v2/on-call/schedules/{schedule_id}

Overview

Delete an on-call schedule

Arguments

Path Parameters

Name

Type

Description

schedule_id [required]

string

The ID of the schedule

Response

No Content

Unauthorized

API error response.

Expand All

Field

Type

Description

errors [required]

[string]

A list of errors.

{
  "errors": [
    "Bad Request"
  ]
}

Forbidden

API error response.

Expand All

Field

Type

Description

errors [required]

[string]

A list of errors.

{
  "errors": [
    "Bad Request"
  ]
}

Not Found

API error response.

Expand All

Field

Type

Description

errors [required]

[string]

A list of errors.

{
  "errors": [
    "Bad Request"
  ]
}

Too many requests

API error response.

Expand All

Field

Type

Description

errors [required]

[string]

A list of errors.

{
  "errors": [
    "Bad Request"
  ]
}

Code Example

                  # Path parameters
export schedule_id="3653d3c6-0c75-11ea-ad28-fb5701eabc7d"
# Curl command
curl -X DELETE "https://api.ap1.datadoghq.com"https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.datadoghq.com"https://api.us3.datadoghq.com"https://api.us5.datadoghq.com/api/v2/on-call/schedules/${schedule_id}" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}"

Update on-call schedule

PUT https://api.ap1.datadoghq.com/api/v2/on-call/schedules/{schedule_id}https://api.datadoghq.eu/api/v2/on-call/schedules/{schedule_id}https://api.ddog-gov.com/api/v2/on-call/schedules/{schedule_id}https://api.datadoghq.com/api/v2/on-call/schedules/{schedule_id}https://api.us3.datadoghq.com/api/v2/on-call/schedules/{schedule_id}https://api.us5.datadoghq.com/api/v2/on-call/schedules/{schedule_id}

Overview

Update a new on-call schedule

Arguments

Path Parameters

Name

Type

Description

schedule_id [required]

string

The ID of the schedule

Query Strings

Name

Type

Description

include

string

Comma-separated list of included relationships to be returned. Allowed values: teams, layers, layers.members, layers.members.user.

Request

Body Data (required)

Expand All

Field

Type

Description

data [required]

object

Contains all data needed to update an existing schedule, including its attributes (such as name, layers, or tags) and any relationships to teams.

attributes [required]

object

Defines the updatable attributes for a schedule, such as name, time zone, tags, and layers.

layers [required]

[object]

The updated list of layers (rotations) for this schedule.

effective_date

date-time

When this updated layer takes effect (ISO 8601 format).

end_date

date-time

When this updated layer should stop being active (ISO 8601 format).

id

string

A unique identifier for the layer being updated.

interval

object

Specifies how the rotation repeats: number of days, plus optional seconds, up to the given maximums.

days

int32

How many days each rotation cycle should span.

seconds

int64

Additional seconds to add to the rotation cycle (for example, partial days).

members

[object]

The members assigned to this layer.

user

object

Identifies the user who is assigned to this member object. Only id is required.

id

string

The user's ID.

name

string

The name for this layer (for example, “Secondary Coverage”).

restrictions

[object]

Any time restrictions that define when this layer is active.

end_day

enum

Defines the day of the week on which the time restriction ends. Allowed enum values: monday,tuesday,wednesday,thursday,friday,saturday,sunday

end_time

string

The time at which this restriction ends (hh:mm:ss).

start_day

enum

Defines the day of the week on which the time restriction starts. Allowed enum values: monday,tuesday,wednesday,thursday,friday,saturday,sunday

start_time

string

The time at which this restriction starts (hh:mm:ss).

rotation_start

date-time

The date/time at which the rotation begins (ISO 8601 format).

name [required]

string

A short name for the schedule.

tags

[string]

A list of tags that you can associate with this schedule.

time_zone [required]

string

The time zone used when interpreting rotation times.

id [required]

string

The ID of the schedule to be updated.

relationships

object

Houses relationships for the schedule update, typically referencing teams.

teams

object

Defines the teams that this schedule update is associated with.

data

[object]

An array of team references.

id

string

The unique team identifier.

type

enum

Teams resource type. Allowed enum values: teams

default: teams

type [required]

enum

Schedules resource type. Allowed enum values: schedules

default: schedules

{
  "data": {
    "id": "3653d3c6-0c75-11ea-ad28-fb5701eabc7d",
    "attributes": {
      "layers": [
        {
          "id": "67963b57-d67c-dfa7-b180-62ee9301d2f5",
          "effective_date": "2021-11-01T11:11:11+00:00",
          "end_date": "2021-11-21T11:11:11+00:00",
          "interval": {
            "seconds": 300
          },
          "members": [
            {
              "user": {
                "id": "string"
              }
            }
          ],
          "name": "Layer 1",
          "restrictions": [
            {
              "end_day": "friday",
              "end_time": "17:00:00",
              "start_day": "monday",
              "start_time": "09:00:00"
            }
          ],
          "rotation_start": "2021-11-06T11:11:11+00:00"
        }
      ],
      "name": "Example-On-Call",
      "tags": [
        "tag1",
        "tag2",
        "tag3"
      ],
      "time_zone": "America/New_York"
    },
    "relationships": {
      "teams": {
        "data": [
          {
            "id": "00000000-7ea3-0000-000a-000000000000",
            "type": "teams"
          }
        ]
      }
    },
    "type": "schedules"
  }
}

Response

OK

Top-level container for a schedule object, including both the data payload and any related included resources (such as teams, layers, or members).

Expand All

Field

Type

Description

data

object

Represents the primary data object for a schedule, linking attributes and relationships.

attributes

object

Provides core properties of a schedule object, such as its name, time zone, and tags.

name

string

A short name for the schedule.

tags

[string]

A list of tags associated with this schedule.

time_zone

string

The time zone in which this schedule operates.

id

string

The schedule's unique identifier.

relationships

object

Groups the relationships for a schedule object, referencing layers and teams.

layers

object

Associates layers with this schedule in a data structure.

data

[object]

An array of layer references for this schedule.

id

string

The unique identifier of the layer in this relationship.

type

enum

Layers resource type. Allowed enum values: layers

default: layers

teams

object

Associates teams with this schedule in a data structure.

data

[object]

An array of team references for this schedule.

id

string

The unique identifier of the team in this relationship.

type

enum

Teams resource type. Allowed enum values: teams

default: teams

type

enum

Schedules resource type. Allowed enum values: schedules

default: schedules

included

[ <oneOf>]

Any additional resources related to this schedule, such as teams and layers.

Option 1

object

Provides a reference to a team, including ID, type, and basic attributes/relationships.

attributes

object

Encapsulates the basic attributes of a Team reference, such as name, handle, and an optional avatar or description.

avatar

string

URL or reference for the team's avatar (if available).

description

string

A short text describing the team.

handle

string

A unique handle/slug for the team.

name

string

The full, human-readable name of the team.

id

string

The team's unique identifier.

relationships

object

Collects the key relationship fields for a team reference, specifically on-call users.

oncall_users

object

Defines which users are on-call within a team, stored as an array of references.

data

[object]

The list of user references who are on-call for this team.

id

string

The unique identifier of the user.

type

enum

Users resource type. Allowed enum values: users

default: users

type

enum

Teams resource type. Allowed enum values: teams

default: teams

Option 2

object

Encapsulates a layer resource, holding attributes like rotation details, plus relationships to the members covering that layer.

attributes

object

Describes key properties of a Layer, including rotation details, name, start/end times, and any restrictions.

effective_date

date-time

When the layer becomes active (ISO 8601).

end_date

date-time

When the layer ceases to be active (ISO 8601).

interval

object

Defines how often the rotation repeats, using a combination of days and optional seconds.

days

int32

The number of days in each rotation cycle.

seconds

int64

Any additional seconds for the rotation cycle (up to 30 days).

name

string

The name of this layer.

restrictions

[object]

An optional list of time restrictions for when this layer is in effect.

end_day

enum

Defines the end day of the restriction within a Layer. Allowed enum values: monday,tuesday,wednesday,thursday,friday,saturday,sunday

end_time

string

The time of day the restriction ends (hh:mm:ss).

start_day

enum

Defines the start day of the restriction within a Layer. Allowed enum values: monday,tuesday,wednesday,thursday,friday,saturday,sunday

start_time

string

The time of day the restriction begins (hh:mm:ss).

rotation_start

date-time

The date/time when the rotation starts (ISO 8601).

id

string

A unique identifier for this layer.

relationships

object

Holds references to objects related to the Layer entity, such as its members.

members

object

Holds an array of references to the members of a Layer, each containing member IDs.

data

[object]

The list of members who belong to this layer.

id

string

The unique user ID of the layer member.

type

enum

Members resource type. Allowed enum values: members

default: members

type

enum

Layers resource type. Allowed enum values: layers

default: layers

Option 3

object

Represents a single member entry in a schedule, referencing a specific user.

id

string

The unique identifier for this schedule member.

relationships

object

Defines relationships for a schedule member, primarily referencing a single user.

user

object

Wraps the user data reference for a schedule member.

data

object

Points to the user data associated with this schedule member, including an ID and type.

id

string

The user's unique identifier.

type

enum

Users resource type. Allowed enum values: users

default: users

type

enum

Schedule Members resource type. Allowed enum values: members

default: members

Option 4

object

Represents a user object in the context of a schedule, including their id, type, and basic attributes.

attributes

object

Provides basic user information for a schedule, including a name and email address.

email

string

The user's email address.

name

string

The user's name.

id

string

The unique user identifier.

type

enum

Users resource type. Allowed enum values: users

default: users

{
  "data": {
    "attributes": {
      "name": "Primary On-Call",
      "tags": [],
      "time_zone": "America/New_York"
    },
    "id": "3653d3c6-0c75-11ea-ad28-fb5701eabc7d",
    "relationships": {
      "layers": {
        "data": [
          {
            "id": "67963b57-d67c-dfa7-b180-62ee9301d2f5",
            "type": "layers"
          }
        ]
      },
      "teams": {
        "data": [
          {
            "id": "00000000-da3a-0000-0000-000000000000",
            "type": "teams"
          }
        ]
      }
    },
    "type": "string"
  },
  "included": []
}

Bad Request

API error response.

Expand All

Field

Type

Description

errors [required]

[string]

A list of errors.

{
  "errors": [
    "Bad Request"
  ]
}

Unauthorized

API error response.

Expand All

Field

Type

Description

errors [required]

[string]

A list of errors.

{
  "errors": [
    "Bad Request"
  ]
}

Forbidden

API error response.

Expand All

Field

Type

Description

errors [required]

[string]

A list of errors.

{
  "errors": [
    "Bad Request"
  ]
}

Not Found

API error response.

Expand All

Field

Type

Description

errors [required]

[string]

A list of errors.

{
  "errors": [
    "Bad Request"
  ]
}

Too many requests

API error response.

Expand All

Field

Type

Description

errors [required]

[string]

A list of errors.

{
  "errors": [
    "Bad Request"
  ]
}

Code Example

                          # Path parameters
export schedule_id="3653d3c6-0c75-11ea-ad28-fb5701eabc7d"
# Curl command
curl -X PUT "https://api.ap1.datadoghq.com"https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.datadoghq.com"https://api.us3.datadoghq.com"https://api.us5.datadoghq.com/api/v2/on-call/schedules/${schedule_id}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}" \
-d @- << EOF
{
  "data": {
    "id": "3653d3c6-0c75-11ea-ad28-fb5701eabc7d",
    "attributes": {
      "layers": [
        {
          "id": "67963b57-d67c-dfa7-b180-62ee9301d2f5",
          "effective_date": "2021-11-01T11:11:11+00:00",
          "end_date": "2021-11-21T11:11:11+00:00",
          "interval": {
            "seconds": 300
          },
          "members": [
            {
              "user": {
                "id": "string"
              }
            }
          ],
          "name": "Layer 1",
          "restrictions": [
            {
              "end_day": "friday",
              "end_time": "17:00:00",
              "start_day": "monday",
              "start_time": "09:00:00"
            }
          ],
          "rotation_start": "2021-11-06T11:11:11+00:00"
        }
      ],
      "name": "Example-On-Call",
      "tags": [
        "tag1",
        "tag2",
        "tag3"
      ],
      "time_zone": "America/New_York"
    },
    "relationships": {
      "teams": {
        "data": [
          {
            "id": "00000000-7ea3-0000-000a-000000000000",
            "type": "teams"
          }
        ]
      }
    },
    "type": "schedules"
  }
}
EOF