Skip to main content
PATCH
Override a prospect's pipeline stage
Pins a prospect to a pipeline stage, or clears the override. Body: stage - contacted, negotiating, or null to clear. won cannot be set: it means a verified live link, so use Re-check links. The stage is normally derived from real signals - contacts found, mail sent, replies received, links confirmed - so only override it to record something that happened off-platform. You can switch between contacted and negotiating in either direction, but never below what the rows already prove: a move below the derived stage returns 409. An override never hides a reply or a confirmed link that arrives later.

Authorizations

Authorization
string
header
required

Your SnowSEO API key (sk_...).

Path Parameters

id
string
required

Prospect ID.

Body

application/json
stage
enum<string> | null
required

Stage to pin, or null to clear the override.

Available options:
contacted,
negotiating,
null

Response

200 - application/json

Default Response

stage
string
manualStage
string | null