Skip to content
Docs

API: Get Clip

Retrieve one Clip owned by the authenticated user. Ready media is returned as a signed URL valid for 24 hours.

Endpoint

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

Path Parameters

  • id: Positive integer Clip ID.

Response

type Response = {
  success: true;
  result: {
    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;
    // Present only when ready media is available
    mediaUrl: string | null;
    mediaType: "audio" | "video" | null;
    // Unix timestamp in seconds
    mediaUrlExpiresAt: number | null;
  };
};

Error Responses

StatusErrorDescription
400--Invalid Clip ID.
404not_foundClip does not exist or is not owned by the authenticated user.