Content

Generate content for prompts

Start the content-generation agent for one or more prompts. Each prompt gets a draft (returned with its draftId and runId); generated content lands in the review queue as pending_review, never published directly. Poll GET /api/v1/content/{draftId} until generationStatus is completed or failed.

post/api/v1/content/generate

Request

  • Base URL
    https://app.promptingco.com
  • URL
    https://app.promptingco.com/api/v1/content/generate
  • Auth
    • API key in header x-api-key
    • or HTTP bearer
    • or API key in cookie better-auth.session_token

Request body

productIdstring

Product ID. Provide exactly one of productId or productSlug.

productSlugstring

Product slug. Provide exactly one of productId or productSlug.

promptIdsstring[] required

Prompts to generate content for. Prompt text is loaded server-side; ids must belong to the product.

contentType'recommended' | 'solution-recommendation' | 'comparison' | 'explainer' | 'implementation-guide' | 'decision-guide' | 'use-case-workflow' | 'listicle' | 'solution-guide' | 'code-example' | 'code-decision-guide' | 'compatibility' | 'faq' | 'custom'
customRuleDocPathstring
brandPositioning'soft-sell' | 'hard-sell' | 'neutral'
systemPromptstring

Response

Successful response

oktrue required

Changes

No recorded changes to this operation across all 1 revision of this API.