POST
/
brand-story-create
Create Brand Agent Brand Story
curl --request POST \
  --url https://api.agentic.scope3.com/rest/v1/brand-story-create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'
{
  "data": {},
  "message": "Operation completed successfully",
  "success": true
}

Authorizations

​
Authorization
string
header
required

Use your Scope3 API key as the bearer token

Body

application/json
​
brandAgentId
string
required

ID of the brand agent to create a brand story for

​
name
string
required

Name for the brand story (e.g., 'Tech Enthusiasts', 'Luxury Shoppers')

​
prompt
string
required

Natural language prompt defining the target audience profile, demographics, and behavioral characteristics for this brand story. Describe your target audience, their interests, preferences, behaviors, and motivations.

​
brands
string[]

List of specific brands this brand story applies to (leave empty for all brands)

​
channels
string[]

List of channels to target (e.g., ['web', 'social', 'mobile'])

​
countries
string[]

List of country codes to target (e.g., ['US', 'CA', 'GB'])

​
languages
string[]

List of language codes to target (e.g., ['en', 'es', 'fr'])

Response

Successful response

​
data
object
​
message
string
​
success
boolean