Plan creative directions

POST/publication-builds/angles

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

account_ids?array<string>|

Candidate connected account IDs

Itemsitems <= 20

assets?array<>|

Stored Workspace media used as source evidence

Itemsitems <= 10

context_may_publish?boolean

Allow text from context notes to appear in generated drafts

context_notes?string

Private planning notes supplied as untrusted source material

Lengthlength <= 10000

context_urls?array<string>|

Public HTTP or HTTPS sources loaded by the guarded background worker

Itemsitems <= 10

destination_policy?string

Allow the director to skip weak destinations or require every candidate

Value in

"recommend"
"require_all"

direction?

Optional outcome, audience, angle, tone, and media direction

idea?string

Idea, note, update, or Markdown source text

Lengthlength <= 20000

social_set_id?string

Optional Social Set candidate snapshot

voice_profile_id?string

Optional build-level Voice Profile override

workspace_id*string

Workspace that owns the source material and destinations

Response Body

`application/json`

`application/problem+json`

curl -X POST "https://example.com/publication-builds/angles" \  -H "Content-Type: application/json" \  -d '{    "workspace_id": "string"  }'

{  "$schema": "https://example.com/api/v1/schemas/PlanPublicationAnglesOutputBody.json",  "angles": [    {      "approach": "string",      "build_direction": {        "angle": "string",        "audience": "string",        "media_preference": "string",        "outcome": "string",        "tone_adjustment": "string"      },      "desired_reaction": "string",      "evidence": "string",      "hook": "string",      "id": "string",      "label": "string",      "media": {        "brief": "string",        "role": "string",        "source_ref": "string",        "treatment": "string"      },      "objective": "string",      "thesis": "string"    }  ]}

Plan creative directions

Authorization

Request Body

Response Body

200application/json

400application/problem+json

403application/problem+json

422application/problem+json

429application/problem+json

500application/problem+json

503application/problem+json

`application/json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`