Prompts

List a space's prompt library and create recurring prompts.

Prompts drive AI content generation. A space's prompt library contains both Castmagic's built-in prompts and your own custom recurring prompts. Recurring prompts run automatically on every new recording in the space, and can also be run on demand via POST /v1/recordings/:id/generate.

Tier: GET /v1/prompts is core. POST /v1/prompts requires automation. Base URL https://app.castmagic.io.

List prompts

GET https://app.castmagic.io/v1/prompts

Tier: core

Query Parameters

Name	Type	Description
space_id	String	Defaults to the key's default space

200: OK

{
    "space": { "id": "a1...", "name": "Acme Podcast" },
    "prompts": [
        {
            "id": "p1...",
            "name": "LinkedIn post",
            "type": "dynamic",
            "description": "Turn the episode into a LinkedIn post",
            "prompt": "Write a LinkedIn post summarizing...",
            "disabled": false
        }
    ],
    "count": 1
}

Create a recurring prompt

POST https://app.castmagic.io/v1/prompts

Tier: automation

Creates a recurring prompt on the space — it runs for every new recording, and can be run on demand via POST /v1/recordings/:id/generate.

Request Body

Name	Type	Description
name*	String	Display name for the prompt
prompt*	String	The prompt text
space_id	String	Defaults to the key's default space
description	String	Optional description

201: Created

{
    "prompt": {
        "id": "p2...",
        "name": "LinkedIn post",
        "type": "dynamic",
        "description": null,
        "prompt": "Write a LinkedIn post summarizing...",
        "disabled": false
    }
}

403: Forbidden Recurring-prompt limit reached

{ "error": "your plan's recurring prompt limit has been reached" }