Batch update prompts

Use this to set customer journey stage or prompt text on many prompts at once. Prefer a single call with promptIds when applying the same values to all prompts; use prompts[] when each prompt needs different values.

Request body

Provide either prompts[] or promptIds (at least one must be present).

PromptUpdate[]

Per-prompt patches. Each item must include id and at least one of text or customerJourney.

Show PromptUpdate

string

required

Prompt UUID.

string

New prompt text.

string

"awareness", "consideration", "decision", or "post-purchase". Also accepted as customer_journey. Pass null or empty string to clear the stage.

string[]

Apply the same text and/or customerJourney to every listed prompt.

string

Shared prompt text when using promptIds.

string

Shared journey stage when using promptIds.

Request

Uniform journey stage on many prompts:

curl -s -X POST \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "promptIds": ["PROMPT_ID_1", "PROMPT_ID_2"],
    "customerJourney": "consideration"
  }' \
  "https://app.rocketblue.ai/api/v1/prompts/batch-update"

Per-prompt updates:

curl -s -X POST \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompts": [
      { "id": "PROMPT_ID_1", "customerJourney": "awareness" },
      { "id": "PROMPT_ID_2", "customerJourney": "decision" }
    ]
  }' \
  "https://app.rocketblue.ai/api/v1/prompts/batch-update"

Response

integer

Number of prompts updated.

object[]

Updated prompt objects with id, text, topicId, and customerJourney.

string[]

Brands affected by the update.

string | null

Present when all updated prompts belonged to a single brand.

{
  "updatedCount": 2,
  "updatedPrompts": [
    {
      "id": "prompt-uuid-1",
      "text": "How do teams compare pricing?",
      "topicId": "topic-uuid-1",
      "customerJourney": "consideration"
    },
    {
      "id": "prompt-uuid-2",
      "text": "What should I look for in a vendor?",
      "topicId": "topic-uuid-1",
      "customerJourney": "consideration"
    }
  ],
  "brandIds": ["brand-uuid-123"],
  "brandId": "brand-uuid-123"
}

Get Started

API Reference

Batch update prompts

Request body

Request

Response

​Request body

​Request

​Response

Request body

Request

Response