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.