If you would like to download the AI transcripts (and summaries) of all past recordings for one or more users in your company, you can do this using Demodesk’s API. This guide walks you through the steps.
What You’ll Need
Requirement | Description |
API Key of an Admin (optional) | Only needed to list users in the company (get user IDs). It cannot be used to download transcripts or summaries for other users. Ask your admin or Demodesk Support. |
User API Key | The API key of the user whose past recordings you want to fetch. For “all users”, you need each user’s API key. |
User ID | For each user whose recordings you want to fetch (can be retrieved via the users endpoint). |
Company ID | Needed to list users. Ask Demodesk Support if you don’t know it. |
Overview of the Process
To get transcripts (and summaries) for one or more users:
Get user IDs (via API)
List their past meetings (with recordings)
Extract recording.tokens
Download each transcript (and summary)
Option A: Download Transcripts (and Summaries) for One User
1. Get Their User ID
Send this API request:
GET https://demodesk.com/api/v1/companies/YOUR_COMPANY_ID/users
Headers:
api-key: YOUR_API_KEY
Find the matching email and copy the ID.
Note: Reach out to Demodesk Support, and they can help you with your COMPANY ID.
2. List All Their Past Meetings With Recordings
Use the API key of that user (the user whose meetings you want).
GET https://demodesk.com/api/v1/demos?filter[schedule_eq]=past&filter[recordings_present]=true
Headers:
api-key: USER_API_KEY Accept: application/json
If there are more than 25 meetings, use &page=2, &page=3, etc.
Note: You do not need to pass filter[user_id_eq]=USER_ID when you authenticate with the user’s API key. The request is scoped to that user.
3. Extract recording.tokens
Look in the "included" section of the response:
{ "type": "recordings", "attributes": { "token": "93897ab1ddb8e5fb" } }Copy the value of token for each recording.
4. Download the Transcript
For each token:
GET https://demodesk.com/api/v1/recordings/{RECORDING_TOKEN}/transcriptHeaders:
api-key: USER_API_KEY Accept: text/plain
5. Download the Summary (Optional)
For each token:
GET https://demodesk.com/api/v1/recordings/{RECORDING_TOKEN}/summary/showHeaders:
api-key: USER_API_KEY Accept: application/json
Option B: Download Transcripts (and Summaries) for All Users in the Company
Important: You cannot download past transcripts or summaries for all users with a single admin API key. Each user’s past meetings must be requested using that user’s API key.
1. Get All Users
GET https://demodesk.com/api/v1/companies/YOUR_COMPANY_ID/users
Headers:
api-key: ADMIN_API_KEY
Store each user.id (and email if needed).
2. For Each User → List Meetings (Using That User’s API Key)
For each user, make this request using that user’s API key:
GET https://demodesk.com/api/v1/demos?filter[schedule_eq]=past&filter[recordings_present]=true
Headers:
api-key: USER_API_KEY Accept: application/json
Repeat for each user. Loop through pages if meta.totalPages > 1.
3. For Each Meeting → Get Recording Tokens
From the "included" section of each response, extract:
{ "type": "recordings", "attributes": { "token": "abc123..." } }4. For Each Token → Download Transcript
GET https://demodesk.com/api/v1/recordings/{RECORDING_TOKEN}/transcriptHeaders:
api-key: USER_API_KEY Accept: text/plain
5. For Each Token → Download Summary (Optional)
GET https://demodesk.com/api/v1/recordings/{RECORDING_TOKEN}/summary/showHeaders:
api-key: USER_API_KEY Accept: application/json