Skip to main content
POST
Review a Run
Rate what this one Run was expected to contribute, not the whole task. The first review of a Run is kept: a repeat returns 200 with already_reviewed and is not saved. A review never changes the Run, its result or its charge.

Path Parameters

runId
string<uuid>
required
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$

Body

application/json
rating
enum<string>
required

Rate what this one Run was expected to contribute, not the whole task. Example: the Run was asked for 20 companies that match the criteria and have verified emails. exceeds_expectations: did its part plus more that is useful (all 20 match and all 20 have verified emails, plus recent buying signals usable for outreach). meets_expectations: did its part (all 20 match and all 20 have verified emails). partially_meets_expectations: a known shortfall (all 20 match the criteria, only 5 have verified emails). does_not_meet_expectations: the result is not usable for its part (none are in the target industry). unable_to_assess: not enough evidence to judge (emails returned with no verification status and no way to tell). If another Run was meant to verify the emails, a Run that found 20 matching companies meets expectations.

Available options:
exceeds_expectations,
meets_expectations,
partially_meets_expectations,
does_not_meet_expectations,
unable_to_assess
reason
string | null

Optional. Why you chose the rating, in at most 200 characters: what was missing, wrong or especially useful. Omit private data.

Maximum string length: 200

Response

the Run already has a review; the first one is kept

review_id
string
required
run_id
string
required
status
enum<string>
required

recorded: this submission was saved. already_reviewed: this Run already has a review; the first one is kept and this submission was not saved.

Available options:
recorded,
already_reviewed
created_at
string<date-time>
required

When the kept review was submitted.