Skip to main content
PUT
/
api
/
v1
/
stories
/
{id}
Update story
curl --request PUT \
  --url https://api.example.com/api/v1/stories/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "summary": "<string>",
  "category": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "treatment": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "reference": "<string>",
  "location": "<string>",
  "estimated_duration": "<string>",
  "submit_for_approval": false
}
'
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "reference": "CT-2026-001",
  "title": "Government announces new economic policy",
  "location": "Nairobi",
  "summary": "The government has announced a sweeping new economic policy...",
  "category": "Politics",
  "treatment": "Package",
  "estimated_duration": 120,
  "urgency_level": "high",
  "status": "pending",
  "node": "NODE_PITCH",
  "created_at": "2026-05-27T08:00:00Z",
  "updated_at": "2026-05-27T08:00:00Z",
  "reporter": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "James Wanjiru",
    "employee_number": "EMP-004"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.capedigital.co.ke/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Enter your JWT token in the format: Bearer

Path Parameters

id
string<uuid>
required

A UUID string identifying this Story.

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
estimated_duration
string | null

Estimated duration for story completion

urgency_level
enum<string> | null

Story priority level

  • low - Low
  • medium - Medium
  • high - High
  • urgent - Urgent
Available options:
low,
medium,
high,
urgent,
,
null
submit_for_approval
boolean
default:false
write-only

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

Response

200 - 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
estimated_duration
string | null

Estimated duration for story completion

urgency_level
enum<string> | null

Story priority level

  • low - Low
  • medium - Medium
  • high - High
  • urgent - Urgent
Available options:
low,
medium,
high,
urgent,
,
null