APIs.io Engineering Platform DLP Profiles API

openapi: 3.2.0
info:
  description: 'To get started using Cloudflare''s products and services via the API, refer to [how to interact with Cloudflare](https://developers.cloudflare.com/fundamentals/basic-tasks/interact-with-cloudflare/), which covers using tools like [Terraform](https://developers.cloudflare.com/terraform/#cloudflare-terraform) and the [official SDKs](https://developers.cloudflare.com/fundamentals/api/reference/sdks/) to maintain your Cloudflare resources.


    Using the Cloudflare API requires authentication so that Cloudflare knows who is making requests and what permissions you have. Create an API token to grant access to the API to perform actions.


    To create an API token, from the Cloudflare dashboard, go to My Profile > API Tokens and select Create Token. For more information on how to create and troubleshoot API tokens, refer to

    our [API fundamentals](https://developers.cloudflare.com/fundamentals/api/).


    Totally new to Cloudflare? [Start here](https://developers.cloudflare.com/fundamentals/get-started/).'
  license:
    name: BSD-3-Clause
    url: https://opensource.org/licenses/BSD-3-Clause
  title: APIs.io Engineering Platform Cloudflare DLP Profiles API
  version: 4.0.0
tags:
- name: DLP Profiles
paths:
  /accounts/{account_id}/dlp/profiles:
    get:
      description: Lists all DLP profiles in an account.
      operationId: dlp-profiles-list-all-profiles
      parameters:
      - description: Return all profiles, including those that current account does not have access to.
        in: query
        name: all
        schema:
          type: boolean
      - in: path
        name: account_id
        required: true
        schema:
          type: string
      responses:
        4XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dlp_api-response-common-failure'
          description: List all profiles failure response
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/dlp_api-response-single'
                - properties:
                    result:
                      $ref: '#/components/schemas/dlp_ProfileArray'
                  type: object
          description: List all profiles response
      security:
      - api_email: []
        api_key: []
        api_token: []
      summary: APIs.io Engineering Platform List all profiles
      tags:
      - DLP Profiles
  /accounts/{account_id}/dlp/profiles/{profile_id}:
    get:
      description: Fetches a DLP profile by ID
      operationId: dlp-profiles-get-dlp-profile
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          type: string
      - in: path
        name: profile_id
        required: true
        schema:
          format: uuid
          type: string
      responses:
        4XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dlp_api-response-common-failure'
          description: Get profile failure response
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/dlp_api-response-single'
                - properties:
                    result:
                      $ref: '#/components/schemas/dlp_Profile'
                  type: object
          description: Get profile response
      security:
      - api_email: []
        api_key: []
        api_token: []
      summary: APIs.io Engineering Platform Get DLP Profile
      tags:
      - DLP Profiles
  /accounts/{account_id}/dlp/profiles/custom:
    post:
      description: Creates a set of DLP custom profiles.
      operationId: dlp-profiles-create-custom-profiles
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/dlp_NewCustomProfiles'
        description: A list of new profiles to create.
        required: true
      responses:
        4XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dlp_api-response-common-failure'
          description: New custom profile failure response
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/dlp_api-response-single'
                - properties:
                    result:
                      $ref: '#/components/schemas/dlp_ProfileArray'
                  type: object
          description: New custom profile response
      security:
      - api_email: []
        api_key: []
        api_token: []
      summary: APIs.io Engineering Platform Create custom profiles
      tags:
      - DLP Profiles
  /accounts/{account_id}/dlp/profiles/custom/{profile_id}:
    delete:
      description: Deletes a DLP custom profile.
      operationId: dlp-profiles-delete-custom-profile
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          type: string
      - in: path
        name: profile_id
        required: true
        schema:
          format: uuid
          type: string
      responses:
        4XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dlp_api-response-common-failure'
          description: Delete custom profile failure response
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/dlp_api-response-single'
                - properties:
                    result:
                      $ref: '#/components/schemas/dlp_Empty'
                  type: object
          description: Delete custom profile response
      security:
      - api_email: []
        api_key: []
        api_token: []
      summary: APIs.io Engineering Platform Delete custom profile
      tags:
      - DLP Profiles
    get:
      description: Fetches a custom DLP profile by id.
      operationId: dlp-profiles-get-custom-profile
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          type: string
      - in: path
        name: profile_id
        required: true
        schema:
          format: uuid
          type: string
      responses:
        4XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dlp_api-response-common-failure'
          description: Custom profile failure response
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/dlp_api-response-single'
                - properties:
                    result:
                      $ref: '#/components/schemas/dlp_Profile'
                  type: object
          description: Custom profile response
      security:
      - api_email: []
        api_key: []
        api_token: []
      summary: APIs.io Engineering Platform Get custom profile
      tags:
      - DLP Profiles
    put:
      description: Updates a DLP custom profile.
      operationId: dlp-profiles-update-custom-profile
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          type: string
      - in: path
        name: profile_id
        required: true
        schema:
          format: uuid
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/dlp_CustomProfileUpdate'
        description: The updated parameters for the profile.
        required: true
      responses:
        4XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dlp_api-response-common-failure'
          description: Update custom profile failure response
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/dlp_api-response-single'
                - properties:
                    result:
                      $ref: '#/components/schemas/dlp_Profile'
                  type: object
          description: Update custom profile response
      security:
      - api_email: []
        api_key: []
        api_token: []
      summary: APIs.io Engineering Platform Update custom profile
      tags:
      - DLP Profiles
  /accounts/{account_id}/dlp/profiles/predefined/{profile_id}:
    get:
      description: Fetches a predefined DLP profile by id.
      operationId: dlp-profiles-get-predefined-profile
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          type: string
      - in: path
        name: profile_id
        required: true
        schema:
          format: uuid
          type: string
      responses:
        4XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dlp_api-response-common-failure'
          description: Predefined profile failure response
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/dlp_api-response-single'
                - properties:
                    result:
                      $ref: '#/components/schemas/dlp_Profile'
                  type: object
          description: Predefined profile response
      security:
      - api_email: []
        api_key: []
        api_token: []
      summary: APIs.io Engineering Platform Get predefined profile
      tags:
      - DLP Profiles
    put:
      description: Updates a DLP predefined profile. Only supports enabling/disabling entries.
      operationId: dlp-profiles-update-predefined-profile
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          type: string
      - in: path
        name: profile_id
        required: true
        schema:
          format: uuid
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/dlp_PredefinedProfileUpdate'
        description: The updated parameters for the predefined profile.
        required: true
      responses:
        4XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dlp_api-response-common-failure'
          description: Update predefined profile failure response
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/dlp_api-response-single'
                - properties:
                    result:
                      $ref: '#/components/schemas/dlp_Profile'
                  type: object
          description: Update predefined profile response
      security:
      - api_email: []
        api_key: []
        api_token: []
      summary: APIs.io Engineering Platform Update predefined profile
      tags:
      - DLP Profiles
components:
  schemas:
    dlp_NewWordListEntry:
      properties:
        enabled:
          type: boolean
        name:
          type: string
        words:
          items:
            type: string
          type: array
      required:
      - name
      - words
      - enabled
      type: object
    dlp_PredefinedProfile:
      properties:
        allowed_match_count:
          format: int32
          type: integer
        context_awareness:
          $ref: '#/components/schemas/dlp_ContextAwareness'
        entries:
          items:
            $ref: '#/components/schemas/dlp_Entry'
          type: array
        id:
          description: The id of the predefined profile (uuid)
          format: uuid
          type: string
        name:
          description: The name of the predefined profile
          type: string
        ocr_enabled:
          type: boolean
        open_access:
          description: Whether this profile can be accessed by anyone
          type: boolean
      required:
      - id
      - name
      - entries
      - allowed_match_count
      type: object
    dlp_messages:
      example: []
      items:
        properties:
          code:
            minimum: 1000
            type: integer
          message:
            type: string
        required:
        - code
        - message
        type: object
        uniqueItems: true
      type: array
    dlp_PredefinedEntry:
      properties:
        enabled:
          type: boolean
        id:
          format: uuid
          type: string
        name:
          type: string
        profile_id:
          format: uuid
          type:
          - string
          - 'null'
      required:
      - id
      - name
      - enabled
      type: object
    dlp_SharedEntryUpdate:
      discriminator:
        propertyName: entry_type
      oneOf:
      - properties:
          enabled:
            type: boolean
          entry_id:
            format: uuid
            type: string
          entry_type:
            enum:
            - predefined
            type: string
        required:
        - entry_id
        - enabled
        - entry_type
        type: object
      - properties:
          enabled:
            type: boolean
          entry_id:
            format: uuid
            type: string
          entry_type:
            enum:
            - integration
            type: string
        required:
        - entry_id
        - enabled
        - entry_type
        type: object
      - properties:
          enabled:
            type: boolean
          entry_id:
            format: uuid
            type: string
          entry_type:
            enum:
            - exact_data
            type: string
        required:
        - entry_id
        - enabled
        - entry_type
        type: object
    dlp_NewCustomProfiles:
      properties:
        profiles:
          items:
            $ref: '#/components/schemas/dlp_NewCustomProfile'
          type: array
      required:
      - profiles
      type: object
    dlp_WordListEntry:
      properties:
        created_at:
          format: date-time
          type: string
        enabled:
          type: boolean
        id:
          format: uuid
          type: string
        name:
          type: string
        profile_id:
          format: uuid
          type:
          - string
          - 'null'
        updated_at:
          format: date-time
          type: string
        word_list: {}
      required:
      - id
      - name
      - created_at
      - updated_at
      - word_list
      - enabled
      type: object
    dlp_SkipConfig:
      description: Content types to exclude from context analysis and return all matches.
      properties:
        files:
          description: If the content type is a file, skip context analysis and return all matches.
          type: boolean
      required:
      - files
      type: object
    dlp_EntryOfNewProfile:
      oneOf:
      - $ref: '#/components/schemas/dlp_NewCustomEntry'
      - $ref: '#/components/schemas/dlp_NewWordListEntry'
    dlp_NewSharedEntry:
      discriminator:
        propertyName: entry_type
      oneOf:
      - properties:
          enabled:
            type: boolean
          entry_id:
            format: uuid
            type: string
          entry_type:
            enum:
            - custom
            type: string
        required:
        - entry_id
        - enabled
        - entry_type
        type: object
      - properties:
          enabled:
            type: boolean
          entry_id:
            format: uuid
            type: string
          entry_type:
            enum:
            - predefined
            type: string
        required:
        - entry_id
        - enabled
        - entry_type
        type: object
      - properties:
          enabled:
            type: boolean
          entry_id:
            format: uuid
            type: string
          entry_type:
            enum:
            - integration
            type: string
        required:
        - entry_id
        - enabled
        - entry_type
        type: object
      - properties:
          enabled:
            type: boolean
          entry_id:
            format: uuid
            type: string
          entry_type:
            enum:
            - exact_data
            type: string
        required:
        - entry_id
        - enabled
        - entry_type
        type: object
    dlp_api-response-common:
      properties:
        errors:
          $ref: '#/components/schemas/dlp_messages'
        messages:
          $ref: '#/components/schemas/dlp_messages'
        success:
          description: Whether the API call was successful
          enum:
          - true
          example: true
          type: boolean
      required:
      - success
      - errors
      - messages
      type: object
    dlp_Validation:
      enum:
      - luhn
      type: string
    dlp_IntegrationProfile:
      properties:
        created_at:
          format: date-time
          type: string
        description:
          description: The description of the profile
          type:
          - string
          - 'null'
        entries:
          items:
            $ref: '#/components/schemas/dlp_Entry'
          type: array
        id:
          format: uuid
          type: string
        name:
          type: string
        updated_at:
          format: date-time
          type: string
      required:
      - id
      - name
      - entries
      - created_at
      - updated_at
      type: object
    dlp_Entry:
      discriminator:
        propertyName: type
      oneOf:
      - allOf:
        - $ref: '#/components/schemas/dlp_CustomEntry'
        - properties:
            type:
              enum:
              - custom
              type: string
          required:
          - type
          type: object
        title: Custom Entry
      - allOf:
        - $ref: '#/components/schemas/dlp_PredefinedEntry'
        - properties:
            type:
              enum:
              - predefined
              type: string
          required:
          - type
          type: object
        title: Predefined Entry
      - allOf:
        - $ref: '#/components/schemas/dlp_IntegrationEntry'
        - properties:
            type:
              enum:
              - integration
              type: string
          required:
          - type
          type: object
        title: Integration Entry
      - allOf:
        - $ref: '#/components/schemas/dlp_ExactDataEntry'
        - properties:
            type:
              enum:
              - exact_data
              type: string
          required:
          - type
          type: object
        title: Exact Data Entry
      - allOf:
        - $ref: '#/components/schemas/dlp_WordListEntry'
        - properties:
            type:
              enum:
              - word_list
              type: string
          required:
          - type
          type: object
        title: Word List Entry
    dlp_CustomProfileUpdate:
      properties:
        allowed_match_count:
          format: int32
          type:
          - integer
          - 'null'
        context_awareness:
          $ref: '#/components/schemas/dlp_ContextAwareness'
        description:
          description: The description of the profile
          type:
          - string
          - 'null'
        entries:
          description: Custom entries from this profile
          items:
            $ref: '#/components/schemas/dlp_EntryUpdate'
          type: array
        name:
          type: string
        ocr_enabled:
          type: boolean
        shared_entries:
          description: Other entries, e.g. predefined or integration.
          items:
            $ref: '#/components/schemas/dlp_SharedEntryUpdate'
          type: array
      required:
      - name
      - entries
      type: object
    dlp_PredefinedEntryUpdate:
      properties:
        enabled:
          type: boolean
        id:
          format: uuid
          type: string
      required:
      - id
      - enabled
      type: object
    dlp_api-response-common-failure:
      properties:
        errors:
          allOf:
          - $ref: '#/components/schemas/dlp_messages'
          example:
          - code: 7003
            message: No route for the URI
          minLength: 1
        messages:
          allOf:
          - $ref: '#/components/schemas/dlp_messages'
          example: []
        result:
          enum:
          - null
          type:
          - object
          - 'null'
        success:
          description: Whether the API call was successful
          enum:
          - false
          example: false
          type: boolean
      required:
      - success
      - errors
      - messages
      - result
      type: object
    dlp_IntegrationEntry:
      properties:
        created_at:
          format: date-time
          type: string
        enabled:
          type: boolean
        id:
          format: uuid
          type: string
        name:
          type: string
        profile_id:
          format: uuid
          type:
          - string
          - 'null'
        updated_at:
          format: date-time
          type: string
      required:
      - id
      - name
      - created_at
      - updated_at
      - enabled
      type: object
    dlp_ExactDataEntry:
      properties:
        created_at:
          format: date-time
          type: string
        enabled:
          type: boolean
        id:
          format: uuid
          type: string
        name:
          type: string
        secret:
          type: boolean
        updated_at:
          format: date-time
          type: string
      required:
      - id
      - name
      - created_at
      - updated_at
      - enabled
      - secret
      type: object
    dlp_Profile:
      discriminator:
        propertyName: type
      oneOf:
      - allOf:
        - $ref: '#/components/schemas/dlp_CustomProfile'
        - properties:
            type:
              enum:
              - custom
              type: string
          required:
          - type
          type: object
        title: Custom Profile
      - allOf:
        - $ref: '#/components/schemas/dlp_PredefinedProfile'
        - properties:
            type:
              enum:
              - predefined
              type: string
          required:
          - type
          type: object
        title: Predefined Profile
      - allOf:
        - $ref: '#/components/schemas/dlp_IntegrationProfile'
        - properties:
            type:
              enum:
              - integration
              type: string
          required:
          - type
          type: object
        title: Integration Profile
    dlp_ProfileArray:
      items:
        $ref: '#/components/schemas/dlp_Profile'
      type: array
    dlp_ContextAwareness:
      description: Scan the context of predefined entries to only return matches surrounded by keywords.
      properties:
        enabled:
          description: If true, scan the context of predefined entries to only return matches surrounded by keywords.
          type: boolean
        skip:
          $ref: '#/components/schemas/dlp_SkipConfig'
      required:
      - enabled
      - skip
      type: object
    dlp_NewCustomEntry:
      properties:
        enabled:
          type: boolean
        name:
          type: string
        pattern:
          $ref: '#/components/schemas/dlp_Pattern'
      required:
      - name
      - pattern
      - enabled
      type: object
    dlp_CustomProfile:
      properties:
        allowed_match_count:
          default: 0
          description: Related DLP policies will trigger when the match count exceeds the number set.
          example: 5
          format: int32
          maximum: 1000
          minimum: 0
          type: integer
        context_awareness:
          $ref: '#/components/schemas/dlp_ContextAwareness'
        created_at:
          description: When the profile was created
          format: date-time
          type: string
        description:
          description: The description of the profile
          type:
          - string
          - 'null'
        entries:
          items:
            $ref: '#/components/schemas/dlp_Entry'
          type: array
        id:
          description: The id of the profile (uuid)
          format: uuid
          type: string
        name:
          description: The name of the profile
          type: string
        ocr_enabled:
          type: boolean
        updated_at:
          description: When the profile was lasted updated
          format: date-time
          type: string
      required:
      - id
      - name
      - entries
      - created_at
      - updated_at
      - allowed_match_count
      - context_awareness
      - ocr_enabled
      type: object
    dlp_api-response-single:
      allOf:
      - $ref: '#/components/schemas/dlp_api-response-common'
      type: object
    dlp_CustomEntry:
      properties:
        created_at:
          format: date-time
          type: string
        enabled:
          type: boolean
        id:
          format: uuid
          type: string
        name:
          type: string
        pattern:
          $ref: '#/components/schemas/dlp_Pattern'
        profile_id:
          format: uuid
          type:
          - string
          - 'null'
        updated_at:
          format: date-time
          type: string
      required:
      - id
      - name
      - created_at
      - updated_at
      - pattern
      - enabled
      type: object
    dlp_NewCustomProfile:
      properties:
        allowed_match_count:
          default: 0
          description: Related DLP policies will trigger when the match count exceeds the number set.
          example: 5
          format: int32
          maximum: 1000
          minimum: 0
          type: integer
        context_awareness:
          $ref: '#/components/schemas/dlp_ContextAwareness'
        description:
          description: The description of the profile
          type:
          - string
          - 'null'
        entries:
          items:
            $ref: '#/components/schemas/dlp_EntryOfNewProfile'
          type: array
        name:
          type: string
        ocr_enabled:
          type: boolean
        shared_entries:
          description: Entries from other profiles (e.g. pre-defined Cloudflare profiles, or your Microsoft Information Protection profiles).
          items:
            $ref: '#/components/schemas/dlp_NewSharedEntry'
          type: array
      required:
      - name
      - entries
      type: object
    dlp_EntryUpdate:
      oneOf:
      - $ref: '#/components/schemas/dlp_NewCustomEntryWithId'
      - $ref: '#/components/schemas/dlp_NewCustomEntry'
    dlp_Empty:
      type:
      - object
      - 'null'
    dlp_Pattern:
      properties:
        regex:
          type: string
        validation:
          allOf:
          - $ref: '#/components/schemas/dlp_Validation'
      required:
      - regex
      type: object
    dlp_NewCustomEntryWithId:
      allOf:
      - $ref: '#/components/schemas/dlp_NewCustomEntry'
      - properties:
          entry_id:
            format: uuid
            type: string
        required:
        - entry_id
        type: object
    dlp_PredefinedProfileUpdate:
      properties:
        allowed_match_count:
          format: int32
          type:
          - integer
          - 'null'
        context_awareness:
          $ref: '#/components/schemas/dlp_ContextAwareness'
        entries:
          items:
            $ref: '#/components/schemas/dlp_PredefinedEntryUpdate'
          type: array
        ocr_enabled:
          type: boolean
      required:
      - entries
      type: object
  securitySchemes:
    api_email:
      in: header
      name: X-Auth-Email
      type: apiKey
    api_key:
      in: header
      name: X-Auth-Key
      type: apiKey
    api_token:
      scheme: bearer
      type: http
    user_service_key:
      in: header
      name: X-Auth-User-Service-Key
      type: apiKey