Update Podcast on Project

PATCH https://api.podengine.ai/api/v1/projects/:projectSlug/podcasts/:listedPodcastId

Update the details or status of a podcast within a project

Example request

curl -X PATCH "https://api.podengine.ai/api/v1/projects/:projectSlug/podcasts/:listedPodcastId" \
  -H "Content-Type: application/json" \
  -H "Authorization: YOUR_API_TOKEN"

const options = {
  method: "PATCH",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "YOUR_API_TOKEN"
  }
};

fetch("https://api.podengine.ai/api/v1/projects/:projectSlug/podcasts/:listedPodcastId", options)
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

import requests

headers = {
    "Content-Type": "application/json",
    "Authorization": "YOUR_API_TOKEN"
}

response = requests.patch("https://api.podengine.ai/api/v1/projects/:projectSlug/podcasts/:listedPodcastId", headers=headers)
print(response.json())

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "YOUR_API_TOKEN");
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));

var response = await client.SendAsync("https://api.podengine.ai/api/v1/projects/:projectSlug/podcasts/:listedPodcastId");
var data = await response.Content.ReadAsStringAsync();
Console.WriteLine(data);

package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("PATCH", "https://api.podengine.ai/api/v1/projects/:projectSlug/podcasts/:listedPodcastId", nil)
	req.Header.Add("Content-Type", "application/json")
	req.Header.Add("Authorization", "YOUR_API_TOKEN")
	
	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

import { PodEngine } from '@podengine/sdk';

const pe = new PodEngine({ apiKey: process.env.PODENGINE_API_KEY });

const data = await pe.projects.updateProjectListedPodcast({
  projectSlug: 'example-project',
  listedPodcastId: '123',
});

console.log(data);

import os

from podengine import PodEngine

pe = PodEngine(api_key=os.environ["PODENGINE_API_KEY"])

data = pe.projects.update_project_listed_podcast(
    project_slug="example-project",
    listed_podcast_id="123",
)

print(data)

200

Example response

{
  "status": "OK",
  "data": {
    "projectSlug": "string",
    "listedPodcastId": "string",
    "options": {
      "state": "prospect",
      "priority": "low"
    },
    "updatedListedPodcast": {
      "listedPodcastId": "string",
      "projectId": "string",
      "podcast": {
        "podcastId": "string",
        "titleOriginal": "string",
        "titleLatest": "string",
        "slug": "string",
        "imageUrl": "string",
        "estimatedMonthlyListeners": 0,
        "estimatedMonthlyListenersBucket": "0-1K"
      },
      "status": "prospect",
      "priority": "low",
      "labels": [
        "string"
      ],
      "addedAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z",
      "addedByUser": {
        "userId": "string",
        "email": "string",
        "displayName": "string"
      },
      "activityHistory": [
        {
          "actionType": "added-to-list",
          "activityDate": "2026-01-15T09:30:00.000Z",
          "fromValue": "string",
          "toValue": "string",
          "userId": "string",
          "userDisplayName": "string"
        }
      ],
      "analysis": {
        "relevancyScore": 0,
        "deepRelevancyScore": 0,
        "hostRelevancyScore": 0
      }
    }
  }
}

Request

Path parameters

projectSlugstringrequired

URL slug identifying the project.

listedPodcastIdstringrequired

ID of the podcast entry in this project, not the podcast ID.

Request body

stateenum

New workflow state for the podcast in the project.

prospectqualifiedpitchedlostbookedignored

priorityenumnullable

New priority for the podcast entry; null clears its priority.

lowmediumhighurgent

Response

200 application/json

statusliteral: OKrequired

dataobjectrequired4 fields

projectSlugstringrequired

URL slug identifying the project.

listedPodcastIdstringrequired

ID of the podcast entry in this project, not the podcast ID.

optionsobjectrequired2 fields

stateenum

New workflow state for the podcast in the project.

prospectqualifiedpitchedlostbookedignored

priorityenumnullable

New priority for the podcast entry; null clears its priority.

lowmediumhighurgent

updatedListedPodcastobjectrequired11 fields

listedPodcastIdstringrequired

projectIdstringrequired

podcastobjectrequired7 fields

podcastIdstringrequired

titleOriginalstringrequired

titleLateststringrequired

slugstringrequired

imageUrlstringrequirednullable

estimatedMonthlyListenersnumberrequirednullablemin 0

estimatedMonthlyListenersBucketenumrequirednullable

Bucket for the estimated monthly listeners: 0-1K, 1K-10K, 10K-100K, 100K-1M or 1M+. 0-1K means the estimate is under 1,000, even when the rounded figure reads 1,000. Null means no estimate is available.

0-1K1K-10K10K-100K100K-1M1M+

statusenumrequired

prospectqualifiedpitchedlostbookedignored

priorityenumrequirednullable

lowmediumhighurgent

labelsarray of stringrequired

addedAtdaterequired

updatedAtdaterequired

addedByUserobjectrequired3 fields

userIdstringrequired

emailstringrequired

displayNamestringrequirednullable