@@ -17295,6 +17295,92 @@ components:
1729517295 - score
1729617296 - severity
1729717297 type: object
17298+ Email:
17299+ description: On-Call User Email.
17300+ example:
17301+ data:
17302+ attributes:
17303+ active: true
17304+ 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+ type: string
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+ 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+ EmailType:
17361+ default: emails
17362+ description: Indicates that the resource is of type 'emails'.
17363+ enum:
17364+ - emails
17365+ example: emails
17366+ type: string
17367+ x-enum-varnames:
17368+ - EMAILS
17369+ EmailUpdateRequest:
17370+ description: Request body for updating an On-Call email notification channel.
17371+ example:
17372+ data:
17373+ attributes:
17374+ active: true
17375+ 17376+ alias: ''
17377+ formats:
17378+ - html
17379+ type: emails
17380+ properties:
17381+ data:
17382+ $ref: '#/components/schemas/EmailData'
17383+ type: object
1729817384 Enabled:
1729917385 description: Field used to enable or disable the rule.
1730017386 example: true
@@ -62965,9 +63051,7 @@ paths:
6296563051 permissions:
6296663052 - user_app_keys
6296763053 get:
62968- description: 'Get an application key owned by current user.
62969-
62970- The `key` field is not returned for organizations in [One-Time Read mode](https://docs.datadoghq.com/account_management/api-app-keys/#one-time-read-mode).'
63054+ description: Get an application key owned by current user
6297163055 operationId: GetCurrentUserApplicationKey
6297263056 parameters:
6297363057 - $ref: '#/components/parameters/ApplicationKeyID'
@@ -63000,9 +63084,7 @@ paths:
6300063084 permissions:
6300163085 - user_app_keys
6300263086 patch:
63003- description: 'Edit an application key owned by current user.
63004-
63005- The `key` field is not returned for organizations in [One-Time Read mode](https://docs.datadoghq.com/account_management/api-app-keys/#one-time-read-mode).'
63087+ description: Edit an application key owned by current user
6300663088 operationId: UpdateCurrentUserApplicationKey
6300763089 parameters:
6300863090 - $ref: '#/components/parameters/ApplicationKeyID'
@@ -71906,6 +71988,193 @@ paths:
7190671988 operator: AND
7190771989 permissions:
7190871990 - on_call_write
71991+ /api/v2/on-call/users/{user_id}/notification-channels/emails:
71992+ post:
71993+ description: Create a new email notification channel for an on-call user
71994+ operationId: CreateUserEmailNotificationChannel
71995+ parameters:
71996+ - description: The user ID
71997+ in: path
71998+ name: user_id
71999+ required: true
72000+ schema:
72001+ example: 00000000-0000-0000-0000-000000000000
72002+ type: string
72003+ requestBody:
72004+ content:
72005+ application/json:
72006+ schema:
72007+ $ref: '#/components/schemas/EmailCreateRequest'
72008+ required: true
72009+ responses:
72010+ '201':
72011+ content:
72012+ application/json:
72013+ schema:
72014+ $ref: '#/components/schemas/Email'
72015+ description: Created
72016+ '400':
72017+ $ref: '#/components/responses/BadRequestResponse'
72018+ '401':
72019+ $ref: '#/components/responses/UnauthorizedResponse'
72020+ '403':
72021+ $ref: '#/components/responses/ForbiddenResponse'
72022+ '404':
72023+ $ref: '#/components/responses/NotFoundResponse'
72024+ '429':
72025+ $ref: '#/components/responses/TooManyRequestsResponse'
72026+ security:
72027+ - apiKeyAuth: []
72028+ appKeyAuth: []
72029+ - AuthZ: []
72030+ summary: Create an On-Call email for a user
72031+ tags:
72032+ - On-Call
72033+ x-permission:
72034+ operator: AND
72035+ permissions:
72036+ - on_call_admin
72037+ /api/v2/on-call/users/{user_id}/notification-channels/emails/{email_id}:
72038+ delete:
72039+ description: Delete an email notification channel for an on-call user
72040+ operationId: DeleteUserEmailNotificationChannel
72041+ parameters:
72042+ - description: The user ID
72043+ in: path
72044+ name: user_id
72045+ required: true
72046+ schema:
72047+ example: 00000000-0000-0000-0000-000000000000
72048+ type: string
72049+ - description: The email ID
72050+ in: path
72051+ name: email_id
72052+ required: true
72053+ schema:
72054+ example: 45bb8fe5-dd96-42ad-83de-2241ea9f6ffc
72055+ type: string
72056+ responses:
72057+ '204':
72058+ description: No Content
72059+ '400':
72060+ $ref: '#/components/responses/BadRequestResponse'
72061+ '401':
72062+ $ref: '#/components/responses/UnauthorizedResponse'
72063+ '403':
72064+ $ref: '#/components/responses/ForbiddenResponse'
72065+ '404':
72066+ $ref: '#/components/responses/NotFoundResponse'
72067+ '429':
72068+ $ref: '#/components/responses/TooManyRequestsResponse'
72069+ security:
72070+ - apiKeyAuth: []
72071+ appKeyAuth: []
72072+ - AuthZ: []
72073+ summary: Delete an On-Call email for a user
72074+ tags:
72075+ - On-Call
72076+ x-permission:
72077+ operator: AND
72078+ permissions:
72079+ - on_call_admin
72080+ get:
72081+ description: Get an email notification channel for an on-call user
72082+ operationId: GetUserEmailNotificationChannel
72083+ parameters:
72084+ - description: The user ID
72085+ in: path
72086+ name: user_id
72087+ required: true
72088+ schema:
72089+ example: 00000000-0000-0000-0000-000000000000
72090+ type: string
72091+ - description: The email ID
72092+ in: path
72093+ name: email_id
72094+ required: true
72095+ schema:
72096+ example: 45bb8fe5-dd96-42ad-83de-2241ea9f6ffc
72097+ type: string
72098+ responses:
72099+ '200':
72100+ content:
72101+ application/json:
72102+ schema:
72103+ $ref: '#/components/schemas/Email'
72104+ description: OK
72105+ '400':
72106+ $ref: '#/components/responses/BadRequestResponse'
72107+ '401':
72108+ $ref: '#/components/responses/UnauthorizedResponse'
72109+ '403':
72110+ $ref: '#/components/responses/ForbiddenResponse'
72111+ '404':
72112+ $ref: '#/components/responses/NotFoundResponse'
72113+ '429':
72114+ $ref: '#/components/responses/TooManyRequestsResponse'
72115+ security:
72116+ - apiKeyAuth: []
72117+ appKeyAuth: []
72118+ - AuthZ: []
72119+ summary: Get an On-Call email for a user
72120+ tags:
72121+ - On-Call
72122+ x-permission:
72123+ operator: AND
72124+ permissions:
72125+ - on_call_admin
72126+ put:
72127+ description: Update an email notification channel for an on-call user
72128+ operationId: UpdateUserEmailNotificationChannel
72129+ parameters:
72130+ - description: The user ID
72131+ in: path
72132+ name: user_id
72133+ required: true
72134+ schema:
72135+ example: 00000000-0000-0000-0000-000000000000
72136+ type: string
72137+ - description: The email ID
72138+ in: path
72139+ name: email_id
72140+ required: true
72141+ schema:
72142+ example: 45bb8fe5-dd96-42ad-83de-2241ea9f6ffc
72143+ type: string
72144+ requestBody:
72145+ content:
72146+ application/json:
72147+ schema:
72148+ $ref: '#/components/schemas/EmailUpdateRequest'
72149+ required: true
72150+ responses:
72151+ '200':
72152+ content:
72153+ application/json:
72154+ schema:
72155+ $ref: '#/components/schemas/Email'
72156+ description: OK
72157+ '400':
72158+ $ref: '#/components/responses/BadRequestResponse'
72159+ '401':
72160+ $ref: '#/components/responses/UnauthorizedResponse'
72161+ '403':
72162+ $ref: '#/components/responses/ForbiddenResponse'
72163+ '404':
72164+ $ref: '#/components/responses/NotFoundResponse'
72165+ '429':
72166+ $ref: '#/components/responses/TooManyRequestsResponse'
72167+ security:
72168+ - apiKeyAuth: []
72169+ appKeyAuth: []
72170+ - AuthZ: []
72171+ summary: Update an On-Call email for a user
72172+ tags:
72173+ - On-Call
72174+ x-permission:
72175+ operator: AND
72176+ permissions:
72177+ - on_call_admin
7190972178 /api/v2/org_configs:
7191072179 get:
7191172180 description: Returns all Org Configs (name, description, and value).
0 commit comments