Skip to Content
OpenAPI HubIntroduction

OpenAPI Overview

The version of the OpenAPI Specification that the document conforms to, should be one of the supported versions .

Note: Speakeasy tooling currently only supports OpenAPI Specification versions 3.0.x and 3.1.x.

openapi: 3.1.0
info:
title: The Speakeasy Bar
version: 1.0.0
servers:
- url: https://speakeasy.bar
description: The production server
security:
- apiKey: []
tags:
- name: drinks
description: Operations related to drinks
paths:
/drinks:
get:
tags:
- drinks
operationId: listDrinks
summary: Get a list of drinks
responses:
"200":
description: A list of drinks
content:
application/json:
schema:
type: array
items:
$ref: "#/components/schemas/Drink"
components:
schemas:
Drink:
type: object
title: Drink
properties:
name:
type: string
price:
type: number
securitySchemes:
apiKey:
type: apiKey
name: Authorization
in: header

Server Framework Guides

Generate OpenAPI specs from popular server frameworks:

Last updated on