Skip to main content
PUT
Record demand-inbox ledger annotations

Authorizations

Authorization
string
header
required

API key or access token

Path Parameters

runId
integer
required

Surrogate id of the chef compose run this ledger row wraps.

Required range: 1 <= x <= 9007199254740991
Example:

42

Body

application/json

Records the seller-authored ledger annotations (grade, buyer feedback, led-by attribution) on one demand-inbox row.

grade
enum<string> | null

Seller's letter grade (A–F) for the proposal. Null clears it.

Available options:
A,
B,
C,
D,
F
feedback
string | null

Buyer feedback captured against the proposal. Null clears it.

Maximum string length: 2000
ledBy
enum<string>

Who led the response: the agent, or a human who took it over. Omit to leave the run's current attribution.

Available options:
agent,
human

Response

Record demand-inbox ledger annotations

id
string
required
brief
string | null
required

The brief text the agent answered (label for the row).

buyer
string | null
required

Buyer label derived from the buyer scope (operator or brand domain).

budgetRange
object | null
required

The buyer's stated budget range, exactly as sent in the brief's filters.budget_range and captured in the brief artifact. Null when the buyer did not state one.

receivedAt
string
required
respondedAt
string | null
required

When the agent answered. Null while the brief is unanswered.

ledBy
enum<string> | null
required
Available options:
agent,
human
feedback
string | null
required
result
enum<string>
required

Commercial result derived from this run’s own attributed outcome: closed_won (booked/delivered), closed_lost (rejected), else pending. A booking attributed to a later refine pass is not rolled up here (see the win-rate scope note).

Available options:
closed_won,
closed_lost,
pending
grade
enum<string> | null
required
Available options:
A,
B,
C,
D,
F
wonValue
object | null
required

Money attributed to this run's won outcome: delivered spend when reporting exists, else the booked media-buy budget. Null unless the outcome persisted both an amount and its currency.

briefArtifactId
string | null
required

Canonical brief artifact id (AI-4693) for the build-3 drill-in. Null = artifact unavailable (historical pre-capture run).

proposalArtifactId
string | null
required

Canonical proposal artifact id for the build-3 drill-in. Null = no proposal artifact captured.

artifactAvailable
boolean
required

False when the brief artifact was not captured; readers must say "artifact unavailable" rather than reconstruct it.