Skip to main content
POST
Create story

Authorizations

Authorization
string
header
required

Enter your JWT token in the format: Bearer

Body

Basic story serializer for list views.

title
string
required

The title of the story

Required string length: 1 - 255
summary
string
required

The summary of the story

Minimum string length: 1
category
string<uuid>
required
treatment
string<uuid>
required
reference
string | null

Generated reference string

Maximum string length: 30
location
string | null

The location of the story (city, region, etc)

Maximum string length: 255
classification
enum<string> | null

Editorial classification of the story (national reach, mashinani/local, or breaking)

  • national - National
  • mashinani - Mashinani
  • breaking - Breaking
Available options:
national,
mashinani,
breaking,
,
null
platform
enum<string> | null

Intended broadcast medium, set at story creation

  • television - Television
  • radio - Radio
Available options:
television,
radio,
,
null
estimated_duration
string | null

Estimated duration for story completion

urgency_level
enum<string> | null

Story priority level

  • low - Low
  • medium - Medium
  • high - High
  • urgent - Breaking
Available options:
low,
medium,
high,
urgent,
,
null
deadline
string<date-time> | null

Story deadline set by editor at pitch approval (node 3)

submit_for_approval
boolean
default:false
write-only

True to submit directly for editorial approval; False (default) to save as draft.

assigned_reporter
string<uuid> | null

Reporter commissioned by an editor at creation. When set, the story skips pitch approval and starts directly at the morning outlook node, assigned to this reporter (assignment-desk flow).

bulletin
string<uuid> | null
write-only

Bulletin to place this story into immediately at creation. When set, a rundown slot (BulletinStory) is created for it as the last item in that bulletin's running order.

script
string
write-only

Radio only. Broadcast script — when provided together with assets, the story is filed straight to the gallery at creation (same as the submit_script_and_assets transition).

assets
object[]
write-only

Radio only. Audio clips to attach alongside script — same shape as the submit_script_and_assets transition payload: [{asset_source, asset|platform_url, platform_type, media_type, tags}, ...]

Response

201 - application/json

Basic story serializer for list views.

id
string<uuid>
required
read-only
title
string
required

The title of the story

Maximum string length: 255
summary
string
required

The summary of the story

category
string<uuid>
required
treatment
string<uuid>
required
status
string
required
read-only

Human-readable workflow status (cached from workflow engine)

node
string | null
required
read-only

Current workflow node reference number (cached for performance)

created_at
string<date-time>
required
read-only
updated_at
string<date-time>
required
read-only
reporter
string
required
read-only
reference
string | null

Generated reference string

Maximum string length: 30
location
string | null

The location of the story (city, region, etc)

Maximum string length: 255
classification
enum<string> | null

Editorial classification of the story (national reach, mashinani/local, or breaking)

  • national - National
  • mashinani - Mashinani
  • breaking - Breaking
Available options:
national,
mashinani,
breaking,
,
null
platform
enum<string> | null

Intended broadcast medium, set at story creation

  • television - Television
  • radio - Radio
Available options:
television,
radio,
,
null
estimated_duration
string | null

Estimated duration for story completion

urgency_level
enum<string> | null

Story priority level

  • low - Low
  • medium - Medium
  • high - High
  • urgent - Breaking
Available options:
low,
medium,
high,
urgent,
,
null
deadline
string<date-time> | null

Story deadline set by editor at pitch approval (node 3)

assigned_reporter
string<uuid> | null

Reporter commissioned by an editor at creation. When set, the story skips pitch approval and starts directly at the morning outlook node, assigned to this reporter (assignment-desk flow).