Skip to content

List Configs

GET
/api/v1/configs

List all active pipeline configurations with pagination.

Each entry carries a validation_report and is_runnable field re-derived against the current adapter registry. Registry drift (a renamed/removed adapter) is surfaced automatically without requiring a user re-save.

Args: service: Execution service (injected) container: Service container (injected) limit: Maximum number of results per page (default: 100) offset: Number of records to skip for pagination (default: 0)

Returns: Paginated list of configurations with total count

limit
Limit

Maximum results per page

integer
default: 100 >= 1 <= 1000

Maximum results per page

offset
Offset

Number of records to skip

integer
0

Number of records to skip

Successful Response

ConfigListResponse

Paginated list of pipeline configurations.

object
total
required
Total

Total number of configurations matching filters

integer
limit
required
Limit

Maximum entries per page

integer
offset
required
Offset

Offset from start

integer
has_more
required
Has More

Whether more configurations exist

boolean
configs
required
Configs

List of configurations

Array<object>
PipelineConfigResponse

Pipeline configuration response.

Note: Renamed from ConfigResponse to avoid schema collision with SystemConfigResponse.

object
id
required
Id

Configuration UUID

string format: uuid
name
required
Name

Configuration name

string
description
Any of:
string
source_type
required
Source Type

Origin of config

string
Allowed values: file api imported
source_path
Any of:
string
config_hash
required
Config Hash

SHA-256 hash of config

string
version
required
Version

Version number

integer
created_at
required
Created At

Creation timestamp

string format: date-time
updated_at
required
Updated At

Last update timestamp

string format: date-time
is_active
required
Is Active

Whether config is active

boolean
validation_report
Any of:
ValidationReportResponse

Validation report returned by the config validator.

Returned verbatim in 200 responses from POST /configs/validate and embedded in 400 responses from create/update/run endpoints when validation fails.

object
is_valid
required
Is Valid

True when no errors present; warnings do not invalidate

boolean
issues
Issues

All findings, errors first then warnings

Array<object>
ValidationIssueResponse

A single validation finding emitted by the pipeline config validator.

object
severity
required
Severity

Error or warning

string
Allowed values: error warning
code
required
Code

Stable error code (e.g. E202, W501)

string
path
required
Path

Path into the config where the issue was found

string
message
required
Message

Human-readable description of the issue

string
suggestion
required
Suggestion

Deterministic, authoritative remediation guidance

string
error_count
required
Error Count

Number of errors

integer
warning_count
required
Warning Count

Number of warnings

integer
is_runnable
Is Runnable

True when the config passes validation (error_count == 0). Warnings do not invalidate. Mirrors ValidationReport.is_valid.

boolean
default: true

Validation Error

HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object