Skip to main content
POST
Approve a draft plan

Authorizations

Authorization
string
header
required

Company API key. Obtain this from your Woku dashboard under Settings > API Keys. The same key used for the v0 endpoints.

Path Parameters

id
string
required

MongoDB ObjectId of the action plan.

Pattern: ^[0-9a-fA-F]{24}$

Response

Plan updated

_id
string
Example:

"507f1f77bcf86cd799439041"

companyId
string
groupId
string
title
string
Maximum string length: 200
summary
string

What the customers said (narrative synthesis, no invented numbers).

objective
string
expectedImpact
string
theme
string

Detected theme the plan addresses (e.g. "Demoras en despacho").

tasks
object[]
patterns
object[]
sources
enum<string>[]

VoC sources with evidence in the frozen scope.

Available options:
woku,
nps,
csat,
ces
status
enum<string>

in_progress/completed are the managed (in-house) lifecycle; the rest apply to plans sent to an external tool or awaiting approval.

Available options:
draft,
approved,
sent,
canceled,
delivery_error,
in_progress,
completed
priority
enum<string>

Deterministic (engine-computed) priority; never set by the LLM.

Available options:
high,
medium,
low
evidence
object

Frozen evidence snapshot: the exact analytical scope at generation time plus deterministic counts. Never recomputed after generation.

generation
object

Traceability of the LLM run that drafted the plan.

delivery
object

Delivery-to-integration state, filled by the send phase. provider is internal for a managed plan.

approvedBy
string
approvedAt
string<date-time>
canceledBy
string
canceledAt
string<date-time>
completedAt
string<date-time>

Stamped when a managed plan is closed (status completed).

aiGenerated
boolean
default:true
createdAt
string<date-time>
updatedAt
string<date-time>