Skip to content

Reject synthesis proposal

POST
/synthesis-runs/{synthesisRunId}/reject

Rejects a generated synthesis run. The proposed configuration is not applied.

synthesisRunId
required

ID of the synthesis run to reject

string

ID of the synthesis run to reject

Synthesis rejected successfully

object
synthesisRunId
required

Unique identifier for the synthesis run (nanoid format)

string
pipelineId
required

ID of the pipeline this synthesis is for

string
teamId
required

ID of the team that owns the pipeline

string
status
required

Status: ‘pending’, ‘generating’, ‘generated’, ‘approved’, ‘rejected’, or ‘failed’

string
Allowed values: pending generating generated approved rejected failed
handlerType
required

Synthesis handler/algorithm used for this run (e.g., ‘apg_v1’)

string
Allowed values: apg_v1
configurationBeforeId
required

ID of the pipeline configuration before synthesis

string
configurationAfterId
required

ID of the proposed configuration (null until generation completes)

string
nullable
reasoning
required

Legacy: LLM explanation text (use diagnosis/changes for new runs)

string
nullable
warnings
required

Legacy: String warnings (use structuredWarnings for new runs)

Array<string>
nullable
diagnosis
required

Structured diagnosis with summary and findings from signal analysis

object
summary
required

1-2 sentence summary of overall issues

string
findings
required
Array<object>
object
id
required

Simple numeric ID: ‘1’, ‘2’, ‘3’

string
type
required
string
Allowed values: pain_point error_pattern opportunity positive
description
required

What the signals indicate

string
signalIds
required

Actual signal IDs (mapped from LLM numeric refs)

Array<string>
severity
string
Allowed values: low medium high
changes
required

Proposed changes with per-change rationale

Array<object>
nullable
object
id
required

Simple numeric ID: ‘1’, ‘2’, ‘3’

string
type
required
string
Allowed values: add modify remove
section
required
string
Allowed values: inputsSchema outputsSchema configuration
category
required
string
Allowed values: files datasets dataInputs
slotId
required

The ID of the slot being changed

string
description
required

Human-readable description of the change

string
rationale
required

Why this change addresses the issues

string
findingRefs
required

Finding IDs this change addresses: [‘1’, ‘2’]

Array<string>
structuredWarnings
required

Typed warnings with optional change references

Array<object>
nullable
object
type
required
string
Allowed values: breaking_change assumption tradeoff needs_review
message
required
string
changeRefs

Change IDs this warning relates to

Array<string>
confidence
required

Overall confidence level based on signal quality/quantity

string
nullable
Allowed values: low medium high
signalIds
required

IDs of signals that were analyzed for this synthesis

Array<string>
jobId
required

ID of the job processing this synthesis

string
nullable
errorMessage
required

Error message if synthesis generation failed

string
nullable
createdAt
required

ISO 8601 timestamp when the synthesis was created

string format: date-time
createdBy
required

ID of the user who triggered the synthesis

string
nullable
startedAt
required

ISO 8601 timestamp when synthesis generation started

string format: date-time
nullable
completedAt
required

ISO 8601 timestamp when synthesis generation completed (success or failure)

string format: date-time
nullable
appliedAt
required

ISO 8601 timestamp when the synthesis was approved and applied

string format: date-time
nullable
appliedBy
required

ID of the user who approved and applied the synthesis

string
nullable

Bad Request - Validation error or invalid input

object
error
required
string
code
string
details
nullable
retryable
boolean

Unauthorized - Authentication required or invalid token

object
error
required
string
code
string
details
nullable
retryable
boolean

Forbidden - Insufficient permissions

object
error
required
string
code
string
details
nullable
retryable
boolean

Not Found - Resource does not exist

object
error
required
string
code
string
details
nullable
retryable
boolean

Conflict - Resource already exists or operation conflicts with current state

object
error
required
string
code
string
details
nullable
retryable
boolean