API: List Episode Clips

Retrieve all Clips created by the authenticated user for an Episode. Clips are ordered by their generated start time or requested playback point.

Endpoint

GEThttps://app.podwise.ai/api/open/v1/episodes/[seq]/clips

Path Parameters

seq: Episode sequence number.

Response


type Response = {
  success: true,
  result: {
    clips: Clip[],
    clipCount: number,
    exportableClipCount: number,
    unexportableClipCount: number,
  },
  episode: {
    episodeId: string,
    seq: number,
    title: string | null,
    podcastName: string,
  },
}
 
type Clip = {
  id: number,
  episodeId: string,
  episodeSeq: number,
  episodeTitle: string,
  episodeCover: string | null,
  podcastName: string,
  podcastCover: string | null,
  title: string,
  takeaways: string[],
  content: string | null,
  point: number,
  clipStart: number | null,
  clipEnd: number | null,
  status: "waiting" | "processing" | "done" | "failed",
  exportable: boolean,
  // Unix timestamp in seconds
  createdAt: number,
}

Error Responses

Status	Error	Description
400	—	Invalid Episode sequence number.
404	`not_found`	Episode does not exist.

Authorization Error Codes