--- title: "Get Incident Feed" method: POST path: "/incident-feed/{id}/get-item" tags: ["Incident Feed"] --- # Get Incident Feed `POST /incident-feed/{id}/get-item` ## Request - Base URL: `https://oneuptime.com/api` - URL: `https://oneuptime.com/api/incident-feed/{id}/get-item` - Auth: API key in header `APIKey` - TypeScript: (a function with typed inputs; its response is checked against the schema) Endpoint to retrieve a single Incident Feed by ID ## Path parameters - `id` string, uuid, required ## Request body - object - `select` IncidentFeedSelectSchema: Select schema for IncidentFeed. Set fields to true to include them in the response. - `_id` boolean - `createdAt` boolean - `updatedAt` boolean - `deletedAt` boolean - `projectId` boolean - `incidentId` boolean - `aiRunId` boolean - `apiKeyId` boolean - `apiKeyName` boolean - `createdByUserId` boolean - `feedInfoInMarkdown` boolean - `moreInformationInMarkdown` boolean - `incidentFeedEventType` boolean - `displayColor` boolean - `userId` boolean - `postedAt` boolean - `savedFromChatMessage` boolean ## Response `200` Successful response - object - `data` IncidentFeed - `_id` string, uuid: ID of this object. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Feed], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Feed], Update: [No access - you don't have permission for this operation] - `createdAt` object: Date and Time when the object was created. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Feed], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Feed], Update: [No access - you don't have permission for this operation] - `updatedAt` object: Date and Time when the object was updated. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Feed], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Feed], Update: [No access - you don't have permission for this operation] - `deletedAt` object: Date and Time when the object was deleted. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Feed], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Feed], Update: [No access - you don't have permission for this operation] - `version` number: Object version - `projectId` string, uuid, required: ID of your OneUptime Project in which this object belongs. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Feed], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Feed], Update: [No access - you don't have permission for this operation] - `incidentId` string, uuid, required: Relation to Incident ID in which this resource belongs. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Feed], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Feed], Update: [No access - you don't have permission for this operation] - `aiRunId` string, uuid: AI investigation run that produced this feed item when the event is a root cause. 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 Feed], Update: [No access - you don't have permission for this operation] - `apiKeyId` string, uuid: The project API key that made this change, when an API key did rather than a person. Kept when the key is revoked or deleted. 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 Feed], Update: [No access - you don't have permission for this operation] - `apiKeyName` string: The name the API key that made this change had at the time, shown as the item's author. 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 Feed], Update: [No access - you don't have permission for this operation] - `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 Feed], Update: [No access - you don't have permission for this operation] - `feedInfoInMarkdown` string, required: Log of the entire incident state change in Markdown. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Feed], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Feed], Update: [No access - you don't have permission for this operation] - `moreInformationInMarkdown` string: More information in Markdown. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Feed], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Feed], Update: [No access - you don't have permission for this operation] - `incidentFeedEventType` 'PublicNote' | 'SubscriberNotificationSent' | 'OwnerNotificationSent' | 'OwnerUserAdded' | 'OwnerTeamAdded' | 'IncidentCreated' | 'IncidentStateChanged' | 'PrivateNote' | 'IncidentUpdated' | 'RootCause' | 'RemediationNotes' | 'PostmortemNote' | 'OwnerUserRemoved' | 'OwnerTeamRemoved' | 'OnCallPolicy' | 'OnCallNotification' | 'IncidentMemberAdded' | 'IncidentMemberRemoved' | 'AlertLinked' | 'AlertUnlinked' | 'LabelRuleExecuted' | 'OwnerRuleExecuted' | 'PrivacyRuleExecuted' | 'OnCallRuleExecuted' | 'AutoRemediation' | 'VideoCallStarted' | 'VideoCallFailed' | 'VideoCallTranscriptAdded' | 'VideoCallSummary' | 'ChannelMemberAdded', required: Incident Feed Event. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Feed], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Feed], Update: [No access - you don't have permission for this operation] - `displayColor` object, required: Display color for the incident log. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Feed], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Feed], Update: [No access - you don't have permission for this operation] - `userId` string, uuid: User who this feed belongs to (if this feed belongs to a User). Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Feed], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Feed], Update: [No access - you don't have permission for this operation] - `postedAt` object: Date and time when the feed was posted. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Feed], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Feed], Update: [No access - you don't have permission for this operation] - `savedFromChatMessage` object: For a note saved from a Slack or Microsoft Teams message: the chat it was posted in (workspaceType), who wrote it (authorName, and authorUserId when their chat account is connected to OneUptime) and when it was posted there (postedAt). The feed item's user is whoever saved it. Written 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 Feed], Update: [No access - you don't have permission for this operation] ## 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. - `404`: Not found. The record does not exist, belongs to another project, or is one you may not read - the same answer for each. - `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)