Manage pipeline

Programmatically manage the same pipelines your team uses in the app: read pipelines and their stages, and add, move, update, or remove pursuits. The API sees the pipelines visible to the admin who created your key — their own pipelines plus any shared with the org. Creating or deleting whole pipelines and editing stages is app-only for now.

List pipelines

GET /v1/pipelines

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "a74efcf5-f958-4ff1-84c9-3c8dc91db100",
        "name": "Team Pipeline",
        "sharedWithOrg": true,
        "owner": { "id": "…", "name": "…", "email": "…" },
        "pursuitCount": 12,
        "updatedAt": "2026-07-20T18:00:00.000Z"
      }
    ]
  }
}

Get a pipeline (with stages)

GET /v1/pipelines/{pipelineId}

The response includes the ordered stages array. You’ll need a stage.id to move pursuits between stages.

List pursuits

GET /v1/pipelines/{pipelineId}/pursuits?limit=200

Add a pursuit

POST /v1/pipelines/{pipelineId}/pursuits

Body (noticeId and title required — take them from contract search results):

{
  "noticeId": "f450a08d093f48a587bae8a3588909f4",
  "title": "Security Programs Operational Support",
  "agency": "GSA",
  "naicsCode": "541512",
  "state": "VA",
  "responseDeadLine": "2026-08-01",
  "uiLink": "https://…",
  "note": "Found via API — strong past-performance fit"
}

New pursuits land in the pipeline’s first stage. Adding the same noticeId twice is idempotent — you get the existing pursuit back.

Update a pursuit

PATCH /v1/pipelines/{pipelineId}/pursuits/{pursuitId}

Any subset of:

{
  "stageId": "352231b0-e80c-4a68-90a4-a3477c0f1bf0",
  "note": "Qualified after capture call",
  "pWin": 40,
  "pGo": 90,
  "estimatedValueCents": 25000000
}

Moving to a stage applies that stage’s default P(win)/P(go) unless you pass explicit values. The response includes the computed weightedValueCents.

Remove a pursuit

DELETE /v1/pipelines/{pipelineId}/pursuits/{pursuitId}

{pursuitId} accepts either the pursuit’s id (uuid) or its noticeId.

{ "success": true, "data": { "id": "f450a08d093f48a587bae8a3588909f4" } }

Getting started

Endpoints

List pipelines

Get a pipeline (with stages)

List pursuits

Add a pursuit

Update a pursuit

Remove a pursuit

​List pipelines

​Get a pipeline (with stages)

​List pursuits

​Add a pursuit

​Update a pursuit

​Remove a pursuit

List pipelines

Get a pipeline (with stages)

List pursuits

Add a pursuit

Update a pursuit

Remove a pursuit