Project

General

Profile

Actions

Bug #18930

closed

Documentation API doesn't build anymore

Added by Elaad FURREEDAN almost 4 years ago. Updated over 3 years ago.

Status:
Released
Priority:
N/A
Category:
Documentation
Target version:
Severity:
UX impact:
User visibility:
Effort required:
Very Small
Priority:
0
Name check:
To do
Fix check:
Checked
Regression:

Description

The API doc is not building :

[1] build/webapp/paths/system/purge-software.yml:9:7 at #/post/responses/200/description
The field 'description' must be present on this level.

07|   responses:
08|     "200":
09|       description: 
10|       content:

Error was generated by oas3-schema/response rule.

This error is referenced from:
1) build/webapp/openapi.yml:276 #/paths/['/system/maintenance/purgeSoftware']

[2] build/webapp/paths/system/purge-software.yml:33:19 at #/post/responses/200/content/application/json/schema/properties/data/items/type
Object type can be one of following only: "string", "object", "array", "integer", "number", "boolean".

Did you mean: string ?

31|                 type: array
32|                 items:
33|                   type: String
34|                   description: a success message. 
35| 

Error was generated by oas3-schema/schema rule.

This error is referenced from:
1) build/webapp/openapi.yml:276 #/paths/['/system/maintenance/purgeSoftware']

[3] build/webapp/paths/settings/allowed_networks_diff.yml:18:15 at #/post/requestBody/content/application/x-www-form-urlencoded/schema/properties/allowed_networks/optional
The field 'optional' is not allowed in OpenAPISchema. Use "x-" prefix or custom types to override this behavior.

16| allowed_networks:
17|   type: object
18|   optional:
19|     - add
20|     - delete

Warning was generated by no-extra-fields rule.

This warning is referenced from:
1) build/webapp/openapi.yml:262 #/paths/['/settings/allowed_networks/{nodeId}/diff']

Actions

Also available in: Atom PDF