[ZBX-19200] Undocumented property for graphs, items, triggers and hosts Created: 2021 Apr 01  Updated: 2024 Apr 10  Resolved: 2021 Jul 17

Status: Closed
Project: ZABBIX BUGS AND ISSUES
Component/s: API (A)
Affects Version/s: 5.0.10, 5.2.6
Fix Version/s: 4.0.32rc1, 5.0.13rc1, 5.4.2rc1, 6.0.0alpha1, 6.0 (plan)

Type: Problem report Priority: Trivial
Reporter: Edgars Melveris Assignee: Ivo Kurzemnieks
Resolution: Fixed Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Attachments: PNG File screenshot-1.png    
Issue Links:
Duplicate
Team: Team B
Sprint: Sprint 75 (Apr 2021), Sprint 76 (May 2021), Sprint 77 (Jun 2021), Sprint 78 (Jul 2021)
Story Points: 0.25

 Description   

Graph prototype documentation includes clear description of parameter "discover":
https://www.zabbix.com/documentation/5.0/manual/api/reference/graphprototype/object

discover integer Graph prototype discovery status.

Possible values:
0 - (default) new graphs will be discovered;
1 - new graphs will not be discovered and existing graphs will be marked as lost.

The parameter is also returned when graph.get method is used, but it's not documented for the graph object:
https://www.zabbix.com/documentation/5.0/manual/api/reference/graph/object
The same seems to be true with items and item prototypes and triggers and hosts.
This can confuse users, all parameters coming from api should be clearly documented, even if it's just stated that this parameter is not used for this object.

 Comments   
Comment by Valdis Murzins [ 2021 Apr 15 ]

Thank you for the report.
This is not a problem in documentation, but rather in API itself.
The parameter 'discover' should not be returned in non-prototype objects.

Comment by Ivo Kurzemnieks [ 2021 Jun 07 ]

Fixed in development branch feature/ZBX-19200-5.0

Comment by Aleksandrs Subins [ 2021 Jun 21 ]

Fixed in:

Comment by Miks Kronkalns [ 2021 Jul 09 ]

Updated API documentation:

Generated at Tue Oct 28 22:19:00 EET 2025 using Jira 9.12.4#9120004-sha1:625303b708afdb767e17cb2838290c41888e9ff0.