Skip to content

Commit 050ff84

Browse files
author
ci.datadog-api-spec
committed
Regenerate client from commit 7e41715 of spec repo
1 parent f4e7682 commit 050ff84

3 files changed

Lines changed: 49 additions & 8 deletions

File tree

.generator/schemas/v2/openapi.yaml

Lines changed: 25 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -82741,7 +82741,12 @@ components:
8274182741
definition:
8274282742
$ref: "#/components/schemas/WidgetDefinition"
8274382743
is_favorited:
82744-
description: "Will be implemented soon. Currently always returns false."
82744+
description: |-
82745+
Whether the current user has favorited this widget. Populated on get,
82746+
batch_get, update, and search responses; create responses always return
82747+
`false` because a widget can only be favorited after it exists.
82748+
Favoriting itself is performed through the shared favorites API, not
82749+
this service.
8274582750
example: false
8274682751
type: boolean
8274782752
modified_at:
@@ -134588,7 +134593,17 @@ paths:
134588134593
- teams_read
134589134594
/api/v2/widgets/{experience_type}:
134590134595
get:
134591-
description: Search and list widgets for a given experience type. Supports filtering by widget type, creator, title, and tags, as well as sorting and pagination.
134596+
description: |-
134597+
Search and list widgets for a given experience type, with filtering, sorting, and pagination.
134598+
134599+
**Response meta** carries totals scoped to the current filter:
134600+
- `filtered_total` — widgets matching the filter.
134601+
- `created_by_you_total` — among the matches, how many the current user created.
134602+
- `favorited_by_you_total` — among the matches, how many the current user has favorited.
134603+
- `created_by_anyone_total` — total widgets in the experience type, ignoring filters.
134604+
134605+
Each returned widget includes `is_favorited` reflecting the current user's favorite status.
134606+
Favoriting itself is performed through the shared favorites API, not this endpoint.
134592134607
operationId: SearchWidgets
134593134608
parameters:
134594134609
- description: The experience type for the widget.
@@ -134624,8 +134639,14 @@ paths:
134624134639
schema:
134625134640
type: string
134626134641
- description: |-
134627-
Sort field for the results. Prefix with `-` for descending order.
134628-
Allowed values: `title`, `created_at`, `modified_at`.
134642+
Sort field for the results.
134643+
134644+
**`title`, `created_at`, `modified_at`** — both ascending and descending are
134645+
supported. Use the bare field name for ascending (e.g. `sort=title`) or prefix
134646+
with `-` for descending (e.g. `sort=-modified_at`).
134647+
134648+
**`is_favorited`** — returns favorites-first ordering (favorited widgets first,
134649+
then the rest). Direction is fixed; the `-` prefix is ignored for this field.
134629134650
in: query
134630134651
name: sort
134631134652
schema:

src/datadog_api_client/v2/api/widgets_api.py

Lines changed: 19 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -302,7 +302,17 @@ def search_widgets(
302302
) -> WidgetListResponse:
303303
"""Search widgets.
304304
305-
Search and list widgets for a given experience type. Supports filtering by widget type, creator, title, and tags, as well as sorting and pagination.
305+
Search and list widgets for a given experience type, with filtering, sorting, and pagination.
306+
307+
**Response meta** carries totals scoped to the current filter:
308+
309+
* ``filtered_total`` — widgets matching the filter.
310+
* ``created_by_you_total`` — among the matches, how many the current user created.
311+
* ``favorited_by_you_total`` — among the matches, how many the current user has favorited.
312+
* ``created_by_anyone_total`` — total widgets in the experience type, ignoring filters.
313+
314+
Each returned widget includes ``is_favorited`` reflecting the current user's favorite status.
315+
Favoriting itself is performed through the shared favorites API, not this endpoint.
306316
307317
:param experience_type: The experience type for the widget.
308318
:type experience_type: WidgetExperienceType
@@ -316,8 +326,14 @@ def search_widgets(
316326
:type filter_title: str, optional
317327
:param filter_tags: Filter widgets by tags. Format as bracket-delimited CSV, e.g. ``[tag1,tag2]``.
318328
:type filter_tags: str, optional
319-
:param sort: Sort field for the results. Prefix with ``-`` for descending order.
320-
Allowed values: ``title`` , ``created_at`` , ``modified_at``.
329+
:param sort: Sort field for the results.
330+
331+
**title, created_at, modified_at** — both ascending and descending are
332+
supported. Use the bare field name for ascending (e.g. ``sort=title`` ) or prefix
333+
with ``-`` for descending (e.g. ``sort=-modified_at`` ).
334+
335+
**is_favorited** — returns favorites-first ordering (favorited widgets first,
336+
then the rest). Direction is fixed; the ``-`` prefix is ignored for this field.
321337
:type sort: str, optional
322338
:param page_number: Page number for pagination (0-indexed).
323339
:type page_number: int, optional

src/datadog_api_client/v2/model/widget_attributes.py

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,11 @@ def __init__(
5555
:param definition: The definition of a widget, including its type and configuration.
5656
:type definition: WidgetDefinition
5757
58-
:param is_favorited: Will be implemented soon. Currently always returns false.
58+
:param is_favorited: Whether the current user has favorited this widget. Populated on get,
59+
batch_get, update, and search responses; create responses always return
60+
``false`` because a widget can only be favorited after it exists.
61+
Favoriting itself is performed through the shared favorites API, not
62+
this service.
5963
:type is_favorited: bool
6064
6165
:param modified_at: ISO 8601 timestamp of when the widget was last modified.

0 commit comments

Comments
 (0)