76 lines
1.8 KiB
JSON
76 lines
1.8 KiB
JSON
{
|
|
"openapi": "3.0.2",
|
|
"info": {
|
|
"title": "HashiCorp Vault API",
|
|
"description": "HTTP API that gives you full access to Vault. All API routes are prefixed with `/v1/`.",
|
|
"version": "<vault_version>",
|
|
"license": {
|
|
"name": "Mozilla Public License 2.0",
|
|
"url": "https://www.mozilla.org/en-US/MPL/2.0"
|
|
}
|
|
},
|
|
"paths": {
|
|
"/foo": {
|
|
"description": "Synopsis",
|
|
"parameters": [
|
|
{
|
|
"name": "secret_mount_path",
|
|
"description": "Path where the backend was mounted; the endpoint path will be offset by the mount path",
|
|
"in": "path",
|
|
"schema": {
|
|
"type": "string",
|
|
"default": "secret"
|
|
}
|
|
}
|
|
],
|
|
"x-vault-unauthenticated": true,
|
|
"delete": {
|
|
"operationId": "deleteFoo",
|
|
"tags": ["secrets"],
|
|
"summary": "Delete stuff",
|
|
"responses": {
|
|
"204": {
|
|
"description": "empty body"
|
|
}
|
|
}
|
|
},
|
|
"get": {
|
|
"operationId": "getFoo",
|
|
"tags": ["secrets"],
|
|
"summary": "My Summary",
|
|
"description": "My Description",
|
|
"responses": {
|
|
"202": {
|
|
"description": "Amazing",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/KvFooResponse"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"components": {
|
|
"schemas": {
|
|
"KvFooResponse": {
|
|
"type": "object",
|
|
"properties": {
|
|
"field_a": {
|
|
"type": "string",
|
|
"description": "field_a description"
|
|
},
|
|
"field_b": {
|
|
"type": "boolean",
|
|
"description": "field_b description"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|