Nuvelics documentation
CLICommand reference

nuvelics pitch

Usage, options and details of the nuvelics pitch commands.

nuvelics pitch approve [id]

Approve a pitch

nuvelics pitch create

Create a pitch from your own evidence

Previews a pitch for a newsdesk from seeds you supply, waits for the draft to be built (up to three minutes), and prints it. Seeds keep the order the flags are given in. Without --submit or --approve the pitch stays a draft: the desk sees it, but it is not announced or delivered until someone submits or approves it.

Each --file takes a PDF or an image (.jpg, .jpeg, .png, .webp) and uploads it first. An image named by --no-media, which must also be given as --file, does not become the story's media. Passing --text - reads the text from stdin.

  • --newsdesk <id> — Newsdesk the pitch is for
  • --text <text|-> — A text seed; - reads stdin (repeatable)
  • --file <path> — A PDF or image to upload as a seed (repeatable)
  • --seed <url> — A URL seed: a web article or an X post (repeatable)
  • --article <id> — A library article ID as a seed (repeatable)
  • --no-media <path> — A --file image that must not become the story's media (repeatable)
  • --event-date <YYYY-MM-DD> — Event date, YYYY-MM-DD
  • --angle <text> — The framing the brief should take; steers the title and summary, not the facts
  • --x-credential <id> — Credential ID used to read X post seeds
  • --replaces <id> — Draft pitch ID this preview replaces
  • --submit — Move the draft into the review queue once it is built
  • --approve — Approve the draft once it is built

nuvelics pitch dismiss [id]

Dismiss a pitch

nuvelics pitch get [id]

Get a pitch by ID

nuvelics pitch list

List generated pitches

Use --filter, --limit, --all, and --cursor to control which pitches are returned.

  • --filter <field.op=value> — Filter: field.op=value (repeatable)
  • --limit <n> — Maximum total pitches to fetch (default 100)
  • --all — Fetch all pages without a count bound
  • --cursor <cursor> — Start from this pagination cursor

nuvelics pitch reopen [id]

Reopen a dismissed pitch, putting it back in the review queue

nuvelics pitch submit [id]

Move a draft pitch into the review queue

Report a problem with this page

On this page