Skip to main content
PATCH
Save a canonical estimate independently of hierarchy summaries

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

team_id
string
required

Team ID is an alphanumerical string that identifies a Team. This is externally referred to as a "Workspace".

card_id
string
required

Card ID is a numerical string that identifies a card.

Body

application/json
estimate_seconds
integer<int64> | null
required

Planned duration in seconds. Pass zero to clear.

Required range: x >= 0
Example:

28800

version
integer<int64> | null
required

Pass zero when no estimate exists; otherwise pass the current version.

Required range: x >= 0
Example:

1

estimate_kind
enum<string> | null

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.

Available options:
direct,
budget

Response

Committed canonical estimate, or null for an absent cleared estimate.

card_time_estimate
object | null

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.