@@ -449,7 +449,7 @@ components:
449449 type: string
450450 GetIssueIncludeQueryParameter:
451451 description: Comma-separated list of relationship objects that should be included
452- in the response. Possible values are `assignee`, `case`, and `team_owners`.
452+ in the response.
453453 explode: false
454454 in: query
455455 name: include
@@ -996,8 +996,7 @@ components:
996996 $ref: '#/components/schemas/ServiceDefinitionSchemaVersions'
997997 SearchIssuesIncludeQueryParameter:
998998 description: Comma-separated list of relationship objects that should be included
999- in the response. Possible values are `issue`, `issue.assignee`, `issue.case`,
1000- and `issue.team_owners`.
999+ in the response.
10011000 explode: false
10021001 in: query
10031002 name: include
@@ -17296,6 +17295,102 @@ components:
1729617295 - score
1729717296 - severity
1729817297 type: object
17298+ Email:
17299+ description: On-Call User Email.
17300+ example:
17301+ data:
17302+ attributes:
17303+ active: true
17304+ address: john.doe@datadoghq.com
17305+ alias: ''
17306+ formats:
17307+ - html
17308+ id: 45cd9fe5-dd96-42ad-83de-2242ea9f6efd
17309+ type: emails
17310+ properties:
17311+ data:
17312+ $ref: '#/components/schemas/EmailData'
17313+ type: object
17314+ EmailAttributes:
17315+ description: Attributes for an on-call email.
17316+ properties:
17317+ active:
17318+ description: Whether the email is currently active.
17319+ type: boolean
17320+ address:
17321+ description: Email address.
17322+ type: string
17323+ alias:
17324+ description: Optional display alias for the email.
17325+ type: string
17326+ formats:
17327+ description: Preferred content formats for notifications.
17328+ items:
17329+ $ref: '#/components/schemas/EmailFormatType'
17330+ type: array
17331+ type: object
17332+ EmailCreateRequest:
17333+ description: Request body for creating an On-Call email notification channel.
17334+ example:
17335+ data:
17336+ attributes:
17337+ active: true
17338+ address: john.doe@datadoghq.com
17339+ alias: ''
17340+ formats:
17341+ - html
17342+ type: emails
17343+ properties:
17344+ data:
17345+ $ref: '#/components/schemas/EmailData'
17346+ type: object
17347+ EmailData:
17348+ description: Data for an on-call email resource.
17349+ properties:
17350+ attributes:
17351+ $ref: '#/components/schemas/EmailAttributes'
17352+ id:
17353+ description: The email's unique identifier.
17354+ type: string
17355+ type:
17356+ $ref: '#/components/schemas/EmailType'
17357+ required:
17358+ - type
17359+ type: object
17360+ EmailFormatType:
17361+ description: Specifies the format of the e-mail that is sent for On-Call notifications
17362+ enum:
17363+ - html
17364+ - text
17365+ example: html
17366+ type: string
17367+ x-enum-varnames:
17368+ - HTML
17369+ - TEXT
17370+ EmailType:
17371+ default: emails
17372+ description: Indicates that the resource is of type 'emails'.
17373+ enum:
17374+ - emails
17375+ example: emails
17376+ type: string
17377+ x-enum-varnames:
17378+ - EMAILS
17379+ EmailUpdateRequest:
17380+ description: Request body for updating an On-Call email notification channel.
17381+ example:
17382+ data:
17383+ attributes:
17384+ active: true
17385+ address: john.doe@datadoghq.com
17386+ alias: ''
17387+ formats:
17388+ - html
17389+ type: emails
17390+ properties:
17391+ data:
17392+ $ref: '#/components/schemas/EmailData'
17393+ type: object
1729917394 Enabled:
1730017395 description: Field used to enable or disable the rule.
1730117396 example: true
@@ -71931,6 +72026,193 @@ paths:
7193172026 operator: AND
7193272027 permissions:
7193372028 - on_call_write
72029+ /api/v2/on-call/users/{user_id}/notification-channels/emails:
72030+ post:
72031+ description: Create a new email notification channel for an on-call user
72032+ operationId: CreateUserEmailNotificationChannel
72033+ parameters:
72034+ - description: The user ID
72035+ in: path
72036+ name: user_id
72037+ required: true
72038+ schema:
72039+ example: 00000000-0000-0000-0000-000000000000
72040+ type: string
72041+ requestBody:
72042+ content:
72043+ application/json:
72044+ schema:
72045+ $ref: '#/components/schemas/EmailCreateRequest'
72046+ required: true
72047+ responses:
72048+ '201':
72049+ content:
72050+ application/json:
72051+ schema:
72052+ $ref: '#/components/schemas/Email'
72053+ description: Created
72054+ '400':
72055+ $ref: '#/components/responses/BadRequestResponse'
72056+ '401':
72057+ $ref: '#/components/responses/UnauthorizedResponse'
72058+ '403':
72059+ $ref: '#/components/responses/ForbiddenResponse'
72060+ '404':
72061+ $ref: '#/components/responses/NotFoundResponse'
72062+ '429':
72063+ $ref: '#/components/responses/TooManyRequestsResponse'
72064+ security:
72065+ - apiKeyAuth: []
72066+ appKeyAuth: []
72067+ - AuthZ: []
72068+ summary: Create an On-Call email for a user
72069+ tags:
72070+ - On-Call
72071+ x-permission:
72072+ operator: AND
72073+ permissions:
72074+ - on_call_admin
72075+ /api/v2/on-call/users/{user_id}/notification-channels/emails/{email_id}:
72076+ delete:
72077+ description: Delete an email notification channel for an on-call user
72078+ operationId: DeleteUserEmailNotificationChannel
72079+ parameters:
72080+ - description: The user ID
72081+ in: path
72082+ name: user_id
72083+ required: true
72084+ schema:
72085+ example: 00000000-0000-0000-0000-000000000000
72086+ type: string
72087+ - description: The email ID
72088+ in: path
72089+ name: email_id
72090+ required: true
72091+ schema:
72092+ example: 45bb8fe5-dd96-42ad-83de-2241ea9f6ffc
72093+ type: string
72094+ responses:
72095+ '204':
72096+ description: No Content
72097+ '400':
72098+ $ref: '#/components/responses/BadRequestResponse'
72099+ '401':
72100+ $ref: '#/components/responses/UnauthorizedResponse'
72101+ '403':
72102+ $ref: '#/components/responses/ForbiddenResponse'
72103+ '404':
72104+ $ref: '#/components/responses/NotFoundResponse'
72105+ '429':
72106+ $ref: '#/components/responses/TooManyRequestsResponse'
72107+ security:
72108+ - apiKeyAuth: []
72109+ appKeyAuth: []
72110+ - AuthZ: []
72111+ summary: Delete an On-Call email for a user
72112+ tags:
72113+ - On-Call
72114+ x-permission:
72115+ operator: AND
72116+ permissions:
72117+ - on_call_admin
72118+ get:
72119+ description: Get an email notification channel for an on-call user
72120+ operationId: GetUserEmailNotificationChannel
72121+ parameters:
72122+ - description: The user ID
72123+ in: path
72124+ name: user_id
72125+ required: true
72126+ schema:
72127+ example: 00000000-0000-0000-0000-000000000000
72128+ type: string
72129+ - description: The email ID
72130+ in: path
72131+ name: email_id
72132+ required: true
72133+ schema:
72134+ example: 45bb8fe5-dd96-42ad-83de-2241ea9f6ffc
72135+ type: string
72136+ responses:
72137+ '200':
72138+ content:
72139+ application/json:
72140+ schema:
72141+ $ref: '#/components/schemas/Email'
72142+ description: OK
72143+ '400':
72144+ $ref: '#/components/responses/BadRequestResponse'
72145+ '401':
72146+ $ref: '#/components/responses/UnauthorizedResponse'
72147+ '403':
72148+ $ref: '#/components/responses/ForbiddenResponse'
72149+ '404':
72150+ $ref: '#/components/responses/NotFoundResponse'
72151+ '429':
72152+ $ref: '#/components/responses/TooManyRequestsResponse'
72153+ security:
72154+ - apiKeyAuth: []
72155+ appKeyAuth: []
72156+ - AuthZ: []
72157+ summary: Get an On-Call email for a user
72158+ tags:
72159+ - On-Call
72160+ x-permission:
72161+ operator: AND
72162+ permissions:
72163+ - on_call_admin
72164+ put:
72165+ description: Update an email notification channel for an on-call user
72166+ operationId: UpdateUserEmailNotificationChannel
72167+ parameters:
72168+ - description: The user ID
72169+ in: path
72170+ name: user_id
72171+ required: true
72172+ schema:
72173+ example: 00000000-0000-0000-0000-000000000000
72174+ type: string
72175+ - description: The email ID
72176+ in: path
72177+ name: email_id
72178+ required: true
72179+ schema:
72180+ example: 45bb8fe5-dd96-42ad-83de-2241ea9f6ffc
72181+ type: string
72182+ requestBody:
72183+ content:
72184+ application/json:
72185+ schema:
72186+ $ref: '#/components/schemas/EmailUpdateRequest'
72187+ required: true
72188+ responses:
72189+ '200':
72190+ content:
72191+ application/json:
72192+ schema:
72193+ $ref: '#/components/schemas/Email'
72194+ description: OK
72195+ '400':
72196+ $ref: '#/components/responses/BadRequestResponse'
72197+ '401':
72198+ $ref: '#/components/responses/UnauthorizedResponse'
72199+ '403':
72200+ $ref: '#/components/responses/ForbiddenResponse'
72201+ '404':
72202+ $ref: '#/components/responses/NotFoundResponse'
72203+ '429':
72204+ $ref: '#/components/responses/TooManyRequestsResponse'
72205+ security:
72206+ - apiKeyAuth: []
72207+ appKeyAuth: []
72208+ - AuthZ: []
72209+ summary: Update an On-Call email for a user
72210+ tags:
72211+ - On-Call
72212+ x-permission:
72213+ operator: AND
72214+ permissions:
72215+ - on_call_admin
7193472216 /api/v2/org_configs:
7193572217 get:
7193672218 description: Returns all Org Configs (name, description, and value).
0 commit comments