Early Access
This endpoint is currently available as an early access feature. To enable it for your organization, please contact your Ashby account team.
Fetches metadata and a pre-signed download URL for an AI Notetaker transcript recording.
Prerequisites:
- Your organization must have AI Notetaker enabled. If AI Notetaker is not part of your
plan, requests will fail with the
notetaker_transcript_not_enablederror. - This endpoint must be enabled for your organization by Ashby (early access). If it
has not been enabled, requests will fail with the
notetaker_transcript_api_not_enablederror.
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_api_not_enabled | The endpoint has not been enabled for your organization (early access). Contact your Ashby account team. |
notetaker_transcript_not_enabled | Your organization does not have AI Notetaker enabled. |
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. |
Requires the notetakerRead permission.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||