Building a webhook integration? Read the webhook guide for signatures, retries, event schemas, and troubleshooting.

apiHosted AI, explicit consent

Revise icp rubric

POST /api/v1/icp-tuning/revise

Revise a brief ICP rubric from QA corrections on a canary sample. Pass the sample returned by get-icp-tuning-sample, operator corrections, and the current rubric. Returns { revisedRubric, rationale } without saving.

Parameters

workspaceId

string

Optional workspace ID or slug. Required when this credential can access multiple workspaces and no workspace was configured on the client.

briefIdrequired

string

Campaign brief id.

samplerequired

unknown[]

Sample rows from get-icp-tuning-sample.

correctionsrequired

unknown[]

Operator judgments: rowId plus verdict fit, unfit, or skip.

currentRubricrequired

object

The rubric to revise. Usually the rubric returned by get-icp-tuning-sample.

allowHostedAi

boolean

Must be true when this operation uses Pipeline hosted inference.

Example

REST requestbash

curl -X POST "https://app.pipeline.help/api/v1/icp-tuning/revise" \
  -H "Authorization: Bearer $PIPELINE_API_KEY" \
  -H "X-Pipeline-Execution-Policy: hosted-enabled" \
  -H "Content-Type: application/json" \
  -d '{"briefId":"00000000-0000-4000-8000-000000000000","sample":[{"rowId":"row_01"}],"corrections":[{"rowId":"row_01","verdict":"fit"}],"currentRubric":{"naturalLanguageCriteria":"Founder-led B2B software companies"},"allowHostedAi":true}'

Response

The operation is available, but its typed response schema has not been published yet.

HTTP errors

401: Missing or invalid API key.
403: Authenticated but not permitted for the workspace or resource.
404: The requested resource was not found.