---
title: "Create Incident Episode"
method: POST
path: "/incident-episode"
tags: ["Incident Episode"]
---

# Create Incident Episode

`POST /incident-episode`

## Request

- Base URL: `https://oneuptime.com/api`
- URL: `https://oneuptime.com/api/incident-episode`
- Auth: API key in header `APIKey`
- TypeScript: <https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification/docs/incident-episode/post.ts> (a function with typed inputs; its response is checked against the schema)

Endpoint to create a new Incident Episode

## Request body

- object
  - `data` IncidentEpisodeCreateSchema, required: Create schema for IncidentEpisode model. Create
    - `projectId` string, uuid: ID of your OneUptime Project in which this object belongs. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [No access - you don't have permission for this operation]
    - `title` string, required: Title of this incident episode. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Edit Incident Episode]
    - `description` string: Description of this incident episode. This is in markdown format. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Edit Incident Episode]
    - `episodeNumber` number: Auto-incrementing episode number per project. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [No access - you don't have permission for this operation]
    - `currentIncidentStateId` string, uuid: Current Incident State ID. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Edit Incident Episode]
    - `incidentSeverityId` string, uuid: Incident Severity ID. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Edit Incident Episode]
    - `rootCause` string: User-documented root cause of this episode. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Edit Incident Episode]
    - `lastIncidentAddedAt` object: When the last incident was added to this episode. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Edit Incident Episode]
    - `resolvedAt` object: When this episode was resolved. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Edit Incident Episode]
    - `assignedToUserId` string, uuid: User ID who is assigned to this episode. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Edit Incident Episode]
    - `assignedToTeamId` string, uuid: Team ID that is assigned to this episode. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Edit Incident Episode]
    - `onCallDutyPolicies` object[]: List of on-call duty policies to execute for this episode. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Edit Incident Episode]
      - `id` string
    - `titleTemplate` string: Template used to generate the episode title. Stored for dynamic variable updates. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [No access - you don't have permission for this operation]
    - `descriptionTemplate` string: Template used to generate the episode description. Stored for dynamic variable updates. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [No access - you don't have permission for this operation]
    - `isManuallyCreated` boolean: Whether this episode was manually created vs auto-created by a rule. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [No access - you don't have permission for this operation]
    - `labels` object[]: Labels to group and filter by. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Edit Incident Episode]
      - `id` string
    - `groupingKey` string: Key used for grouping incidents into this episode. Generated from groupByFields of the matching rule. When a private incident opened the episode, its title is in the key only as a keyed hash. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [No access - you don't have permission for this operation]
    - `incidentGroupingRuleId` string, uuid: ID of the Incident Grouping Rule that created this episode (if applicable). Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [No access - you don't have permission for this operation]
    - `remediationNotes` string: User-documented remediation steps and notes for this episode. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Edit Incident Episode]
    - `postmortemNote` string: User-documented postmortem summary for this episode. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Edit Incident Episode]
    - `postUpdatesToWorkspaceChannels` object: Workspace channels to post episode updates to (e.g., Slack, Microsoft Teams). Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Edit Incident Episode]
    - `isVisibleOnStatusPage` boolean: Should this episode be visible on the status page? Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Edit Incident Episode]
    - `declaredAt` object: When this episode was declared. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Edit Incident Episode]
    - `shouldStatusPageSubscribersBeNotifiedOnEpisodeCreated` boolean: Should status page subscribers be notified when this episode is created? Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [No access - you don't have permission for this operation]
    - `isPrivate` boolean: If true, this incident episode is only visible to its owners (users in 'owner users' and members of 'owner teams'), project admins, and project owners. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Edit Incident Episode]

## Response `201`

Created successfully

- object
  - `data` IncidentEpisodeReadSchema: Read schema for IncidentEpisode model. Read
    - `_id` string, uuid: ID of this object. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Edit Incident Episode]
    - `createdAt` object: Date and Time when the object was created. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Edit Incident Episode]
    - `updatedAt` object: Date and Time when the object was updated. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Edit Incident Episode]
    - `deletedAt` object: Date and Time when the object was deleted. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Edit Incident Episode]
    - `projectId` string, uuid: ID of your OneUptime Project in which this object belongs. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [No access - you don't have permission for this operation]
    - `title` string, required: Title of this incident episode. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Edit Incident Episode]
    - `description` string: Description of this incident episode. This is in markdown format. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Edit Incident Episode]
    - `episodeNumber` number: Auto-incrementing episode number per project. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [No access - you don't have permission for this operation]
    - `episodeNumberWithPrefix` string: Episode number with prefix (e.g., 'IE-42' or '#42'). Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [No access - you don't have permission for this operation]
    - `currentIncidentStateId` string, uuid: Current Incident State ID. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Edit Incident Episode]
    - `incidentSeverityId` string, uuid: Incident Severity ID. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Edit Incident Episode]
    - `rootCause` string: User-documented root cause of this episode. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Edit Incident Episode]
    - `lastIncidentAddedAt` object: When the last incident was added to this episode. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Edit Incident Episode]
    - `resolvedAt` object: When this episode was resolved. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Edit Incident Episode]
    - `allIncidentsResolvedAt` object: When all incidents in this episode were first detected as resolved. Used for resolve delay calculation. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [No access - you don't have permission for this operation]
    - `firstPagedAt` object: When an on-call policy or a direct page first notified someone about this episode. Empty until someone is paged. Set by OneUptime. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [No access - you don't have permission for this operation]
    - `assignedToUserId` string, uuid: User ID who is assigned to this episode. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Edit Incident Episode]
    - `assignedToTeamId` string, uuid: Team ID that is assigned to this episode. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Edit Incident Episode]
    - `onCallDutyPolicies` object[]: List of on-call duty policies to execute for this episode. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Edit Incident Episode]
      - `id` string
    - `isOnCallPolicyExecuted` boolean: Whether the on-call policy has been executed for this episode. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [No access - you don't have permission for this operation]
    - `incidentCount` number: Denormalized count of incidents in this episode. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [No access - you don't have permission for this operation]
    - `titleTemplate` string: Template used to generate the episode title. Stored for dynamic variable updates. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [No access - you don't have permission for this operation]
    - `descriptionTemplate` string: Template used to generate the episode description. Stored for dynamic variable updates. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [No access - you don't have permission for this operation]
    - `isManuallyCreated` boolean: Whether this episode was manually created vs auto-created by a rule. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [No access - you don't have permission for this operation]
    - `labels` object[]: Labels to group and filter by. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Edit Incident Episode]
      - `id` string
    - `createdByUserId` string, uuid: User ID who created this object (if this object was created by a User). Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [No access - you don't have permission for this operation]
    - `isOwnerNotifiedOfEpisodeCreation` boolean: Are owners notified when this episode is created? Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [No access - you don't have permission for this operation]
    - `groupingKey` string: Key used for grouping incidents into this episode. Generated from groupByFields of the matching rule. When a private incident opened the episode, its title is in the key only as a keyed hash. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [No access - you don't have permission for this operation]
    - `incidentGroupingRuleId` string, uuid: ID of the Incident Grouping Rule that created this episode (if applicable). Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [No access - you don't have permission for this operation]
    - `remediationNotes` string: User-documented remediation steps and notes for this episode. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Edit Incident Episode]
    - `postmortemNote` string: User-documented postmortem summary for this episode. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Edit Incident Episode]
    - `postUpdatesToWorkspaceChannels` object: Workspace channels to post episode updates to (e.g., Slack, Microsoft Teams). Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Edit Incident Episode]
    - `isVisibleOnStatusPage` boolean: Should this episode be visible on the status page? Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Edit Incident Episode]
    - `declaredAt` object: When this episode was declared. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Edit Incident Episode]
    - `shouldStatusPageSubscribersBeNotifiedOnEpisodeCreated` boolean: Should status page subscribers be notified when this episode is created? Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [No access - you don't have permission for this operation]
    - `subscriberNotificationStatusMessage` string: Status message for subscriber notifications - includes success messages, failure reasons, or skip reasons. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [No access - you don't have permission for this operation]
    - `isPrivate` boolean: If true, this incident episode is only visible to its owners (users in 'owner users' and members of 'owner teams'), project admins, and project owners. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Episode], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Episode], Update: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Edit Incident Episode]

## Other responses

- `400`: Bad request. This response indicates that the request was malformed or contained invalid data.
- `401`: Unauthorized. This response indicates that the request requires user authentication.
- `402`: Payment Required. This response indicates that the request requires payment or a valid subscription.
- `403`: Forbidden. This response indicates that the server understood the request, but refuses to authorize it.
- `405`: Project not found. This response indicates that the requested project does not exist or is not accessible.
- `408`: Request Timeout. This response indicates that the server timed out waiting for the request.
- `415`: Unable to reach server. This response indicates that the server is currently unreachable or down.
- `422`: Not authorized. This response indicates that the user does not have permission to access the requested resource.
- `500`: Internal Server Error. This response indicates that the server encountered an unexpected condition that prevented it from fulfilling the request.

---

[API](https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification.md) - [All operations](https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification/revisions/ba3307d00304?raw)
