List synthesis runs

GET

/synthesis-runs

• Production API

List synthesis runs with optional filtering by pipeline, team, status, or date range.

Authorizations

• bearerAuth
• cookieAuth

Parameters

Query Parameters

synthesisRunIds

Comma-separated list of synthesis run IDs to filter by

string

nullable

Comma-separated list of synthesis run IDs to filter by

pipelineIds

Comma-separated list of pipeline IDs to filter by

string

nullable

Comma-separated list of pipeline IDs to filter by

teamIds

Comma-separated list of team IDs to filter by

string

nullable

Comma-separated list of team IDs to filter by

statuses

Comma-separated list of statuses to filter by (pending, generating, generated, approved, rejected, failed)

string

nullable

Comma-separated list of statuses to filter by (pending, generating, generated, approved, rejected, failed)

handlerTypes

Comma-separated list of handler types to filter by (e.g., ‘apg_v1’)

string

nullable

Comma-separated list of handler types to filter by (e.g., ‘apg_v1’)

createdBy

Filter by user who created the synthesis

string

Filter by user who created the synthesis

createdAfter

Filter to synthesis runs created after this date

string format: date-time

nullable

Filter to synthesis runs created after this date

createdBefore

Filter to synthesis runs created before this date

string format: date-time

nullable

Filter to synthesis runs created before this date

page

Page number for pagination (1-indexed)

number

>= 1

Page number for pagination (1-indexed)

pageSize

Number of results per page (1-100, default: 50)

number

>= 1 <= 100

Number of results per page (1-100, default: 50)

orderBy

Field to sort results by

string

Allowed values: createdAt appliedAt status

Field to sort results by

orderDirection

Sort direction: ascending or descending

string

Allowed values: asc desc

Sort direction: ascending or descending

Responses

200

Synthesis runs retrieved successfully

object

synthesisRuns

required

Array of synthesis runs matching the query

Array<object>

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

total

required

Total number of synthesis runs matching the query (before pagination)

number

page

required

Current page number

number

pageSize

required

Number of results per page

number

400

Bad Request - Validation error or invalid input

object

error

required

string

code

string

details

nullable

retryable

boolean

401

Unauthorized - Authentication required or invalid token

object

error

required

string

code

string

details

nullable

retryable

boolean

403

Forbidden - Insufficient permissions

object

error

required

string

code

string

details

nullable

retryable

boolean