Skip to main content

info-contact

Requires an inline info object to contain contact.

AttributeValue
CategoryMetadata
MaturityGold
OpenAPISwagger 2.0; OpenAPI 3.0, 3.1, 3.2
Starter–RecommendedOff
StrictWarning
CompleteError

Intent

Consumers need a discoverable owner or support channel for questions and incidents.

Flags

An object-valued info without a contact property.

Does not flag

A non-object info value, an info object containing $ref, or any info object containing contact, regardless of its value. Use contact-information to validate the contact fields.

See it fail

info:
title: Payments API
version: 1.0.0

Diagnostic: Info object should contain `contact` field.

Fix it

info:
title: Payments API
version: 1.0.0
contact:
name: Team Payments
email: payments@example.com
url: https://example.com/support/payments

Configure

profiles:
default:
rules:
extends: [strict]
override:
info-contact: error

Nearby: contact-information, info-license.