Get a single call recording by ID.
This endpoint is in beta. We will aim to avoid breaking changes, but small updates may be made as we roll out to more users.
Required scopes: meeting:read, call_recording:read.
643 matches
49 actions
Attio
49 actions
CRM/Attio
Get a single call recording by ID.
This endpoint is in beta. We will aim to avoid breaking changes, but small updates may be made as we roll out to more users.
Required scopes: meeting:read, call_recording:read.
{
"type": "object",
"properties": {
"call_recording_id": {
"type": "string",
"format": "uuid",
"description": "The ID of the call recording to retrieve."
},
"meeting_id": {
"type": "string",
"format": "uuid",
"description": "The ID of the meeting this recording belongs to."
}
},
"required": [
"call_recording_id",
"meeting_id"
],
"additionalProperties": false
}{
"type": "object",
"description": "Success",
"required": [
"data"
],
"properties": {
"data": {
"type": "object",
"required": [
"created_at",
"created_by_actor",
"id",
"status",
"transcript",
"video_url",
"web_url"
],
"properties": {
"created_at": {
"type": "string",
"description": "The timestamp of when the call recording was created."
},
"created_by_actor": {
"type": "object",
"description": "The actor that created this call recording.",
"properties": {
"id": {
"type": "string",
"description": "An ID to identify the actor."
},
"type": {
"type": "string",
"description": "The type of actor. [Read more information on actor types here](/docs/actors).",
"enum": [
"api-token",
"workspace-member",
"system",
"app"
]
}
}
},
"id": {
"type": "object",
"required": [
"call_recording_id",
"meeting_id",
"workspace_id"
],
"properties": {
"call_recording_id": {
"type": "string",
"format": "uuid",
"description": "The call recording ID of the call recording."
},
"meeting_id": {
"type": "string",
"format": "uuid",
"description": "The ID of the meeting associated with this call recording."
},
"workspace_id": {
"type": "string",
"format": "uuid",
"description": "The ID of the workspace this call recording belongs to."
}
}
},
"status": {
"type": "string",
"description": "The status of the call recording. When a call recording is first created, it will have a status of `PROCESSING`. Once the recording is ready, it will transition to `COMPLETED`. If the recording fails for any reason, the status will be `FAILED`.",
"enum": [
"processing",
"completed",
"failed"
]
},
"transcript": {
"type": [
"object",
"null"
],
"description": "The transcript for this call recording, `null` if no transcript is available.",
"required": [
"raw_transcript",
"segments"
],
"properties": {
"raw_transcript": {
"type": "string",
"description": "The raw transcript of the call recording."
},
"segments": {
"type": "array",
"description": "The transcript segments with speech, timing, and speaker information.",
"items": {
"type": "object",
"required": [
"speech",
"start_time",
"end_time",
"speaker"
],
"properties": {
"end_time": {
"type": "number",
"description": "The end time of this speech segment in seconds, measured from the start of the recording."
},
"speaker": {
"type": "object",
"description": "The speaker of this transcript segment.",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "The name of the speaker."
}
}
},
"speech": {
"type": "string",
"description": "The spoken text for this segment of the transcript."
},
"start_time": {
"type": "number",
"description": "The start time of this speech segment in seconds, measured from the start of the recording."
}
}
}
}
}
},
"video_url": {
"type": [
"string",
"null"
],
"format": "uri",
"description": "A short-lived URL for downloading the call recording's video. This is only available for call recordings captured by the Attio call recorder: it is always `null` for call recordings created through the API. The URL expires one hour after this response was generated. You can call this endpoint again to get a fresh URL."
},
"web_url": {
"type": "string",
"format": "uri",
"description": "A URL that links directly to the call recording in the Attio web application."
}
}
}
}
}