Type object
File match specmatic.json specmatic.yaml specmatic.yml
Schema URL https://catalog.lintel.tools/schemas/schemastore/specmatic-configuration/latest.json
Source https://www.schemastore.org/specmatic.json

Validate with Lintel

npx @lintel/lintel check
Type: object

Configuration file for Specmatic, a contract-driven testing tool https://specmatic.io/documentation/

Properties

version integer required
Default: 2

All of

1. variant

Definitions

ConfigV3 object
version integer required
Values: 3
systemUnderTest object
1 nested properties
service object
One of: object object, object object
6 nested properties
$ref string
definitions object[]
description string
runOptions
data object
settings
dependencies object
3 nested properties
services object[]
data object
3 nested properties
examples
dictionary
adapters
settings
proxies object[]
mcp object
1 nested properties
test object
7 nested properties
baseUrl string
transportKind string | SubstitutableString
enableResiliencyTests boolean | GuardedSubstitutionString
dictionaryFile string
bearerToken string
filterTools SubstitutableString[]
specmatic object
3 nested properties
license object
1 nested properties
path string
governance object
2 nested properties
report object
successCriteria object
settings
components object
8 nested properties
services Record<string, object>
runOptions Record<string, object>
examples object
3 nested properties
dictionaries Record<string, object>
adapters Record<string, object>
certificates Record<string, object>
settings Record<string, ConcreteSettings | ModeSpecificSettings>
ConfigV2 object
version integer required

Configuration version for Specmatic

Values: 2
contracts ContractConfig[] required

Array of contract configurations

auth object

Authentication configuration

2 nested properties
bearer-file string

Path to file containing bearer token

bearer-environment-variable string | null

Environment variable name containing bearer token

pipeline object

Azure DevOps pipeline configuration

4 nested properties
provider string

Pipeline provider type

Values: "azure"
organization string

Azure DevOps organization name

project string

Azure DevOps project name

definitionId integer

Pipeline definition ID

environments Record<string, object>

Environment-specific configurations

hooks Record<string, string>

Custom hooks configuration

repository object

Repository information

2 nested properties
provider string

Repository provider type

collectionName string

Name of the collection

report object

Report generation configuration

2 nested properties
formatters array | null

List of report formatters

types object

Configuration for different report types

1 nested properties
APICoverage object

API coverage report configuration

security object

Security configuration

1 nested properties
OpenAPI object

OpenAPI security configuration

1 nested properties
securitySchemes Record<string, object>

Security scheme configurations

test object

Test execution configuration

6 nested properties
resiliencyTests object

Configuration for resiliency tests

1 nested properties
enable string | null

Level of resiliency tests to enable

Values: "all" "positiveOnly" "none"
validateResponseValues boolean | null

Whether to validate response values

allowExtensibleSchema boolean | null

Whether to allow extensible schema validation

timeoutInMilliseconds integer | null

Test timeout in milliseconds

strictMode boolean | null

Whether to enable strict mode for contract testing

https object
3 nested properties
keyStorePassword string
mtlsEnabled boolean | GuardedSubstitutionString
stub object

Stub/mock server configuration

8 nested properties
generative boolean | null

Whether to enable generative stubbing

delayInMilliseconds integer | null

Delay to add to stub responses in milliseconds

dictionary string | null

Path to dictionary file for generative stubbing

includeMandatoryAndRequestedKeysInResponse boolean | null

Whether to include mandatory and requested keys in response

startTimeoutInMilliseconds integer | null

Timeout for stub server startup in milliseconds

hotReload string | null

Hot reload configuration

strictMode boolean | null

Whether to enable strict mode for stubbing

https object
3 nested properties
keyStorePassword string
mtlsEnabled boolean | GuardedSubstitutionString
virtualService object

Virtual service configuration

1 nested properties
nonPatchableKeys string[]

List of keys that cannot be patched

examples string[]

List of example file paths

workflow object

Workflow configuration for ID management

1 nested properties
ids Record<string, object>

ID operation configurations

ignoreInlineExamples boolean | null

Whether to ignore inline examples in specifications

additionalExampleParamsFilePath string | null

Path to additional example parameters file

attributeSelectionPattern object

Pattern for selecting attributes in API responses

2 nested properties
default_fields array | null

Default fields to include

query_param_key string | null

Query parameter key for field selection

allPatternsMandatory boolean | null

Whether all patterns are mandatory

defaultPatternValues object

Default values for patterns

disable_telemetry boolean

Whether to disable telemetry data collection

ContractConfig object

Defines a contract source and its provides/consumes configuration.

git object

Git contract source details.

3 nested properties
url string | null

URL of the git repository.

branch string | null

Branch name in the git repository.

matchBranch boolean
filesystem object

Filesystem contract source details.

1 nested properties
directory string

Directory path for contract files.

provides array | null

List of specs provided for testing. Each entry can be a string or an object.

consumes array | null

List of specs consumed for stubbing. Each entry can be a string or an object.

Auth object

Authentication configuration

bearer-file string

Path to file containing bearer token

bearer-environment-variable string | null

Environment variable name containing bearer token

Pipeline object

Azure DevOps pipeline configuration

provider string

Pipeline provider type

Values: "azure"
organization string

Azure DevOps organization name

project string

Azure DevOps project name

definitionId integer

Pipeline definition ID

Environment object

Environment-specific configuration

baseurls Record<string, string>

Base URLs for different services

variables Record<string, string>

Environment variables

RepositoryInfo object

Repository information

provider string

Repository provider type

collectionName string

Name of the collection

ReportConfigurationDetails object

Report generation configuration

formatters array | null

List of report formatters

types object

Configuration for different report types

1 nested properties
APICoverage object

API coverage report configuration

1 nested properties
OpenAPI object

OpenAPI coverage configuration

ReportFormatterDetails object

Configuration for a specific report formatter

type string | null

Type of report formatter

Values: "text" "html" "ctrf"
layout string | null

Layout style for the report

Values: "table"
lite boolean | null

Whether to generate a lite version of the report

title string | null

Title for the report

logo string | null

Path to logo image for the report

logoAltText string | null

Alt text for the logo

heading string | null

Heading for the report

outputDirectory string | null

Directory to output the report

ReportTypes object

Configuration for different report types

APICoverage object

API coverage report configuration

1 nested properties
OpenAPI object

OpenAPI coverage configuration

2 nested properties
successCriteria object

Success criteria for API coverage

excludedEndpoints array | null

List of endpoints to exclude from coverage

APICoverage object

API coverage report configuration

OpenAPI object

OpenAPI coverage configuration

2 nested properties
successCriteria object

Success criteria for API coverage

3 nested properties
minThresholdPercentage integer | null

Minimum coverage percentage threshold

maxMissedEndpointsInSpec integer | null

Maximum number of missed endpoints allowed

enforce boolean | null

Whether to enforce the success criteria

excludedEndpoints array | null

List of endpoints to exclude from coverage

APICoverageConfiguration object

OpenAPI coverage configuration

successCriteria object

Success criteria for API coverage

3 nested properties
minThresholdPercentage integer | null

Minimum coverage percentage threshold

maxMissedEndpointsInSpec integer | null

Maximum number of missed endpoints allowed

enforce boolean | null

Whether to enforce the success criteria

excludedEndpoints array | null

List of endpoints to exclude from coverage

SuccessCriteria object

Success criteria for API coverage

minThresholdPercentage integer | null

Minimum coverage percentage threshold

maxMissedEndpointsInSpec integer | null

Maximum number of missed endpoints allowed

enforce boolean | null

Whether to enforce the success criteria

SecurityConfiguration object

Security configuration

OpenAPI object

OpenAPI security configuration

1 nested properties
securitySchemes Record<string, object>

Security scheme configurations

OpenAPISecurityConfiguration object

OpenAPI security configuration

securitySchemes Record<string, object>

Security scheme configurations

SecuritySchemeConfiguration object

Configuration for a security scheme

type string

Type of security scheme

Values: "oauth2" "basicAuth" "bearer" "apiKey"
token string | null

Authentication token

value string | null

Authentication value

TestConfiguration object

Test execution configuration

resiliencyTests object

Configuration for resiliency tests

1 nested properties
enable string | null

Level of resiliency tests to enable

Values: "all" "positiveOnly" "none"
validateResponseValues boolean | null

Whether to validate response values

allowExtensibleSchema boolean | null

Whether to allow extensible schema validation

timeoutInMilliseconds integer | null

Test timeout in milliseconds

strictMode boolean | null

Whether to enable strict mode for contract testing

https object
3 nested properties
keyStorePassword string
mtlsEnabled boolean | GuardedSubstitutionString
ResiliencyTestsConfig object

Configuration for resiliency tests

enable string | null

Level of resiliency tests to enable

Values: "all" "positiveOnly" "none"
StubConfiguration object

Stub/mock server configuration

generative boolean | null

Whether to enable generative stubbing

delayInMilliseconds integer | null

Delay to add to stub responses in milliseconds

dictionary string | null

Path to dictionary file for generative stubbing

includeMandatoryAndRequestedKeysInResponse boolean | null

Whether to include mandatory and requested keys in response

startTimeoutInMilliseconds integer | null

Timeout for stub server startup in milliseconds

hotReload string | null

Hot reload configuration

strictMode boolean | null

Whether to enable strict mode for stubbing

https object
3 nested properties
keyStorePassword string
mtlsEnabled boolean | GuardedSubstitutionString
VirtualServiceConfiguration object

Virtual service configuration

nonPatchableKeys string[]

List of keys that cannot be patched

WorkflowConfiguration object

Workflow configuration for ID management

ids Record<string, object>

ID operation configurations

WorkflowIDOperation object

Configuration for ID operations in workflow

extract string | null

JSONPath expression to extract ID

use string | null

JSONPath expression to use extracted ID

AttributeSelectionPattern object

Pattern for selecting attributes in API responses

default_fields array | null

Default fields to include

query_param_key string | null

Query parameter key for field selection

SpecsArray string[]
StringValue string

A single spec path.

ObjectValueFullUrl object
baseUrl string required
specs string[] required
minItems=1
resiliencyTests object

Configuration for resiliency tests

1 nested properties
enable string | null

Level of resiliency tests to enable

Values: "all" "positiveOnly" "none"
ObjectValuePartialUrl object
specs string[] required
minItems=1
host string
port integer
basePath string
resiliencyTests object

Configuration for resiliency tests

1 nested properties
enable string | null

Level of resiliency tests to enable

Values: "all" "positiveOnly" "none"
ConfigValue object
specs string[] required
minItems=1
specType string required
config Record<string, string | integer | number | boolean | ConfigValueScalarOrComposite[] | object> required
ConfigValueScalarOrComposite string | integer | number | boolean | ConfigValueScalarOrComposite[] | object
SubstitutionExpression string
GuardedSubstitutionString string
SubstitutableString string
SubstitutableStringArray SubstitutableString[]
SubstitutableInteger integer | GuardedSubstitutionString
SubstitutableFloat number | GuardedSubstitutionString
SubstitutableBoolean boolean | GuardedSubstitutionString
SubstitutableStringOrArray SubstitutableString | SubstitutableStringArray
Reference object
$ref string
format=uri-reference
DependenciesDefinition object
services object[]
data object
3 nested properties
examples
dictionary
adapters
settings
MockRuntimeServiceDefinitionOrRefArray object[]
MockRuntimeServiceDefinition object
$ref string
description string
definitions object[]
runOptions
data object
3 nested properties
examples
dictionary
adapters
settings
SystemUnderTestServiceDefinition object
service object
One of: object object, object object
6 nested properties
$ref string
definitions object[]
description string
runOptions
data object
3 nested properties
examples
dictionary
adapters
settings
TestRuntimeServiceDefinition object
$ref string
definitions object[]
description string
runOptions
data object
3 nested properties
examples
dictionary
adapters
settings
DataDefinition object
examples
dictionary
adapters
ProxyDefinitionsArray object[]
ProxyDefinition object
target string required
baseUrl string
timeoutInMilliseconds integer | GuardedSubstitutionString
adapters
cert
recordingsDirectory string
McpDefinition object
test object
7 nested properties
baseUrl string
transportKind string | SubstitutableString
enableResiliencyTests boolean | GuardedSubstitutionString
dictionaryFile string
bearerToken string
filterTools SubstitutableString[]
McpTestRunOptions object
baseUrl string
transportKind string | SubstitutableString
enableResiliencyTests boolean | GuardedSubstitutionString
dictionaryFile string
bearerToken string
filterTools SubstitutableString[]
SpecmaticDefinition object
license object
1 nested properties
path string
governance object
2 nested properties
report object
2 nested properties
formats string[] | SubstitutableString
outputDirectory string
successCriteria object
3 nested properties
minCoveragePercentage number | GuardedSubstitutionString
maxMissedOperationsInSpec integer | GuardedSubstitutionString
enforce boolean | GuardedSubstitutionString
settings
LicenseDefinition object
path string
ReportsDefinition object
formats string[] | SubstitutableString
outputDirectory string
SuccessCriteriaDefinition object
minCoveragePercentage number | GuardedSubstitutionString
maxMissedOperationsInSpec integer | GuardedSubstitutionString
enforce boolean | GuardedSubstitutionString
StaticServiceDefinition object
description string
definitions object[]
SpecificationStaticDefinitionArray object[]
SpecificationStaticDefinition object
source required
specs SpecificationSchema[] required
SpecificationSchema SpecificationPath | object
SpecificationPath string
SpecificationObject object
path string required
id string
urlPathPrefix string
SourceSchemaOrRef
SourceSchema GitSourceSchema | FileSystemSourceSchema
GitSourceSchema object
GitSourceAuthentication GitSourceBearerFileAuthentication | GitSourceBearerEnvAuthentication | GitSourcePersonalAccessTokenAuthentication
GitSourceBearerFileAuthentication object
bearerFile string required
GitSourceBearerEnvAuthentication object
bearerEnvironmentVariable string required
GitSourcePersonalAccessTokenAuthentication object
personalAccessToken string required
FileSystemSourceSchema object
filesystem object required
1 nested properties
directory string
FileSystemSourceOptions object
directory string
RunOptions object
openapi object
wsdl object
asyncapi object
graphqlsdl object
protobuf object
TestRunOptionsOrRef
TestRunOptions object
openapi object
11 nested properties
type const: "test"
Constant: "test"
host string
port integer | GuardedSubstitutionString
baseUrl string
filter string
workflow object
1 nested properties
ids Record<string, object>
swaggerUiBaseUrl string
swaggerUrl string
actuatorUrl string
cert
specs object[]
wsdl object
5 nested properties
type const: "test"
Constant: "test"
host string
port integer | GuardedSubstitutionString
baseUrl string
specs object[]
asyncapi object
6 nested properties
type const: "test"
Constant: "test"
replyTimeout integer | GuardedSubstitutionString
subscriberReadinessWaitTimeout integer | GuardedSubstitutionString
schemaRegistry object
4 nested properties
kind string | SubstitutableString required
url string
username string
password string
specs object[]
graphqlsdl object
4 nested properties
type const: "test"
Constant: "test"
host string
port integer | GuardedSubstitutionString
specs object[]
protobuf object
7 nested properties
type const: "test"
Constant: "test"
host string
port integer | GuardedSubstitutionString
importPaths SubstitutableString[]
protocVersion string
requestTimeout integer | GuardedSubstitutionString
specs object[]
MockRunOptionsOrRef
MockRunOptions object
openapi object
9 nested properties
type enum
Values: "mock" "stateful-mock"
host string
port integer | GuardedSubstitutionString
baseUrl string
filter string
logMode string | SubstitutableString
logsDirPath string
cert
specs object[]
wsdl object
6 nested properties
type const: "mock"
Constant: "mock"
host string
port integer | GuardedSubstitutionString
baseUrl string
cert
specs object[]
asyncapi object
5 nested properties
type const: "mock"
Constant: "mock"
specs object[]
schemaRegistry object
4 nested properties
kind string | SubstitutableString required
url string
username string
password string
inMemoryBroker object
3 nested properties
host string
port integer | GuardedSubstitutionString
logDir string
graphqlsdl object
4 nested properties
type const: "mock"
Constant: "mock"
host string
port integer | GuardedSubstitutionString
specs object[]
protobuf object
6 nested properties
type const: "mock"
Constant: "mock"
host string
port integer | GuardedSubstitutionString
importPaths SubstitutableString[]
protocVersion string
specs object[]
OpenApiRunOptions object
AsyncApiRunOptions object
GraphQLSdlRunOptions object
ProtobufRunOptions object
WsdlRunOptions object
WsdlTestRunOptions object
type const: "test"
Constant: "test"
host string
port integer | GuardedSubstitutionString
baseUrl string
specs object[]
WsdlMockRunOptions object
type const: "mock"
Constant: "mock"
host string
port integer | GuardedSubstitutionString
baseUrl string
cert
specs object[]
AsyncApiTestRunOptions object
type const: "test"
Constant: "test"
replyTimeout integer | GuardedSubstitutionString
subscriberReadinessWaitTimeout integer | GuardedSubstitutionString
schemaRegistry object
4 nested properties
kind string | SubstitutableString required
url string
username string
password string
specs object[]
AsyncApiServerDefinition object
host string required
protocol string required
adminCredentials Record<string, any>
client object
2 nested properties
consumer
producer
AsyncApiMockRunOptions object
type const: "mock"
Constant: "mock"
specs object[]
schemaRegistry object
4 nested properties
kind string | SubstitutableString required
url string
username string
password string
inMemoryBroker object
3 nested properties
host string
port integer | GuardedSubstitutionString
logDir string
AsyncApiSchemaRegistry object
kind string | SubstitutableString required
url string
username string
password string
GraphqlSdlTestRunOptions object
type const: "test"
Constant: "test"
host string
port integer | GuardedSubstitutionString
specs object[]
GraphqlSdlMockRunOptions object
type const: "mock"
Constant: "mock"
host string
port integer | GuardedSubstitutionString
specs object[]
ProtobufTestRunOptions object
type const: "test"
Constant: "test"
host string
port integer | GuardedSubstitutionString
importPaths SubstitutableString[]
protocVersion string
requestTimeout integer | GuardedSubstitutionString
specs object[]
ProtobufMockRunOptions object
type const: "mock"
Constant: "mock"
host string
port integer | GuardedSubstitutionString
importPaths SubstitutableString[]
protocVersion string
specs object[]
OpenApiTestRunOptions object
type const: "test"
Constant: "test"
host string
port integer | GuardedSubstitutionString
baseUrl string
filter string
workflow object
1 nested properties
ids Record<string, object>
swaggerUiBaseUrl string
swaggerUrl string
actuatorUrl string
cert
specs object[]
OpenApiMockRunOptions object
type enum
Values: "mock" "stateful-mock"
host string
port integer | GuardedSubstitutionString
baseUrl string
filter string
logMode string | SubstitutableString
logsDirPath string
cert
specs object[]
OpenApiSpecificationRuntimeDefinitionArray object[]
SpecificationRuntimeDefinitionArray object[]
FreeFormObject Record<string, any>
SpecificationRuntimeDefinition object
id string
host string
port integer | GuardedSubstitutionString
overlayFilePath string
OpenApiSpecificationRuntimeDefinition object
id string
host string
port integer | GuardedSubstitutionString
baseUrl string
overlayFilePath string
securitySchemes Record<string, object>
SecuritySchemeConfigurationV3 object
type string required
Values: "oauth2" "basicAuth" "bearer" "apiKey"
token string required
WorkflowConfigurationV3 object
ids Record<string, object>
ExamplesConfiguration object
commonExamples object
1 nested properties
directories SubstitutableString[] required
ArrayExampleConfigurationOrRef
ArrayExampleConfiguration BaseExampleConfigurationOrRef[]
BaseExampleConfigurationOrRef
BaseExampleConfiguration object
directories SubstitutableString[] required
DictionaryConfigurationOrRef
DictionaryConfiguration object
path string required
AdapterConfigurationOrRef
AdapterConfiguration object
pre_specmatic_request_processor string
post_specmatic_response_processor string
pre_specmatic_response_processor string
stub_load_contract string
test_load_contract string
CertConfigurationOrRef
CertConfiguration object
keyStorePassword string
mtlsEnabled boolean | GuardedSubstitutionString
ConcreteSettingsOrRef
ModeSpecificSettings object
ConcreteSettings object
general object
8 nested properties
disableTelemetry boolean | GuardedSubstitutionString
ignoreInlineExamples boolean | GuardedSubstitutionString
ignoreInlineExampleWarnings boolean | GuardedSubstitutionString
prettyPrint boolean | GuardedSubstitutionString
logging object
3 nested properties
level string | SubstitutableString
text object
json object
featureFlags object
3 nested properties
fuzzyMatcherForPayloads boolean | GuardedSubstitutionString
schemaExampleDefault boolean | GuardedSubstitutionString
escapeSoapAction boolean | GuardedSubstitutionString
specExamplesDirectoryTemplate string
sharedExamplesDirectoryTemplate SubstitutableString[]
test object
9 nested properties
schemaResiliencyTests string | SubstitutableString
timeoutInMilliseconds integer | GuardedSubstitutionString
strictMode boolean | GuardedSubstitutionString
lenientMode boolean | GuardedSubstitutionString
parallelism integer | GuardedSubstitutionString
maxTestRequestCombinations integer | GuardedSubstitutionString
junitReportDir string
validateResponseValues boolean | GuardedSubstitutionString
maxTestCount integer | GuardedSubstitutionString
mock object
7 nested properties
generative boolean | GuardedSubstitutionString
delayInMilliseconds integer | GuardedSubstitutionString
startTimeoutInMilliseconds integer | GuardedSubstitutionString
hotReload boolean | GuardedSubstitutionString
strictMode boolean | GuardedSubstitutionString
lenientMode boolean | GuardedSubstitutionString
gracefulRestartTimeoutInMilliseconds integer | GuardedSubstitutionString
proxy object
2 nested properties
recordRequests boolean | GuardedSubstitutionString
ignoreHeaders SubstitutableString[]
backwardCompatibility object
4 nested properties
baseBranch string
targetPath string
repoDirectory string
strictMode boolean | GuardedSubstitutionString
KeyStoreConfiguration KeyStoreFileConfiguration | KeyStoreDirectoryConfiguration
KeyStoreFileConfiguration object
file string required
password string
alias string
KeyStoreDirectoryConfiguration object
directory string required
password string
alias string
BackwardCompatibilitySettings object
baseBranch string
targetPath string
repoDirectory string
strictMode boolean | GuardedSubstitutionString
ProxySettings object
recordRequests boolean | GuardedSubstitutionString
ignoreHeaders SubstitutableString[]
MockSettingsOrRef
MockSettings object
generative boolean | GuardedSubstitutionString
delayInMilliseconds integer | GuardedSubstitutionString
startTimeoutInMilliseconds integer | GuardedSubstitutionString
hotReload boolean | GuardedSubstitutionString
strictMode boolean | GuardedSubstitutionString
lenientMode boolean | GuardedSubstitutionString
gracefulRestartTimeoutInMilliseconds integer | GuardedSubstitutionString
TestSettingsOrRef
TestSettings object
schemaResiliencyTests string | SubstitutableString
timeoutInMilliseconds integer | GuardedSubstitutionString
strictMode boolean | GuardedSubstitutionString
lenientMode boolean | GuardedSubstitutionString
parallelism integer | GuardedSubstitutionString
maxTestRequestCombinations integer | GuardedSubstitutionString
junitReportDir string
validateResponseValues boolean | GuardedSubstitutionString
maxTestCount integer | GuardedSubstitutionString
GeneralSettings object
disableTelemetry boolean | GuardedSubstitutionString
ignoreInlineExamples boolean | GuardedSubstitutionString
ignoreInlineExampleWarnings boolean | GuardedSubstitutionString
prettyPrint boolean | GuardedSubstitutionString
logging object
3 nested properties
level string | SubstitutableString
text object
3 nested properties
directory string
console boolean | GuardedSubstitutionString
logFilePrefix string
json object
3 nested properties
directory string
console boolean | GuardedSubstitutionString
logFilePrefix string
featureFlags object
3 nested properties
fuzzyMatcherForPayloads boolean | GuardedSubstitutionString
schemaExampleDefault boolean | GuardedSubstitutionString
escapeSoapAction boolean | GuardedSubstitutionString
specExamplesDirectoryTemplate string
sharedExamplesDirectoryTemplate SubstitutableString[]
LoggingSettings object
level string | SubstitutableString
text object
3 nested properties
directory string
console boolean | GuardedSubstitutionString
logFilePrefix string
json object
3 nested properties
directory string
console boolean | GuardedSubstitutionString
logFilePrefix string
LogOutputSettings object
directory string
console boolean | GuardedSubstitutionString
logFilePrefix string
FeatureFlags object
fuzzyMatcherForPayloads boolean | GuardedSubstitutionString
schemaExampleDefault boolean | GuardedSubstitutionString
escapeSoapAction boolean | GuardedSubstitutionString