View as Markdown
Statuspage icon

Statuspage ACTION

Create Maintenance

Creates a scheduled maintenance incident in Statuspage. See the documentation
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Statuspage account once, then configure and run Create Maintenance from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "statuspage-create-maintenance",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    statuspage: { authProvisionId: "apn_xxxxxxx" },
    pageId: "Page ID",
    name: "Name",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Create Maintenance inputs
Property Type Description
pageId Page ID string
The ID of the page
Required Dynamic
name Name string
The name of the scheduled maintenance
Required
body Body string
The body of the scheduled maintenance
Required
scheduledFor Scheduled For string
The ISO 8601 datetime when the maintenance is scheduled to start (e.g. 2024-01-15T10:00:00.000Z)
Required
scheduledUntil Scheduled Until string
The ISO 8601 datetime when the maintenance is scheduled to end (e.g. 2024-01-15T12:00:00.000Z)
Required
componentIds Component IDs string[]
The IDs of the components affected by this maintenance
Optional Dynamic
deliverNotifications Deliver Notifications boolean
Whether to deliver notifications for this scheduled maintenance
Optional
scheduledRemindPrior Scheduled Remind Prior boolean
Whether to remind subscribers prior to the maintenance
Optional
scheduledAutoInProgress Scheduled Auto In Progress boolean
Whether to automatically transition to in progress at the scheduled start time
Optional
autoTransitionDeliverNotificationsAtStart Auto Transition Deliver Notifications At Start boolean
Whether to deliver notifications when transitioning to in progress
Optional
autoTransitionToMaintenanceState Auto Transition To Maintenance State boolean
Whether to automatically transition components to maintenance state at start
Optional
scheduledAutoCompleted Scheduled Auto Completed boolean
Whether to automatically complete the maintenance at the scheduled end time
Optional
autoTransitionDeliverNotificationsAtEnd Auto Transition Deliver Notifications At End boolean
Whether to deliver notifications when completing the maintenance
Optional
autoTransitionToOperationalState Auto Transition To Operational State boolean
Whether to automatically transition components back to operational state at end
Optional
autoTweetOnCreation Auto Tweet On Creation boolean
Whether to automatically tweet when the maintenance is created
Optional
autoTweetOneHourBefore Auto Tweet One Hour Before boolean
Whether to automatically tweet one hour before the maintenance starts
Optional
autoTweetAtBeginning Auto Tweet At Beginning boolean
Whether to automatically tweet when the maintenance begins
Optional
autoTweetOnCompletion Auto Tweet On Completion boolean
Whether to automatically tweet when the maintenance is completed
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
statuspage-create-maintenance
Version
0.0.1
App
Statuspage
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes