Content
Filter podcasts by status (all=all podcasts, queued=status=0 and no error, failed=has errorOn, succeeded=status=100, processed=has processingOn)
allPossible values: Page number for pagination (starts at 1). If not provided, returns all results.
1Number of items per page (max 100, default 50 if page is specified)
20Successful response
Invalid status parameter
Unauthorized
Filter transcripts by status (all=all transcripts, queued=status=0 and no error, failed=has errorOn, succeeded=status=100, processed=has processingOn)
allPossible values: Page number for pagination (starts at 1). If not provided, returns all results.
1Number of items per page (max 100, default 50 if page is specified)
20Successful response
Invalid status parameter
Unauthorized
Topic for content generation (alternative to resources, feedSelections, or researches)
Array of research IDs to include as text resources (max 10)
Array of project IDs to use as context for generation (max 10)
YouTube channel IDs already connected to the account to use as sources
Completed audio request IDs to reuse as podcast episode sources (max 10)
Instructions or query for content generation
Type of output content to generate
Duration preference for content generation
Video format (defaults to explainer). Ignored for non-video outputs.
Style of the generated content. For audio/text, use one of: deep dive, brief, critique, debate. For video, any custom style text is accepted (defaults to classic when omitted).
HTTPS URL to optional intro music (.mp3, .wav, or .m4a) mixed at lower volume at the start of the podcast
Whether to include citations (PRO only)
Infographic orientation (defaults to landscape)
Infographic detail level (defaults to standard)
Slide deck format (defaults to detailed). Length is controlled via the standard duration field (short, default, long). Slide deck prompt uses the main text field.
Difficulty level for quiz outputs (defaults to medium). Quiz prompt uses the main text field.
Optional data to include in webhooks
Existing request ID to relate this request to (must belong to the same token)
Notebook ID for enterprise clients
Language for content generation
Schedule the content generation for a specific time
Podcast show ID to associate this content with
Optional episode title when attaching to a podcast show
Custom title to use for generated video outputs. When provided, overrides the automatically generated title.
Prompt to guide the generated video title
Prompt to guide the generated video description
Prompt to control the generated thumbnail image for video outputs
Prompt to control the intro image for video outputs
Primary custom voice ID (required when providing voice2 for video requests)
Secondary custom voice ID (requires voice1)
Create a recurring schedule instead of a single request
Number of times per day to run when isScheduled is true
Optional end date for recurring schedules (requires isScheduled true)
Request accepted
Invalid request
Unauthorized
Identifier of the completed request to repurpose
Output type for the new request
Optional text instructions that replace the original TEXT parameter
Optional callback data to associate with the new request
Duration preference (slide decks use this for length)
Orientation when repurposing to an infographic
Detail level when repurposing to an infographic
Format when repurposing to a slide deck
Difficulty level when repurposing to a quiz
Override video title when repurposing to video
Prompt to guide the generated title when repurposing to video
Prompt to guide the generated description when repurposing to video
Video format (defaults to explainer). Only applies when outputType is video.
Custom style text for video outputs
Prompt to control the generated thumbnail image for video outputs
Prompt to control the generated intro image for video outputs
Request accepted
Invalid request or request not completed
Unauthorized
Original request not found
Page number for pagination (starts at 1). If not provided, returns all results.
1Number of items per page (max 100, default 50 if page is specified)
20Successful response
Unauthorized
URL to the audio file to modify
ID of first voice to use
ID of second voice to use
Additional instructions
Optional URL to background music file
Optional data for webhook callbacks
Request accepted
Invalid request
Unauthorized
URL to the audio file
Optional data for webhook callbacks
Request accepted
Invalid request
Unauthorized
MP3 audio file to upload (max 10MB). Cannot be used with audioUrl.
Name for the cloned voice
Request accepted
Invalid request
Unauthorized
MP3 or WAV audio file to upload (max 50MB). Cannot be used with audioUrl or episodeId.
Optional data for webhook callbacks
Request accepted
Invalid request (missing parameters, both parameters provided, or invalid audio format)
Unauthorized
The ID of the episode to get the transcript for
Transcript retrieved successfully
Invalid request (missing episode ID)
Unauthorized
Transcript not found for the specified episode ID
Internal server error
Script with SPEAKER_00/SPEAKER_01 prefixes
ID of first voice to use (SPEAKER_00)
ID of second voice to use (SPEAKER_01)
Optional data for webhook callbacks
Request accepted
Invalid request
Unauthorized
Topic for content generation (alternative to resources or feeds)
Array of feed IDs for content generation (alternative to resources or topic, max 10)
Array of project IDs to use as context for generation (max 10)
Instructions or query for content generation
ID of first voice to use
ID of second voice to use
Duration preference for content generation
Style of podcast content (defaults to deep dive)
Optional language for the generated podcast (leave empty to use the default)
Notebook ID for enterprise clients
Optional data for webhook callbacks
Request accepted
Invalid request
Unauthorized
ID of the voice to remove
Voice removed successfully
Invalid request or missing voice ID
Unauthorized
Voice not found or cannot be deleted
ID of the request to delete
Request deleted successfully
Invalid request or missing request ID
Unauthorized
Request not found or not owned by user
Failed to delete request
Podcasts scheduled successfully
Invalid request parameters or insufficient credits
Unauthorized
Last updated