Save a time estimate
Saves or clears the time-tracking-owned estimate with optimistic concurrency. Returns the committed canonical estimate without traversing descendants or reading time entries. A subsequent summary failure cannot turn this successful write into a failed save. The existing Boards effort estimate is not changed. Omitted estimate_kind preserves the stored kind, including on cleared records; new records default to direct. Explicit conversion supplies the current value, current version and new kind. Zero clears the value without discarding kind/version. Clearing a card with no stored estimate is a successful no-op returning null. Requires estimate edit access. Existing ordinary-card time-entry logging settings are unaffected; estimate editing is independent of a space’s logging switch, including for roadmap projects.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Team ID is an alphanumerical string that identifies a Team. This is externally referred to as a "Workspace".
Card ID is a numerical string that identifies a card.
Body
Planned duration in seconds. Pass zero to clear.
x >= 028800
Pass zero when no estimate exists; otherwise pass the current version.
x >= 01
direct estimates work on this card only; budget is an inclusive ceiling for this card and its descendants. Omitted stored kind means direct. Missing or zero duration does not establish an active budget, regardless of retained kind.
direct, budget Response
Committed canonical estimate, or null for an absent cleared estimate.
Canonical estimate or explicit null in authoritative batch and save responses. Named composition preserves nullable object and JSON presence semantics in generated clients without changing the legacy CardTimeEstimate representation.