PAGERDUTY_CREATE_OR_UPDATE_STATUS_PAGE_POST

Creates a new post on a specified PagerDuty Status Page. This endpoint allows you to publish information about incidents or scheduled maintenance, including details such as the post type, timing, and associated updates. Use this to communicate service status, planned downtime, or ongoing issues to your users or customers. The post can include multiple updates, each with its own message, severity, and impact on specific services. This is particularly useful for providing real-time information during incidents or for scheduling and describing maintenance windows.

Available from 1 provider (1 remote)

Input Schema

            {
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "title": "Id",
      "description": "The ID of the resource."
    },
    "post__type": {
      "enum": [
        "status_page_post"
      ],
      "type": "string",
      "title": "Post  Type",
      "description": "The type of the object returned by the API - in this case, a Status Page Post. "
    },
    "post__title": {
      "type": "string",
      "title": "Post  Title",
      "description": "The title given to a Post."
    },
    "post__updates": {
      "type": "array",
      "items": {
        "type": "object",
        "title": "UpdatesRequest",
        "required": [
          "message",
          "impacted_services",
          "update_frequency_ms",
          "notify_subscribers",
          "type"
        ],
        "properties": {
          "self": {
            "type": "string",
            "title": "Self",
            "description": "The path to which the Post Update resource is accessible."
          },
          "type": {
            "type": "string",
            "title": "Type",
            "description": "The type of the object returned by the API - in this case, a Status Page Post Update. "
          },
          "message": {
            "type": "string",
            "title": "Message",
            "description": "The message of the Post Update."
          },
          "post__id": {
            "type": "string",
            "title": "Post  Id",
            "description": "Status page post unique identifier"
          },
          "post__type": {
            "type": "string",
            "title": "Post  Type",
            "description": "A string that determines the schema of the object."
          },
          "status__id": {
            "type": "string",
            "title": "Status  Id",
            "description": "Status page Status unique identifier"
          },
          "reported_at": {
            "type": "string",
            "title": "Reported At",
            "format": "date-time",
            "description": "The date and time the Post Update was reported."
          },
          "severity__id": {
            "type": "string",
            "title": "Severity  Id",
            "description": "Status page Severity unique identifier"
          },
          "status__type": {
            "type": "string",
            "title": "Status  Type",
            "description": "A string that determines the schema of the object."
          },
          "severity__type": {
            "type": "string",
            "title": "Severity  Type",
            "description": "A string that determines the schema of the object."
          },
          "impacted_services": {
            "type": "array",
            "items": {
              "type": "object",
              "title": "ImpactedServicesRequest",
              "properties": {
                "impact__id": {
                  "type": "string",
                  "title": "Impact  Id",
                  "description": "An unique identifier within Status Page scope that defines a Status Page Impact entry. "
                },
                "service__id": {
                  "type": "string",
                  "title": "Service  Id",
                  "description": "An unique identifier within Status Page scope that defines a Service entry. "
                },
                "impact__type": {
                  "type": "string",
                  "title": "Impact  Type",
                  "description": "The type of the object returned by the API - in this case, a Status Page Impact. "
                },
                "service__type": {
                  "type": "string",
                  "title": "Service  Type",
                  "description": "The type of the object returned by the API - in this case, a Status Page Service. "
                }
              },
              "description": "Request schema for `ImpactedServices`"
            },
            "title": "Impacted Services",
            "description": "Impacted services represent the status page services affected by a post update, and its impact. "
          },
          "notify_subscribers": {
            "type": "boolean",
            "title": "Notify Subscribers",
            "description": "Determines if the subscribers should be notified of the Post Update."
          },
          "update_frequency_ms": {
            "type": "integer",
            "title": "Update Frequency Ms",
            "description": "The frequency of the next Post Update in milliseconds."
          }
        },
        "description": "Request schema for `Updates`"
      },
      "title": "Post  Updates",
      "description": "Post Updates to be associated with a Post"
    },
    "post__ends__at": {
      "type": "string",
      "title": "Post  Ends  At",
      "format": "date-time",
      "description": "The date and time the Post intent is concluded - only for maintenance post type. "
    },
    "post__post__type": {
      "enum": [
        "incident",
        "maintenance"
      ],
      "type": "string",
      "title": "Post  Post  Type",
      "description": "The type of the Post."
    },
    "post__starts__at": {
      "type": "string",
      "title": "Post  Starts  At",
      "format": "date-time",
      "description": "The date and time the Post intent becomes effective - only for maintenance post type. "
    },
    "post__status__page__id": {
      "type": "string",
      "title": "Post  Status  Page  Id",
      "description": "Status page unique identifier"
    },
    "post__status__page__type": {
      "type": "string",
      "title": "Post  Status  Page  Type",
      "description": "A string that determines the schema of the object."
    }
  }
}