@@ -9200,6 +9200,111 @@ components:
9200
9200
id:
9201
9201
$ref: '#/components/schemas/ApiID'
9202
9202
type: object
9203
+ CreatePageRequest:
9204
+ description: Full request to trigger an On-Call Page.
9205
+ example:
9206
+ data:
9207
+ attributes:
9208
+ description: Page details.
9209
+ tags:
9210
+ - service:test
9211
+ target:
9212
+ identifier: my-team
9213
+ type: team_handle
9214
+ title: Page title
9215
+ urgency: low
9216
+ type: pages
9217
+ properties:
9218
+ data:
9219
+ $ref: '#/components/schemas/CreatePageRequestData'
9220
+ type: object
9221
+ CreatePageRequestData:
9222
+ description: The main request body, including attributes and resource type.
9223
+ properties:
9224
+ attributes:
9225
+ $ref: '#/components/schemas/CreatePageRequestDataAttributes'
9226
+ type:
9227
+ $ref: '#/components/schemas/CreatePageRequestDataType'
9228
+ required:
9229
+ - type
9230
+ type: object
9231
+ CreatePageRequestDataAttributes:
9232
+ description: Details about the On-Call Page you want to create.
9233
+ properties:
9234
+ description:
9235
+ description: A short summary of the issue or context.
9236
+ type: string
9237
+ tags:
9238
+ description: Tags to help categorize or filter the page.
9239
+ items:
9240
+ type: string
9241
+ type: array
9242
+ target:
9243
+ $ref: '#/components/schemas/CreatePageRequestDataAttributesTarget'
9244
+ title:
9245
+ description: The title of the page.
9246
+ example: 'Service: Test is down'
9247
+ type: string
9248
+ urgency:
9249
+ description: The level of urgency for the alert. Possible value `low` or
9250
+ `high`.
9251
+ example: high
9252
+ type: string
9253
+ required:
9254
+ - target
9255
+ - title
9256
+ - urgency
9257
+ type: object
9258
+ CreatePageRequestDataAttributesTarget:
9259
+ description: Information about the target to notify (such as a team or user).
9260
+ properties:
9261
+ identifier:
9262
+ description: A unique ID for the target (for example, team handle or user
9263
+ UUID).
9264
+ type: string
9265
+ type:
9266
+ description: The kind of target, `team_uuid` | `team_handle` | `user_uuid`.
9267
+ type: string
9268
+ type: object
9269
+ CreatePageRequestDataType:
9270
+ default: pages
9271
+ description: The type of resource used when creating an On-Call Page.
9272
+ enum:
9273
+ - pages
9274
+ example: pages
9275
+ type: string
9276
+ x-enum-varnames:
9277
+ - PAGES
9278
+ CreatePageResponse:
9279
+ description: The full response object after creating a new On-Call Page.
9280
+ example:
9281
+ data:
9282
+ id: 15e74b8b-f865-48d0-bcc5-453323ed2c8f
9283
+ type: pages
9284
+ properties:
9285
+ data:
9286
+ $ref: '#/components/schemas/CreatePageResponseData'
9287
+ type: object
9288
+ CreatePageResponseData:
9289
+ description: The information returned after successfully creating a page.
9290
+ properties:
9291
+ id:
9292
+ description: The unique ID of the created page.
9293
+ type: string
9294
+ type:
9295
+ $ref: '#/components/schemas/CreatePageResponseDataType'
9296
+ required:
9297
+ - type
9298
+ type: object
9299
+ CreatePageResponseDataType:
9300
+ default: pages
9301
+ description: The type of resource used when creating an On-Call Page.
9302
+ enum:
9303
+ - pages
9304
+ example: pages
9305
+ type: string
9306
+ x-enum-varnames:
9307
+ - PAGES
9203
9308
CreateRuleRequest:
9204
9309
description: Scorecard create rule request.
9205
9310
properties:
@@ -51299,6 +51404,227 @@ paths:
51299
51404
summary: Update on-call escalation policy
51300
51405
tags:
51301
51406
- On-Call
51407
+ /api/v2/on-call/pages:
51408
+ post:
51409
+ description: 'Trigger a new On-Call Page.
51410
+
51411
+ '
51412
+ operationId: CreateOnCallPage
51413
+ requestBody:
51414
+ content:
51415
+ application/json:
51416
+ schema:
51417
+ $ref: '#/components/schemas/CreatePageRequest'
51418
+ required: true
51419
+ responses:
51420
+ '200':
51421
+ content:
51422
+ application/json:
51423
+ schema:
51424
+ $ref: '#/components/schemas/CreatePageResponse'
51425
+ description: OK.
51426
+ '429':
51427
+ $ref: '#/components/responses/TooManyRequestsResponse'
51428
+ security:
51429
+ - apiKeyAuth: []
51430
+ appKeyAuth: []
51431
+ - AuthZ: []
51432
+ servers:
51433
+ - url: https://{site}
51434
+ variables:
51435
+ site:
51436
+ default: navy.oncall.datadoghq.com
51437
+ description: The globally available endpoint for On-Call.
51438
+ enum:
51439
+ - saffron.oncall.datadoghq.com
51440
+ - navy.oncall.datadoghq.com
51441
+ - coral.oncall.datadoghq.com
51442
+ - teal.oncall.datadoghq.com
51443
+ - beige.oncall.datadoghq.eu
51444
+ - url: '{protocol}://{name}'
51445
+ variables:
51446
+ name:
51447
+ default: api.datadoghq.com
51448
+ description: Full site DNS name.
51449
+ protocol:
51450
+ default: https
51451
+ description: The protocol for accessing the API.
51452
+ - url: https://{subdomain}.{site}
51453
+ variables:
51454
+ site:
51455
+ default: datadoghq.com
51456
+ description: Any Datadog deployment.
51457
+ subdomain:
51458
+ default: api
51459
+ description: The subdomain where the API is deployed.
51460
+ summary: Create On-Call Page
51461
+ tags:
51462
+ - On-Call Paging
51463
+ /api/v2/on-call/pages/{page_id}/acknowledge:
51464
+ post:
51465
+ description: 'Acknowledges an On-Call Page.
51466
+
51467
+ '
51468
+ operationId: AcknowledgeOnCallPage
51469
+ parameters:
51470
+ - description: The page ID.
51471
+ in: path
51472
+ name: page_id
51473
+ required: true
51474
+ schema:
51475
+ example: 15e74b8b-f865-48d0-bcc5-453323ed2c8f
51476
+ format: uuid
51477
+ type: string
51478
+ responses:
51479
+ '202':
51480
+ description: Accepted.
51481
+ '429':
51482
+ $ref: '#/components/responses/TooManyRequestsResponse'
51483
+ security:
51484
+ - apiKeyAuth: []
51485
+ appKeyAuth: []
51486
+ - AuthZ: []
51487
+ servers:
51488
+ - url: https://{site}
51489
+ variables:
51490
+ site:
51491
+ default: navy.oncall.datadoghq.com
51492
+ description: The globally available endpoint for On-Call.
51493
+ enum:
51494
+ - saffron.oncall.datadoghq.com
51495
+ - navy.oncall.datadoghq.com
51496
+ - coral.oncall.datadoghq.com
51497
+ - teal.oncall.datadoghq.com
51498
+ - beige.oncall.datadoghq.eu
51499
+ - url: '{protocol}://{name}'
51500
+ variables:
51501
+ name:
51502
+ default: api.datadoghq.com
51503
+ description: Full site DNS name.
51504
+ protocol:
51505
+ default: https
51506
+ description: The protocol for accessing the API.
51507
+ - url: https://{subdomain}.{site}
51508
+ variables:
51509
+ site:
51510
+ default: datadoghq.com
51511
+ description: Any Datadog deployment.
51512
+ subdomain:
51513
+ default: api
51514
+ description: The subdomain where the API is deployed.
51515
+ summary: Acknowledge On-Call Page
51516
+ tags:
51517
+ - On-Call Paging
51518
+ /api/v2/on-call/pages/{page_id}/escalate:
51519
+ post:
51520
+ description: 'Escalates an On-Call Page.
51521
+
51522
+ '
51523
+ operationId: EscalateOnCallPage
51524
+ parameters:
51525
+ - description: The page ID.
51526
+ in: path
51527
+ name: page_id
51528
+ required: true
51529
+ schema:
51530
+ example: 15e74b8b-f865-48d0-bcc5-453323ed2c8f
51531
+ format: uuid
51532
+ type: string
51533
+ responses:
51534
+ '202':
51535
+ description: Accepted.
51536
+ '429':
51537
+ $ref: '#/components/responses/TooManyRequestsResponse'
51538
+ security:
51539
+ - apiKeyAuth: []
51540
+ appKeyAuth: []
51541
+ - AuthZ: []
51542
+ servers:
51543
+ - url: https://{site}
51544
+ variables:
51545
+ site:
51546
+ default: navy.oncall.datadoghq.com
51547
+ description: The globally available endpoint for On-Call.
51548
+ enum:
51549
+ - saffron.oncall.datadoghq.com
51550
+ - navy.oncall.datadoghq.com
51551
+ - coral.oncall.datadoghq.com
51552
+ - teal.oncall.datadoghq.com
51553
+ - beige.oncall.datadoghq.eu
51554
+ - url: '{protocol}://{name}'
51555
+ variables:
51556
+ name:
51557
+ default: api.datadoghq.com
51558
+ description: Full site DNS name.
51559
+ protocol:
51560
+ default: https
51561
+ description: The protocol for accessing the API.
51562
+ - url: https://{subdomain}.{site}
51563
+ variables:
51564
+ site:
51565
+ default: datadoghq.com
51566
+ description: Any Datadog deployment.
51567
+ subdomain:
51568
+ default: api
51569
+ description: The subdomain where the API is deployed.
51570
+ summary: Escalate On-Call Page
51571
+ tags:
51572
+ - On-Call Paging
51573
+ /api/v2/on-call/pages/{page_id}/resolve:
51574
+ post:
51575
+ description: 'Resolves an On-Call Page.
51576
+
51577
+ '
51578
+ operationId: ResolveOnCallPage
51579
+ parameters:
51580
+ - description: The page ID.
51581
+ in: path
51582
+ name: page_id
51583
+ required: true
51584
+ schema:
51585
+ example: 15e74b8b-f865-48d0-bcc5-453323ed2c8f
51586
+ format: uuid
51587
+ type: string
51588
+ responses:
51589
+ '202':
51590
+ description: Accepted.
51591
+ '429':
51592
+ $ref: '#/components/responses/TooManyRequestsResponse'
51593
+ security:
51594
+ - apiKeyAuth: []
51595
+ appKeyAuth: []
51596
+ - AuthZ: []
51597
+ servers:
51598
+ - url: https://{site}
51599
+ variables:
51600
+ site:
51601
+ default: navy.oncall.datadoghq.com
51602
+ description: The globally available endpoint for On-Call.
51603
+ enum:
51604
+ - saffron.oncall.datadoghq.com
51605
+ - navy.oncall.datadoghq.com
51606
+ - coral.oncall.datadoghq.com
51607
+ - teal.oncall.datadoghq.com
51608
+ - beige.oncall.datadoghq.eu
51609
+ - url: '{protocol}://{name}'
51610
+ variables:
51611
+ name:
51612
+ default: api.datadoghq.com
51613
+ description: Full site DNS name.
51614
+ protocol:
51615
+ default: https
51616
+ description: The protocol for accessing the API.
51617
+ - url: https://{subdomain}.{site}
51618
+ variables:
51619
+ site:
51620
+ default: datadoghq.com
51621
+ description: Any Datadog deployment.
51622
+ subdomain:
51623
+ default: api
51624
+ description: The subdomain where the API is deployed.
51625
+ summary: Resolve On-Call Page
51626
+ tags:
51627
+ - On-Call Paging
51302
51628
/api/v2/on-call/schedules:
51303
51629
post:
51304
51630
description: Create a new on-call schedule
@@ -61285,6 +61611,12 @@ tags:
61285
61611
externalDocs:
61286
61612
url: https://docs.datadoghq.com/service_management/on-call/
61287
61613
name: On-Call
61614
+ - description: 'Trigger and manage [Datadog On-Call](https://docs.datadoghq.com/service_management/on-call/)
61615
+
61616
+ pages directly through the Datadog API.'
61617
+ externalDocs:
61618
+ url: https://docs.datadoghq.com/service_management/on-call/
61619
+ name: On-Call Paging
61288
61620
- description: 'Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/)
61289
61621
61290
61622
directly through the Datadog API.'
0 commit comments