Update API viewset descriptions #7890

Closed
opened 2025-12-29 20:29:35 +01:00 by adam · 0 comments
Owner

Originally created by @abhi1693 on GitHub (Apr 10, 2023).

Originally assigned to: @abhi1693 on GitHub.

NetBox version

v3.5-beta1

Feature type

Change to existing functionality

Proposed functionality

Override the get_description in NetBoxAutoSchema to display relevant description for the ViewSet.

Example:

GET /api/dcim/devices/

Get a list of Device objects.

Use case

The change will more accurately define the intent of the method. This also helps in write better documentation in generated client libraries.

Database changes

No response

External dependencies

No response

Originally created by @abhi1693 on GitHub (Apr 10, 2023). Originally assigned to: @abhi1693 on GitHub. ### NetBox version v3.5-beta1 ### Feature type Change to existing functionality ### Proposed functionality Override the `get_description` in `NetBoxAutoSchema` to display relevant description for the ViewSet. Example: ``` GET /api/dcim/devices/ Get a list of Device objects. ``` ### Use case The change will more accurately define the intent of the method. This also helps in write better documentation in generated client libraries. ### Database changes _No response_ ### External dependencies _No response_
adam added the status: acceptedtype: featuretopic: OpenAPI labels 2025-12-29 20:29:35 +01:00
adam closed this issue 2025-12-29 20:29:35 +01:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/netbox#7890