deal

Deals represent revenue opportunities in your pipeline. Each deal has a stage, value, and optional links to contacts and companies. Use these commands to create, update, and move deals through your pipeline.

moss deal list

List deals with optional filtering.

moss deal list
moss deal list --stage qualified --min-value 10000
moss deal list --owner-id me

Option	Required	Description
`--page <n>`	No	Page number
`--per-page <n>`	No	Items per page
`--sort <field>`	No	Sort field (`name`, `value`, `expected_close`, `created_at`)
`--order <dir>`	No	Sort order (`asc` or `desc`)
`--q <query>`	No	Full-text search query
`--stage <stage>`	No	Filter by stage (`lead`, `qualified`, `proposal`, `negotiation`, `won`, `lost`)
`--company-id <id>`	No	Filter by company
`--contact-id <id>`	No	Filter by linked contact
`--owner-id <id>`	No	Filter by owner (UUID or `"me"` for current user)
`--min-value <n>`	No	Minimum deal value
`--max-value <n>`	No	Maximum deal value
`--tag <name>`	No	Filter by tag name

moss deal show

Show details for a single deal.

moss deal show --id deal_abc123

Option	Required	Description
`--id <id>`	Yes	Deal ID

moss deal create

Create a new deal.

moss deal create \
  --name "Acme Corp - Enterprise" \
  --value 50000 \
  --stage lead \
  --company-id cmp_abc123 \
  --owner-id me

Option	Required	Description
`--name <name>`	Yes	Deal name
`--company-id <id>`	No	Company ID
`--stage <stage>`	No	Stage: `lead`, `qualified`, `proposal`, `negotiation`, `won`, `lost` (default: `lead`)
`--value <n>`	No	Deal value
`--currency <code>`	No	Currency code (default: `USD`)
`--expected-close <date>`	No	Expected close date (`YYYY-MM-DD`)
`--owner-id <id>`	No	Owner user ID
`--notes <text>`	No	Free-text notes
`--tags <tags>`	No	Comma-separated tag names
`--set <key=value>`	No	Set a custom field value (repeatable)

moss deal create-batch

Create multiple deals from a JSON file. Each object in the array takes the same fields as moss deal create.

moss deal create-batch --file deals.json

cat deals.json | moss deal create-batch --file -

Option	Required	Description
`--file <path>`	Yes	Path to JSON file containing an array of deal objects, or `"-"` for stdin

moss deal update

Update an existing deal.

moss deal update --id deal_abc123 --value 75000 --owner-id usr_def456

Option	Required	Description
`--id <id>`	Yes	Deal ID
`--name <name>`	No	Deal name
`--company-id <id>`	No	Company ID
`--value <n>`	No	Deal value
`--currency <code>`	No	Currency code
`--expected-close <date>`	No	Expected close date (`YYYY-MM-DD`)
`--owner-id <id>`	No	Owner user ID
`--notes <text>`	No	Free-text notes
`--tags <tags>`	No	Comma-separated tag names
`--set <key=value>`	No	Set a custom field value (repeatable)

moss deal move

Move a deal to a new stage.

moss deal move --id deal_abc123 --stage proposal
moss deal move --id deal_abc123 --stage lost --lost-reason "Budget cut"

Option	Required	Description
`--id <id>`	Yes	Deal ID
`--stage <stage>`	Yes	Target stage: `lead`, `qualified`, `proposal`, `negotiation`, `won`, `lost`
`--lost-reason <reason>`	No	Reason (required when moving to `lost`)

moss deal bulk-move

Move multiple deals to a new stage at once.

moss deal bulk-move --ids deal_a1,deal_b2,deal_c3 --stage negotiation --confirm

Option	Required	Description
`--ids <ids>`	Yes	Comma-separated deal IDs
`--stage <stage>`	Yes	Target stage: `lead`, `qualified`, `proposal`, `negotiation`, `won`, `lost`
`--confirm`	Yes	Confirm bulk operation (required)

moss deal delete

Delete a deal permanently.

moss deal delete --id deal_abc123 --confirm

Option	Required	Description
`--id <id>`	Yes	Deal ID
`--confirm`	Yes	Confirm deletion (required for destructive operations)

This permanently deletes the deal. This cannot be undone.

Deal Contact Commands

Manage contacts linked to a deal.

moss deal contact list

List contacts linked to a deal.

moss deal contact list --deal-id deal_abc123

Option	Required	Description
`--deal-id <id>`	Yes	Deal ID

moss deal contact link

Link a contact to a deal.

moss deal contact link --deal-id deal_abc123 --contact-id cnt_def456 --role "Decision Maker"

Option	Required	Description
`--deal-id <id>`	Yes	Deal ID
`--contact-id <id>`	Yes	Contact ID
`--role <role>`	No	Contact’s role in the deal

moss deal contact unlink

Remove a contact from a deal.

moss deal contact unlink --deal-id deal_abc123 --contact-id cnt_def456

Option	Required	Description
`--deal-id <id>`	Yes	Deal ID
`--contact-id <id>`	Yes	Contact ID

Overview

Authentication

CRM Data

Views & Search

Operations

moss deal list

moss deal show

moss deal create

moss deal create-batch

moss deal update

moss deal move

moss deal bulk-move

moss deal delete

Deal Contact Commands

moss deal contact list

moss deal contact link

moss deal contact unlink

​moss deal list

​moss deal show

​moss deal create

​moss deal create-batch

​moss deal update

​moss deal move

​moss deal bulk-move

​moss deal delete

​Deal Contact Commands

​moss deal contact list

​moss deal contact link

​moss deal contact unlink

moss deal list

moss deal show

moss deal create

moss deal create-batch

moss deal update

moss deal move

moss deal bulk-move

moss deal delete

Deal Contact Commands

moss deal contact list

moss deal contact link

moss deal contact unlink