Skip to main content
POST
Validate Agent configuration source

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

checkfu-version
enum<string>
required
Available options:
2026-08-31

Path Parameters

organization_id
string
required
Pattern: ^org_[0-9a-f]{32}$

Body

application/json

Request wrapper carrying one closed source input union.

source
object
required

Bounded inline entries or one exact governed source revision.

Response

Stateless source-validation outcome: validity, diagnostics, digests, and bounded counts.

Stateless source-validation outcome: validity, diagnostics, digests, and bounded counts.

valid
boolean
required

True when the source compiled to the canonical final-Agent configuration.

source_sha256
string | null
required

Versioned digest over the admitted source file set; null when nothing was admitted.

Pattern: ^sha256:[0-9a-f]{64}$
content_sha256
string | null
required

SHA-256 over the compiled canonical Agent directory files; null when invalid.

Pattern: ^sha256:[0-9a-f]{64}$
compiler_version
string
required

Server compiler version that produced this inspection.

Pattern: ^[A-Za-z0-9][A-Za-z0-9._+-]{0,63}$
authoring_epoch
enum<string>
required

The single admitted authoring epoch.

Available options:
checkfu.dev/v1alpha1
diagnostics
object[]
required

Bounded refusals; empty exactly when valid.

Maximum array length: 8
summary
object | null
required

Compiled configuration counts; null when the source is invalid.