--- title: "Get Incident Video Call" method: POST path: "/incident-video-call/{id}/get-item" tags: ["Incident Video Call"] --- # Get Incident Video Call `POST /incident-video-call/{id}/get-item` ## Request - Base URL: `https://oneuptime.com/api` - URL: `https://oneuptime.com/api/incident-video-call/{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 Video Call by ID ## Path parameters - `id` string, uuid, required ## Request body - object - `select` IncidentVideoCallSelectSchema: Select schema for IncidentVideoCall. Set fields to true to include them in the response. - `_id` boolean - `createdAt` boolean - `updatedAt` boolean - `deletedAt` boolean - `projectId` boolean - `incidentId` boolean - `provider` boolean - `videoCallConnectionId` boolean - `title` boolean - `joinUrl` boolean - `externalMeetingId` boolean - `externalCalendarEventId` boolean - `workspaceNotificationRuleId` boolean - `transcript` boolean - `transcriptSource` boolean - `transcriptInfo` boolean - `transcriptAddedAt` boolean - `transcriptAddedByUserId` boolean - `callSummary` boolean - `callSummaryStatus` boolean - `callSummaryStatusMessage` boolean - `callSummaryUpdatedAt` boolean - `rootCauseSuggestionStatus` boolean - `rootCauseSuggestionReviewedAt` boolean - `rootCauseSuggestionReviewedByUserId` boolean - `transcriptFetchStatus` boolean - `transcriptFetchReason` boolean - `transcriptFetchCheckedAt` boolean - `transcriptFetchNextAttemptAt` boolean - `createdByUserId` boolean ## Response `200` Successful response - object - `data` IncidentVideoCall - `_id` string, uuid: ID of this object. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Video Call], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Video Call], 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 Video Call], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Video Call], 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 Video Call], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Video Call], 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 Video Call], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Video Call], 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 Video Call], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Video Call], Update: [No access - you don't have permission for this operation] - `incidentId` string, uuid, required: ID of the incident this call is for. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Video Call], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Video Call], Update: [No access - you don't have permission for this operation] - `provider` 'Zoom' | 'GoogleMeet' | 'MicrosoftTeams' | 'SlackHuddle' | 'CustomLink': Where the call is held: Zoom, GoogleMeet, MicrosoftTeams, SlackHuddle, or CustomLink for a link a person provided. Taken from the connection when one is given. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Video Call], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Video Call], Update: [No access - you don't have permission for this operation] - `videoCallConnectionId` string, uuid: ID of the Zoom, Google Meet, Microsoft Teams or meeting link connection to start the call with. Leave it out to add a link of your own, or to start the huddle of the incident's Slack channel. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Video Call], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Video Call], Update: [No access - you don't have permission for this operation] - `title` string: What the call is called. A meeting a provider creates is named for the incident. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Video Call], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Video Call], Update: [No access - you don't have permission for this operation] - `joinUrl` string: The link responders open to join the call. Set by OneUptime for a call started with a connection or a Slack huddle; required, as an https link, when you add a link of your own. Permissions - Create: [Project Owner, Project Admin, Project Member, Incident Admin, Incident Member, Create Incident Video Call], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident Video Call], Update: [No access - you don't have permission for this operation] - `externalMeetingId` string: The provider's own id for the meeting: a Zoom meeting id, a Google Meet space name, a Microsoft Teams online meeting id or a Slack channel id. 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 Video Call], Update: [No access - you don't have permission for this operation] - `externalCalendarEventId` string: The calendar event the meeting belongs to: a Microsoft Teams meeting OneUptime put on its organizer's calendar, as it does while Record and transcribe incident calls is on, so that it can read the meeting's transcript. Empty for every other call. 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 Video Call], Update: [No access - you don't have permission for this operation] - `workspaceNotificationRuleId` string, uuid: ID of the Slack or Microsoft Teams notification rule that started this call. 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 Video Call], Update: [No access - you don't have permission for this operation] - `transcript` string: What was said on the call, one remark a line: how far into the call (HH:MM:SS, empty when unknown), a tab, who spoke (empty when unknown), a tab, and the words. Read from Zoom or Google Meet, or added by a person, through the call's transcript routes. 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 Video Call], Update: [No access - you don't have permission for this operation] - `transcriptSource` 'Provider' | 'Upload': Where the transcript came from: Provider when OneUptime read it from Zoom or Google Meet, Upload when a person added it. 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 Video Call], Update: [No access - you don't have permission for this operation] - `transcriptInfo` object: How long the transcript is - remarks, speakers, characters and how many seconds it spans - and the name of the file it was added from, so the call can be described without reading the transcript. 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 Video Call], Update: [No access - you don't have permission for this operation] - `transcriptAddedAt` object: When the transcript was added to the call. 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 Video Call], Update: [No access - you don't have permission for this operation] - `transcriptAddedByUserId` string, uuid: ID of the person who added the transcript. 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 Video Call], Update: [No access - you don't have permission for this operation] - `callSummary` object: What OneUptime AI read in the transcript: the root cause the call points at (a suggestion, or that the call did not discuss it enough), what was found, tried, decided and left to do, and open questions - each with the transcript lines it rests on. 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 Video Call], Update: [No access - you don't have permission for this operation] - `callSummaryStatus` 'Pending' | 'Ready' | 'Failed' | 'Skipped': Where OneUptime AI's reading of the transcript stands: Pending while it reads, Ready, Failed (Call Summary Status Message says why), or Skipped when AI is off for the project. 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 Video Call], Update: [No access - you don't have permission for this operation] - `callSummaryStatusMessage` string: Why OneUptime AI did not read the transcript, or could not finish reading it. 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 Video Call], Update: [No access - you don't have permission for this operation] - `callSummaryUpdatedAt` object: When the Call Summary Status last changed: when OneUptime AI started reading the transcript, or finished. 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 Video Call], Update: [No access - you don't have permission for this operation] - `rootCauseSuggestionStatus` 'Suggested' | 'Accepted' | 'Dismissed': What a person did with the root cause OneUptime AI suggested from the call: Suggested while it waits, Accepted once used as the incident's root cause, Dismissed. Empty when nothing was suggested. 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 Video Call], Update: [No access - you don't have permission for this operation] - `rootCauseSuggestionReviewedAt` object: When a person accepted or dismissed the root cause suggested from the call. 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 Video Call], Update: [No access - you don't have permission for this operation] - `rootCauseSuggestionReviewedByUserId` string, uuid: ID of the person who accepted or dismissed the root cause suggested from the call. 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 Video Call], Update: [No access - you don't have permission for this operation] - `transcriptFetchStatus` 'Waiting' | 'Stopped': Whether OneUptime gets the call's transcript from Zoom, Google Meet or Microsoft Teams by itself, as it does for the calls it starts while Record and transcribe incident calls is on: Waiting while it asks the provider (again at Transcript Fetch Next Attempt At), Stopped once it no longer asks, or when the provider could not be set up to record the call (Transcript Fetch Reason says why). Empty for a call it does not ask about, and once it has the transcript. 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 Video Call], Update: [No access - you don't have permission for this operation] - `transcriptFetchReason` 'NotReady' | 'NotTranscribed' | 'NoMeeting' | 'Expired' | 'PermissionMissing' | 'ConnectionProblem' | 'NotSupported': Why the provider had no transcript to give when OneUptime last asked: NotReady (still preparing it), NotTranscribed (nothing recorded or transcribed yet), NoMeeting, Expired, PermissionMissing, ConnectionProblem or NotSupported. Empty when the provider did not answer. 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 Video Call], Update: [No access - you don't have permission for this operation] - `transcriptFetchCheckedAt` object: When OneUptime last asked the provider for the call's transcript. 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 Video Call], Update: [No access - you don't have permission for this operation] - `transcriptFetchNextAttemptAt` object: When OneUptime next asks the provider for the call's transcript, while the Transcript Fetch Status is Waiting. 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 Video Call], 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 Video Call], 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)