openapi: 3.2.0
info:
  title: Data Compliance (Deprecated) Delete Chatter Data API
  version: 1.0.0
servers:
- url: https://example.ada.support
  description: ada
- url: https://example.maple.ada.support
  description: maple.ada
- url: https://example.eu.ada.support
  description: eu.ada
tags:
- name: deleteChatterData
paths:
  /api/v1/data-subject-request:
    post:
      operationId: delete-all-data-associated-with-a-chatters-email-address
      summary: Delete all data associated with a chatter's email address
      description: Deletes all data associated with the provided chatter's email address linked to the bot. Replace `example` with your agent's handle. A successful call returns the chatter's email supplied (null if email field was not supplied) in the request whose data will be deleted from Ada's systems. In order to ensure emails are properly linked to a chatter record, ensure the capture block validation when capturing email is set to `@ Email.`<br><br> **Note for multiple participant emails:** If you are requesting data deletion for one chatter’s email address and they are a participant in a conversation that has multiple email participants (i.e., Email thread with additional recipients in CC), the entire transcript will be deleted for all participants.
      tags:
      - deleteChatterData
      parameters:
      - name: Authorization
        in: header
        description: Bearer authentication
        required: true
        schema:
          type: string
      responses:
        '200':
          description: The request was successfully ingested into Ada's system.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteSubjectResponse'
        '400':
          description: Invalid request body or headers.
          content:
            application/json:
              schema:
                description: Any type
        '401':
          description: Authentication token is invalid or does not have the correct permissions. Try generating a new token.
          content:
            application/json:
              schema:
                description: Any type
        '500':
          description: Something went wrong on Ada's end.
          content:
            application/json:
              schema:
                description: Any type
        '502':
          description: Nginx gateway issue on Ada's servers.
          content:
            application/json:
              schema:
                description: Any type
        '503':
          description: Server temporarily unable to handle the request.
          content:
            application/json:
              schema:
                description: Any type
        '504':
          description: Temporary infrastructure error on Ada's servers.
          content:
            application/json:
              schema:
                description: Any type
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeleteSubjectRequest'
components:
  schemas:
    IdentifiersTypeItemsType:
      type: string
      enum:
      - email
      - chatter_id
      title: IdentifiersTypeItemsType
    IdentifiersType:
      type: array
      items:
        $ref: '#/components/schemas/IdentifiersTypeItems'
      description: List containing extra identifiers sent with the data subject request.
      title: IdentifiersType
    IdentifiersTypeItems:
      type: object
      properties:
        type:
          $ref: '#/components/schemas/IdentifiersTypeItemsType'
        value:
          type: string
      title: IdentifiersTypeItems
    DeleteSubjectRequest:
      type: object
      properties:
        type:
          $ref: '#/components/schemas/TokenType'
        email:
          $ref: '#/components/schemas/EmailType'
        identifiers:
          $ref: '#/components/schemas/IdentifiersType'
      required:
      - type
      title: DeleteSubjectRequest
    DeleteSubjectResponse:
      type: object
      properties:
        email:
          $ref: '#/components/schemas/EmailType'
      title: DeleteSubjectResponse
    TokenType:
      type: string
      enum:
      - ERASURE
      description: Type of data subject request. Must be set to ERASURE.
      title: TokenType
    EmailType:
      type: string
      description: Email of the chatter whose data you wish to delete from Ada's systems.
      title: EmailType
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer