Pitches

Pitches is where you decide what becomes a story. Each pitch is a scored story suggestion for one of your newsdesks: approve it and Nuvelics creates a story from it, or dismiss it. You can also write a pitch yourself from your own notes, links, files or library articles.

Every member can read pitches, Viewers included. Approving, dismissing, reopening and writing a pitch need the Member role or above (the pitch:write permission); without it those controls are missing. The page sits under Content in the sidebar. For a first walk-through, see Review your first pitch.

Find pitches in the listCopy Anchor Link

1. Open Pitches. The list opens on the New status, the review queue, with the Created range set to the last 24 hours. A pitch counts in that window by when it arrived in its current status, so a pitch approved ten minutes ago shows under Approved even if it was created last week.
2. Choose a status from the status filter: Draft, New, Approved or Dismissed.
3. Widen or change the Created range with Last hour, Last 6 hours, Last 24 hours, Last 7 days, Last 30 days or a Custom range.
4. Type in Search by title…, or choose + Add filter for Newsdesk, Topic, Location or Min. sources.

Each row shows the Title (with a Manual badge on a pitch someone wrote by hand), its Sources, Newsdesk, Score, Status, Created and Event date. A pitch you open from the list opens in a side panel; the Open as page icon opens it as a full page.

Nothing to review means no New pitch arrived within the Created range; widen the range to see older ones. Once you choose a status or add a filter, an empty list says No pitches match your filters. and offers Clear filters.

Switch to the boardCopy Anchor Link

The View control switches between List and Board, and Nuvelics remembers your choice. The board has one column per status, Draft, New, Approved and Dismissed, each with a count and a one-line hint, such as "Decided in this window" under Approved. The status filter is not used on the board, because the columns are the status; the other filters and the Created range still apply, and the range counts when each pitch entered its column.

To decide on a pitch from the board:

1. Drag its card to another column. At narrow widths, where dragging does not work, the card has buttons instead: Approve, Dismiss, Reopen and Create pitch.
2. Dropping on Approved asks you to confirm with Approve this pitch? and Approve. A story is created and a message reads "Approved “Your title” — story created."
3. Dropping on Dismissed dismisses at once, and dropping a dismissed card on New reopens it.

The moves the board allows follow the pitch's status: a Draft can go to New, Approved or Dismissed; a New pitch to Approved or Dismissed; a Dismissed pitch back to New or on to Approved. An Approved pitch cannot move again. A card can be dragged only by someone who can write pitches, and a draft only by the person who created it ("Only the person who created this draft can change it").

Read and decide on a pitchCopy Anchor Link

Choose a pitch to open it. The panel shows the title, Summary, Why it matters, the Score, Contributing sources, Contributing articles and Media, with View event to the event behind it. If a source was recalled by its vendor, a warning above the pitch says so; check it before relying on the pitch.

In the panel, Approve and Dismiss decide the pitch and Reopen brings a dismissed pitch back; the message after a decision offers Undo for a dismissal and Open story after an approval. The panel steps through the list with Previous pitch and Next pitch, and these keys work:

Approving creates a story and starts enrichment, and it cannot be undone. If spending is paused, approving is unavailable until it resumes; see Spend caps and usage.

Write a pitch yourselfCopy Anchor Link

Use New pitch when the story did not come from your data sources: a tip, a document, a link, a screenshot.

1. Choose New pitch. The New pitch form opens.
2. Under Newsdesk, choose a desk. The brief is written in that desk's language and scored against its beat.
3. Add what you are working from under Seed content: at least one, and up to 10 in all.
   • Add URL takes up to five links, each a public https page or a single X post.
   • Upload files takes up to five PDFs or JPEG, PNG or WebP images; the form shows the size limits beside the control.
   • Add text takes a text block for notes, a tip or a pasted message.
   • Add from library takes articles your data sources have already collected.
4. Optionally set the Event date and a Pitch angle, the framing you want. The angle steers the title, summary and why it matters; the facts still come from the seeds.
5. If you added X posts, choose an X credential. X posts are fetched with your organization's own credential. If none is tagged for X, the form says so and links to Go to credentials; see Credentials.
6. Choose Preview pitch.

Nuvelics writes a brief from your seeds ("Writing the brief…"). You can leave the page: the draft appears in the Draft column of the board, and a Your pitch requests strip above the list shows requests still being built, with Edit and retry and Dismiss for one that Couldn't be built.

When it is ready, Your draft is ready shows the title, Summary, Why it matters, the Sources and notes about the draft. Your own notes, PDFs and images are marked Internal: they inform the brief and the story's enrichment, and are never sent to your newsroom or content systems. An image is sent out only as story media, when its Use as story media switch is on. Then choose:

• Create pitch to send it to the review queue as a New pitch.
• Create pitch and approve to approve it at once.
• Leave as draft to keep it as a Draft, visible to your desk but changeable only by you.
• Edit seeds to change the angle or seeds and preview again. The new draft replaces the old one, which is deleted.

A preview is written with paid model calls, so it cannot be sent while spending is paused. A manual pitch carries a Manual badge from then on, and approving it is the same as approving any other.

Other ways to work with pitchesCopy Anchor Link

• CLI: nuvelics pitch.
• API: Pitches and, for manual pitches, Pitch requests.
• AI assistants: the pitch tools, including approve_pitch, dismiss_pitch, preview_pitch and submit_pitch.
• What a pitch is and how it moves between statuses: Lifecycles.