> ## Documentation Index
> Fetch the complete documentation index at: https://docs.leadpipe.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Upload suppression rules (append)

> Adds up to 25,000 rules in one call, on top of what is already stored; send more by posting again. There is no cap on how many rules an organization may keep. Values are normalized before storage (lowercased; domains lose scheme, `www.`, path and port), so re-uploading the same list is a no-op. Rows that fail validation come back in `rejected` — every other row is still applied. Rules take effect from the next sync cycle onward; visitors already charged are not refunded. Authenticates via X-API-Key header.



## OpenAPI

````yaml https://api.aws53.cloud/openapi-data.json post /v1/data/suppression-rules
openapi: 3.1.0
info:
  title: Identification API
  version: 1.0.0
  description: >-
    Programmatic access to your visitor data and pixel management. Authenticate
    with your API key (X-API-Key header).
servers:
  - url: https://api.aws53.cloud
    description: Production
security:
  - apiKeyAuth: []
tags:
  - name: Visitors
  - name: Pixels
  - name: Account
  - name: Visitor Suppression
paths:
  /v1/data/suppression-rules:
    post:
      tags:
        - Visitor Suppression
      summary: Upload suppression rules (append)
      description: >-
        Adds up to 25,000 rules in one call, on top of what is already stored;
        send more by posting again. There is no cap on how many rules an
        organization may keep. Values are normalized before storage (lowercased;
        domains lose scheme, `www.`, path and port), so re-uploading the same
        list is a no-op. Rows that fail validation come back in `rejected` —
        every other row is still applied. Rules take effect from the next sync
        cycle onward; visitors already charged are not refunded. Authenticates
        via X-API-Key header.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                rules:
                  type: array
                  items:
                    type: object
                    properties:
                      type:
                        type: string
                        enum:
                          - email
                          - domain
                          - company_domain
                          - industry
                      value:
                        type: string
                        minLength: 1
                        maxLength: 500
                    required:
                      - type
                      - value
                  minItems: 1
                  maxItems: 25000
              required:
                - rules
              example:
                rules:
                  - type: domain
                    value: mycompany.com
                  - type: email
                    value: ceo@partner.com
                  - type: company_domain
                    value: https://www.competitor.com/pricing
                  - type: industry
                    value: Higher Education
      responses:
        '200':
          description: Rules applied
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuppressionWriteResult'
        '400':
          description: Validation error
        '401':
          description: Missing or invalid API key
        '403':
          description: Revoked key or inactive organization
      security:
        - apiKeyAuth: []
components:
  schemas:
    SuppressionWriteResult:
      type: object
      properties:
        data:
          type: object
          properties:
            added:
              type: number
              description: Rules newly stored
            removed:
              type: number
              description: Rules deleted (replace mode only)
            duplicates:
              type: number
              description: 'Rows skipped: already stored, or repeated within the request'
            rejectedCount:
              type: number
              description: Rows that failed validation
            rejected:
              type: array
              items:
                type: object
                properties:
                  index:
                    type: number
                    description: Position of the row in the submitted array
                  type:
                    type: string
                  value:
                    type: string
                  reason:
                    type: string
                required:
                  - index
                  - type
                  - value
                  - reason
              description: >-
                Detail for the first 100 rejected rows — everything else in the
                batch was still applied
            total:
              type: number
              description: Rules stored for the organization after this call
          required:
            - added
            - removed
            - duplicates
            - rejectedCount
            - rejected
            - total
      required:
        - data
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: >-
        Organization API key (sk_...). Get yours from Settings > API Keys in the
        dashboard.

````