Get, Update, or Delete Podcast | AISquare Studio

import requests
url = "https://api.example.com/api/v1/podcasts/1/"
payload = { "title": "The Future of Renewable Energy" }
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "id": 1,
  "uid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "title": "The Future of Renewable Energy",
  "created_at": "2024-01-15T09:30:00Z",
  "updated_at": "2024-01-20T14:45:00Z",
  "duration_display": "44m 10s",
  "can_generate_script": "yes",
  "can_generate_audio": "yes",
  "category_name": "Technology",
  "subcategory_name": "Renewable Energy",
  "tag_names": [
    "energy",
    "technology",
    "environment"
  ],
  "owner": {
    "id": 42,
    "email": "jane.doe@example.com",
    "full_name": "Jane Doe",
    "username": "janedoe",
    "is_verified": true,
    "profile_picture": "https://example.com/profiles/janedoe.jpg"
  },
  "owner_username": "janedoe",
  "publications": "Tech Insights Weekly",
  "source_experience_uid": "exp-987654321",
  "source_experience_title": "Renewable Energy Series",
  "rag_document_count": "5",
  "rag_documents": "doc1, doc2, doc3, doc4, doc5",
  "metrics": "plays:1500, likes:300, shares:120",
  "workspace_id": 7,
  "description": "An in-depth discussion on the advancements and challenges in renewable energy technologies.",
  "voice_type": "hume-voice-1234",
  "language": "en",
  "length": 45,
  "knowledge_level": "intermediate",
  "llm_prompt": "Generate a detailed podcast script about renewable energy innovations.",
  "logo": "https://example.com/images/podcast-logo.png",
  "generated_script": "Welcome to our podcast on renewable energy...",
  "audio_file": "https://example.com/audio/future-renewable-energy.mp3",
  "audio_url": "https://cdn.example.com/podcasts/future-renewable-energy.mp3",
  "generation_status": "completed",
  "estimated_duration": 2700,
  "actual_duration": 2650,
  "cover_image": "https://example.com/images/podcast-cover.jpg",
  "focus_area": "Energy and Environment",
  "visibility": "public",
  "is_draft": false,
  "creation_status": "completed"
}

Retrieves, updates, or deletes a specific podcast.

Path parameters

idintegerRequired

pkintegerRequired

The ID of the podcast

Request

This endpoint expects an object.

titlestringRequired<=255 characters

ownerobjectRequired

Simple user serializer with profile picture from associated IAMUserDetail.

Fields:

id, email, full_name, username, is_verified (from IAMUser)
profile_picture (from first related IAMUserDetail if present)

Simple user serializer with profile picture from associated IAMUserDetail. Fields: - id, email, full_name, username, is_verified (from IAMUser) - profile_picture (from first related IAMUserDetail if present)

descriptionstring or nullOptional

voice_typestring or nullOptional<=100 characters

Voice type from Hume AI (voice ID or clone settings)

languageenum or any or nullOptional

Language for the podcast content (for future use)

en - English
es - Spanish
fr - French
de - German
it - Italian
pt - Portuguese
zh - Chinese
ja - Japanese
ko - Korean
ar - Arabic
ru - Russian
hi - Hindi

Language for the podcast content (for future use) * `en` - English * `es` - Spanish * `fr` - French * `de` - German * `it` - Italian * `pt` - Portuguese * `zh` - Chinese * `ja` - Japanese * `ko` - Korean * `ar` - Arabic * `ru` - Russian * `hi` - Hindi

lengthinteger or nullOptional-2147483648-2147483647

Target podcast length in minutes

knowledge_levelenumOptional

Target knowledge level for the podcast audience

beginner - Beginner
intermediate - Intermediate
advanced - Advanced
expert - Expert

Target knowledge level for the podcast audience * `beginner` - Beginner * `intermediate` - Intermediate * `advanced` - Advanced * `expert` - Expert

Allowed values:

llm_promptstring or nullOptional

Optional custom prompt for the podcast script generation LLM

logostring or nullOptionalformat: "uri"

Logo image for the podcast (copied from experience)

generated_scriptstring or nullOptional

LLM-generated podcast script

audio_filestring or nullOptionalformat: "uri"

Generated podcast audio file

audio_urlstring or nullOptionalformat: "uri"<=200 characters

URL to the generated podcast audio

generation_statusenumOptional

Current status of podcast generation process

not_started - Not Started
generating_script - Generating Script
script_generated - Script Generated
generating_audio - Generating Audio
completed - Completed
failed - Failed

Current status of podcast generation process * `not_started` - Not Started * `generating_script` - Generating Script * `script_generated` - Script Generated * `generating_audio` - Generating Audio * `completed` - Completed * `failed` - Failed

estimated_durationinteger or nullOptional-2147483648-2147483647

Estimated duration of the podcast in seconds

actual_durationinteger or nullOptional-2147483648-2147483647

Actual duration of the generated podcast in seconds

cover_imagestring or nullOptionalformat: "uri"

Cover image for the podcast

focus_areastring or nullOptional<=256 characters

visibilityenumOptional

public - Public
private - Private
team - Team
org - Organization

* `public` - Public * `private` - Private * `team` - Team * `org` - Organization

Allowed values:

is_draftbooleanOptional

Whether this podcast is a draft

creation_statusenumOptional

not_started - Not Started
in_progress - In Progress
completed - Completed
failed - Failed

* `not_started` - Not Started * `in_progress` - In Progress * `completed` - Completed * `failed` - Failed

Allowed values:

generation_metadataany or nullOptional

Metadata about the generation process (model used, parameters, etc.)

Response

Podcast details

idintegerRead-only

uidstringRead-onlyformat: "uuid"

titlestring<=255 characters

created_atdatetimeRead-only

updated_atdatetimeRead-only

duration_displaystringRead-only

can_generate_scriptstringRead-only

can_generate_audiostringRead-only

category_namestringRead-only

subcategory_namestringRead-only

tag_nameslist of stringsRead-only

ownerobject

Simple user serializer with profile picture from associated IAMUserDetail.

Fields:

id, email, full_name, username, is_verified (from IAMUser)
profile_picture (from first related IAMUserDetail if present)

owner_usernamestringRead-only

publicationsstringRead-only

source_experience_uidstringRead-only

source_experience_titlestringRead-only

rag_document_countstringRead-only

rag_documentsstringRead-only

metricsstringRead-only

workspace_idintegerRead-only

descriptionstring or null

voice_typestring or null<=100 characters

Voice type from Hume AI (voice ID or clone settings)

languageenum or any or null

Language for the podcast content (for future use)

en - English
es - Spanish
fr - French
de - German
it - Italian
pt - Portuguese
zh - Chinese
ja - Japanese
ko - Korean
ar - Arabic
ru - Russian
hi - Hindi

lengthinteger or null-2147483648-2147483647

Target podcast length in minutes

knowledge_levelenum

Target knowledge level for the podcast audience

beginner - Beginner
intermediate - Intermediate
advanced - Advanced
expert - Expert

Target knowledge level for the podcast audience * `beginner` - Beginner * `intermediate` - Intermediate * `advanced` - Advanced * `expert` - Expert

Allowed values:

llm_promptstring or null

Optional custom prompt for the podcast script generation LLM

logostring or nullformat: "uri"

Logo image for the podcast (copied from experience)

generated_scriptstring or null

LLM-generated podcast script

audio_filestring or nullformat: "uri"

Generated podcast audio file

audio_urlstring or nullformat: "uri"<=200 characters

URL to the generated podcast audio

generation_statusenum

Current status of podcast generation process

not_started - Not Started
generating_script - Generating Script
script_generated - Script Generated
generating_audio - Generating Audio
completed - Completed
failed - Failed

estimated_durationinteger or null-2147483648-2147483647

Estimated duration of the podcast in seconds

actual_durationinteger or null-2147483648-2147483647

Actual duration of the generated podcast in seconds

cover_imagestring or nullformat: "uri"

Cover image for the podcast

focus_areastring or null<=256 characters

visibilityenum

public - Public
private - Private
team - Team
org - Organization

* `public` - Public * `private` - Private * `team` - Team * `org` - Organization

Allowed values:

is_draftboolean

Whether this podcast is a draft

creation_statusenum

not_started - Not Started
in_progress - In Progress
completed - Completed
failed - Failed

* `not_started` - Not Started * `in_progress` - In Progress * `completed` - Completed * `failed` - Failed

Allowed values:

generation_metadataany or null

Metadata about the generation process (model used, parameters, etc.)

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error