@@ -7362,6 +7362,12 @@ components:
73627362 Monitor:
73637363 description: Object describing a monitor.
73647364 properties:
7365+ assets:
7366+ description: The list of monitor assets tied to a monitor, which represents
7367+ key links for users to take action on monitor alerts (for example, runbooks).
7368+ items:
7369+ $ref: '#/components/schemas/MonitorAsset'
7370+ type: array
73657371 created:
73667372 description: Timestamp of the monitor creation.
73677373 format: date-time
@@ -7445,6 +7451,52 @@ components:
74457451 - type
74467452 - query
74477453 type: object
7454+ MonitorAsset:
7455+ description: 'Represents key links tied to a monitor to help users take action
7456+ on alerts.
7457+
7458+ This feature is in Preview and only available to users with the feature enabled.'
7459+ properties:
7460+ category:
7461+ $ref: '#/components/schemas/MonitorAssetCategory'
7462+ name:
7463+ description: Name for the monitor asset
7464+ example: Monitor Runbook
7465+ type: string
7466+ resource_key:
7467+ description: Represents the identifier of the internal Datadog resource
7468+ that this asset represents. IDs in this field should be passed in as strings.
7469+ example: '12345'
7470+ type: string
7471+ resource_type:
7472+ $ref: '#/components/schemas/MonitorAssetResourceType'
7473+ url:
7474+ description: URL link for the asset. For links with an internal resource
7475+ type set, this should be the relative path to where the Datadog domain
7476+ is appended internally. For external links, this should be the full URL
7477+ path.
7478+ example: /notebooks/12345
7479+ type: string
7480+ required:
7481+ - name
7482+ - url
7483+ - category
7484+ type: object
7485+ MonitorAssetCategory:
7486+ description: Indicates the type of asset this entity represents on a monitor.
7487+ enum:
7488+ - runbook
7489+ example: runbook
7490+ type: string
7491+ x-enum-varnames:
7492+ - RUNBOOK
7493+ MonitorAssetResourceType:
7494+ description: Type of internal Datadog resource associated with a monitor asset.
7495+ enum:
7496+ - notebook
7497+ type: string
7498+ x-enum-varnames:
7499+ - NOTEBOOK
74487500 MonitorDeviceID:
74497501 description: ID of the device the Synthetics monitor is running on. Same as
74507502 `SyntheticsDeviceID`.
@@ -8559,6 +8611,13 @@ components:
85598611 MonitorUpdateRequest:
85608612 description: Object describing a monitor update request.
85618613 properties:
8614+ assets:
8615+ description: The list of monitor assets tied to a monitor, which represents
8616+ key links for users to take action on monitor alerts (for example, runbooks).
8617+ items:
8618+ $ref: '#/components/schemas/MonitorAsset'
8619+ nullable: true
8620+ type: array
85628621 created:
85638622 description: Timestamp of the monitor creation.
85648623 format: date-time
@@ -32267,6 +32326,13 @@ paths:
3226732326 required: false
3226832327 schema:
3226932328 type: boolean
32329+ - description: If this argument is set to `true`, the returned data includes
32330+ all assets tied to this monitor.
32331+ in: query
32332+ name: with_assets
32333+ required: false
32334+ schema:
32335+ type: boolean
3227032336 responses:
3227132337 '200':
3227232338 content:
0 commit comments