Include the description field in "brief" REST API serializations #9285

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

Originally created by @jeremystretch on GitHub (Feb 23, 2024).

Originally assigned to: @jeremystretch on GitHub.

NetBox version

v3.7.3

Feature type

New functionality

Proposed functionality

Currently, "brief" mode REST API responses do not include an object's description:

# GET /api/dcim/sites/1/?brief=true
{
    "id": 1,
    "url": "http://netbox:8000/api/dcim/sites/1/",
    "display": "DM-NYC",
    "name": "DM-NYC",
    "slug": "dm-nyc"
}

This proposal is to include the description field in this output, where applicable.

Use case

Following #13283, the description field can be included on dynamically-populated dropdown fields to convey additional context about each object. It is also likely useful in many other scenarios, and its inclusion imposes no significant performance penalty.

Database changes

None

External dependencies

None

Originally created by @jeremystretch on GitHub (Feb 23, 2024). Originally assigned to: @jeremystretch on GitHub. ### NetBox version v3.7.3 ### Feature type New functionality ### Proposed functionality Currently, "brief" mode REST API responses do not include an object's description: ``` # GET /api/dcim/sites/1/?brief=true { "id": 1, "url": "http://netbox:8000/api/dcim/sites/1/", "display": "DM-NYC", "name": "DM-NYC", "slug": "dm-nyc" } ``` This proposal is to include the `description` field in this output, where applicable. ### Use case Following #13283, the description field can be included on dynamically-populated dropdown fields to convey additional context about each object. It is also likely useful in many other scenarios, and its inclusion imposes no significant performance penalty. ### Database changes None ### External dependencies None
adam added the status: acceptedtype: feature labels 2025-12-29 20:47:50 +01:00
adam closed this issue 2025-12-29 20:47:50 +01:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/netbox#9285