Update Deal
Module · Stable
Update one or more fields on a deal. Pass a ‘fields’ dict (preferred) or use legacy field/value for a single update. Allowed fields: name, company_id, primary_contact_id, value_amount, value_currency, expected_close_date, owner_actor_id. Use crm_deal_move_stage to change stage.
Updates deal fields. Preferred: pass a fields dict. Note: to move the pipeline stage use crm_deal_move_stage instead — it handles closed_at stamping and returns transition metadata.
When to use
Section titled “When to use”Use when an upstream step (Create Deal, Find Deal, or List Deals) supplies a deal_id and you need to patch metadata — rename the deal, reassign an owner, update the value or expected close date. Pass a fields dict to update several attributes in one step; the updated boolean feeds downstream Branch or Checkpoint conditions.
When not to use
Section titled “When not to use”To advance a deal through the pipeline, use Move Deal Stage — it stamps closed_at on won/lost transitions and returns stage metadata. To create a brand-new deal, use Create Deal. To attach a note rather than changing a field, use Add Note instead.
Inputs
Section titled “Inputs”Configured per use: deal_id, fields, field, value.
Outputs
Section titled “Outputs”Auto-generated from the skill registry (load_skills()). Do not edit by hand.