v1

latestOpenAPI 3.1.02026-07-24181585937.4 KB

Notetaker Transcript

notetakerTranscript.info

Fetches metadata and a pre-signed download URL for an AI Notetaker transcript recording.

Prerequisites:

Your organization must have the AI Notetaker add-on. If your organization does not have the add-on, requests will fail with the notetaker_transcript_not_enabled error.

The response includes a signed URL with the transcript JSON. Download the file promptly after calling this endpoint. If the URL has expired, call the endpoint again to get a fresh one.

On the free tier, transcripts expire after a retention period. Requesting an expired transcript returns the notetaker_transcript_expired error. Organizations with unlimited AI Notetaker access are not subject to this expiry.

Use the notetakerTranscriptId field from interviewEvent.list or interviewSchedule.list to discover transcript IDs for interview events.

Error codes:

Code	Description
notetaker_transcript_not_enabled	Your organization does not have the AI Notetaker add-on.
notetaker_transcript_not_found	No transcript exists with the given ID, or you do not have access to it.
notetaker_transcript_expired	The transcript has expired. Upgrade to unlimited AI Notetaker to retain transcripts indefinitely.
invalid_input	The provided notetakerTranscriptId is not a valid UUID.

Configure API key permissions in Admin → API Keys. See Managing API Key Permissions.

Requires the notetakerRead permission.

post/notetakerTranscript.info

Request body

notetakerTranscriptIdstring uuid required

The unique id of the notetaker transcript to fetch

Example request

{
  "notetakerTranscriptId": "e9ed20fd-d45f-4aad-8a00-a19bfba0083e"
}

Response

Responses from the notetakerTranscript.info endpoint

Example response

{
  "success": true,
  "results": {
    "id": "3ae2b801-19f6-41ef-ad28-214bd731948f",
    "interviewEventId": "c153b3e9-8b97-4fc0-bad1-6c654122c1f8",
    "interviewScheduleId": "a0bbb968-e31d-4e23-800a-2f75ed4ec107",
    "createdAt": "2026-04-25T02:46:41.817Z",
    "participants": [
      {
        "id": "e9ed20fd-d45f-4aad-8a00-a19bfba0083e",
        "type": "interviewer",
        "name": "Jane Smith",
        "email": "jane.smith@example.com"
      },
      {
        "id": "7211e226-7802-41fd-8d55-2720fe9d534f",
        "type": "candidate",
        "name": "John Doe",
        "email": "john.doe@example.com"
      }
    ],
    "transcriptUrl": "https://s3.amazonaws.com/..."
  }
}