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

# Delete data quality rules for a field

> Remove all data quality rules for a single schema field on a workflow



## OpenAPI

````yaml delete /v4/workflows/{workflowId}/schema-validation-rules/{fieldName}
openapi: 3.0.3
info:
  title: Kadoa API
  version: 3.0.0
  contact:
    name: Support
    email: support@kadoa.com
servers:
  - url: https://api.kadoa.com
security: []
paths:
  /v4/workflows/{workflowId}/schema-validation-rules/{fieldName}:
    delete:
      tags:
        - Data Quality
      summary: Delete data quality rules for a single field
      description: |
        Remove all data quality rules for a single schema field on a workflow.
        Other fields' rules are left untouched.
      parameters:
        - name: workflowId
          in: path
          required: true
          description: ID of the workflow
          schema:
            type: string
        - name: fieldName
          in: path
          required: true
          description: Name of the schema field whose rules should be removed
          schema:
            type: string
      responses:
        '200':
          description: >-
            Rules removed (or no-op if the field had no rules). Returns the
            remaining ruleset.
          content:
            application/json:
              schema:
                type: object
                required:
                  - rules
                properties:
                  rules:
                    $ref: '#/components/schemas/WorkflowSchemaValidationRules'
        '400':
          description: Invalid workflow ID format or missing fieldName
        '401':
          description: Unauthorized
        '404':
          description: Workflow not found
        '500':
          description: Internal server error
      security:
        - ApiKeyAuth: []
components:
  schemas:
    WorkflowSchemaValidationRules:
      type: object
      description: >-
        Map keyed by schema field name, with the per-field data quality rules
        for that field.
      additionalProperties:
        $ref: '#/components/schemas/FieldValidationRules'
    FieldValidationRules:
      description: >
        Rules for one schema field. The `kind` discriminator selects the rule
        shape and casts the

        field's values to that type before evaluation. A rule tree may nest at
        most 4 levels deep

        and hold at most 200 evaluable rules.
      oneOf:
        - $ref: '#/components/schemas/StringFieldRules'
        - $ref: '#/components/schemas/NumberFieldRules'
        - $ref: '#/components/schemas/DateFieldRules'
        - $ref: '#/components/schemas/ObjectFieldRules'
        - $ref: '#/components/schemas/ArrayFieldRules'
        - $ref: '#/components/schemas/OtherFieldRules'
      discriminator:
        propertyName: kind
    StringFieldRules:
      type: object
      required:
        - kind
      description: Validation rules for string fields.
      properties:
        kind:
          type: string
          enum:
            - STRING
        presence:
          $ref: '#/components/schemas/PresenceRule'
        uniqueness:
          $ref: '#/components/schemas/UniquenessRule'
        minLength:
          $ref: '#/components/schemas/StringLengthRule'
        maxLength:
          $ref: '#/components/schemas/StringLengthRule'
        minHtmlElements:
          $ref: '#/components/schemas/StringHtmlElementCountRule'
        maxHtmlElements:
          $ref: '#/components/schemas/StringHtmlElementCountRule'
        format:
          $ref: '#/components/schemas/StringFormatRule'
    NumberFieldRules:
      type: object
      required:
        - kind
      description: Validation rules for number fields.
      properties:
        kind:
          type: string
          enum:
            - NUMBER
        presence:
          $ref: '#/components/schemas/PresenceRule'
        uniqueness:
          $ref: '#/components/schemas/UniquenessRule'
        minimum:
          $ref: '#/components/schemas/NumberBoundRule'
        maximum:
          $ref: '#/components/schemas/NumberBoundRule'
        maxDecimalPlaces:
          $ref: '#/components/schemas/NumberMaxDecimalPlacesRule'
    DateFieldRules:
      type: object
      required:
        - kind
      description: >
        Validation rules for date fields. Values are cast to a calendar date
        (`YYYY-MM-DD`,

        or a `YYYY-MM-DD HH:MM:SS` timestamp truncated to its day) before the
        bounds apply.
      properties:
        kind:
          type: string
          enum:
            - DATE
        presence:
          $ref: '#/components/schemas/PresenceRule'
        uniqueness:
          $ref: '#/components/schemas/UniquenessRule'
        minimum:
          $ref: '#/components/schemas/DateBoundRule'
        maximum:
          $ref: '#/components/schemas/DateBoundRule'
    ObjectFieldRules:
      type: object
      required:
        - kind
        - properties
      description: >
        Rules for an object field. `properties` maps each sub-field name to its
        own rules

        (recursively a `FieldValidationRules`), so nested objects can be
        validated to any depth.
      properties:
        kind:
          type: string
          enum:
            - OBJECT
        presence:
          $ref: '#/components/schemas/PresenceRule'
        uniqueness:
          $ref: '#/components/schemas/UniquenessRule'
        additionalProperties:
          $ref: '#/components/schemas/ObjectAdditionalPropertiesRule'
        properties:
          type: object
          description: Per-sub-field rules, keyed by sub-field name.
          additionalProperties:
            $ref: '#/components/schemas/FieldValidationRules'
    ArrayFieldRules:
      type: object
      required:
        - kind
      description: >
        Rules for an array field. `items` are the rules applied to every element
        of the array

        (recursively a `FieldValidationRules`).
      properties:
        kind:
          type: string
          enum:
            - ARRAY
        presence:
          $ref: '#/components/schemas/PresenceRule'
        uniqueness:
          $ref: '#/components/schemas/UniquenessRule'
        minItems:
          $ref: '#/components/schemas/ArrayItemCountRule'
        maxItems:
          $ref: '#/components/schemas/ArrayItemCountRule'
        items:
          $ref: '#/components/schemas/FieldValidationRules'
    OtherFieldRules:
      type: object
      required:
        - kind
      description: Fallback rules for fields with no richer rule shape (e.g. booleans).
      properties:
        kind:
          type: string
          enum:
            - OTHER
        presence:
          $ref: '#/components/schemas/PresenceRule'
        uniqueness:
          $ref: '#/components/schemas/UniquenessRule'
    PresenceRule:
      type: object
      description: Minimum percentage of rows that must have a value for this field.
      required:
        - target
        - editedBy
        - editedAt
      properties:
        target:
          type: integer
          enum:
            - 0
            - 20
            - 40
            - 60
            - 80
            - 100
        editedBy:
          type: string
          enum:
            - default
            - llm
            - agent
            - ops
            - user
          description: Actor type that produced the last edit. API clients send `user`.
        editedByLabel:
          type: string
          description: >-
            Optional human-readable label for the editor (e.g. email for users,
            agent name for agents).
        editedAt:
          type: string
          format: date-time
          description: ISO-8601 timestamp of the last edit.
    UniquenessRule:
      type: object
      description: Minimum percentage of values that must be unique in this column.
      required:
        - target
        - editedBy
        - editedAt
      properties:
        target:
          type: integer
          enum:
            - 0
            - 20
            - 40
            - 60
            - 80
            - 100
        editedBy:
          type: string
          enum:
            - default
            - llm
            - agent
            - ops
            - user
          description: Actor type that produced the last edit. API clients send `user`.
        editedByLabel:
          type: string
          description: >-
            Optional human-readable label for the editor (e.g. email for users,
            agent name for agents).
        editedAt:
          type: string
          format: date-time
          description: ISO-8601 timestamp of the last edit.
    StringLengthRule:
      type: object
      description: Bound on the string length in characters.
      required:
        - value
        - editedBy
        - editedAt
      properties:
        value:
          type: integer
          minimum: 0
        editedBy:
          type: string
          enum:
            - default
            - llm
            - agent
            - ops
            - user
          description: Actor type that produced the last edit. API clients send `user`.
        editedByLabel:
          type: string
          description: >-
            Optional human-readable label for the editor (e.g. email for users,
            agent name for agents).
        editedAt:
          type: string
          format: date-time
          description: ISO-8601 timestamp of the last edit.
    StringHtmlElementCountRule:
      type: object
      description: >
        Bound on how many HTML elements the text contains. An element is an
        opening or

        self-closing tag (e.g. `<h1>Foo</h1> bar` counts 1, `<h1>Foo</h1>
        <p>bar</p>` counts 2);

        closing tags, comments, and doctypes don't count.
      required:
        - value
        - editedBy
        - editedAt
      properties:
        value:
          type: integer
          minimum: 0
        editedBy:
          type: string
          enum:
            - default
            - llm
            - agent
            - ops
            - user
          description: Actor type that produced the last edit. API clients send `user`.
        editedByLabel:
          type: string
          description: >-
            Optional human-readable label for the editor (e.g. email for users,
            agent name for agents).
        editedAt:
          type: string
          format: date-time
          description: ISO-8601 timestamp of the last edit.
    StringFormatRule:
      description: >
        Format rule for string fields. The `kind` discriminator selects one of
        three shapes:
          - `FREE_TEXT` (see `StringFormatFreeTextRule`): a character-class restriction. Length rules apply only with this kind.
          - `FORMAT` (see `StringFormatFormatRule`): a named pattern preset or a custom regex.
          - `LIST` (see `StringFormatListRule`): a named list preset or a custom list of allowed values.
      oneOf:
        - $ref: '#/components/schemas/StringFormatFreeTextRule'
        - $ref: '#/components/schemas/StringFormatFormatRule'
        - $ref: '#/components/schemas/StringFormatListRule'
      discriminator:
        propertyName: kind
    NumberBoundRule:
      type: object
      description: Inclusive bound on the numeric value.
      required:
        - value
        - editedBy
        - editedAt
      properties:
        value:
          type: number
        editedBy:
          type: string
          enum:
            - default
            - llm
            - agent
            - ops
            - user
          description: Actor type that produced the last edit. API clients send `user`.
        editedByLabel:
          type: string
          description: >-
            Optional human-readable label for the editor (e.g. email for users,
            agent name for agents).
        editedAt:
          type: string
          format: date-time
          description: ISO-8601 timestamp of the last edit.
    NumberMaxDecimalPlacesRule:
      type: object
      description: Maximum number of decimal places (0 for whole numbers).
      required:
        - value
        - editedBy
        - editedAt
      properties:
        value:
          type: integer
          minimum: 0
          maximum: 16
        editedBy:
          type: string
          enum:
            - default
            - llm
            - agent
            - ops
            - user
          description: Actor type that produced the last edit. API clients send `user`.
        editedByLabel:
          type: string
          description: >-
            Optional human-readable label for the editor (e.g. email for users,
            agent name for agents).
        editedAt:
          type: string
          format: date-time
          description: ISO-8601 timestamp of the last edit.
    DateBoundRule:
      description: >-
        Inclusive bound on a date value, either fixed or relative to the run
        date.
      oneOf:
        - $ref: '#/components/schemas/DateFixedBoundRule'
        - $ref: '#/components/schemas/DateRelativeBoundRule'
      discriminator:
        propertyName: kind
    ObjectAdditionalPropertiesRule:
      type: object
      description: >-
        Whether the object may contain properties that are not listed under
        `properties`.
      required:
        - allowed
        - editedBy
        - editedAt
      properties:
        allowed:
          type: boolean
        editedBy:
          type: string
          enum:
            - default
            - llm
            - agent
            - ops
            - user
          description: Actor type that produced the last edit. API clients send `user`.
        editedByLabel:
          type: string
          description: >-
            Optional human-readable label for the editor (e.g. email for users,
            agent name for agents).
        editedAt:
          type: string
          format: date-time
          description: ISO-8601 timestamp of the last edit.
    ArrayItemCountRule:
      type: object
      description: Bound on the number of items in the array.
      required:
        - value
        - editedBy
        - editedAt
      properties:
        value:
          type: integer
          minimum: 0
        editedBy:
          type: string
          enum:
            - default
            - llm
            - agent
            - ops
            - user
          description: Actor type that produced the last edit. API clients send `user`.
        editedByLabel:
          type: string
          description: >-
            Optional human-readable label for the editor (e.g. email for users,
            agent name for agents).
        editedAt:
          type: string
          format: date-time
          description: ISO-8601 timestamp of the last edit.
    StringFormatFreeTextRule:
      type: object
      description: >-
        Free-text format. A character-class restriction; length rules apply only
        with this kind.
      required:
        - kind
        - charset
        - editedBy
        - editedAt
      properties:
        kind:
          type: string
          enum:
            - FREE_TEXT
        charset:
          $ref: '#/components/schemas/StringCharsetPreset'
        editedBy:
          type: string
          enum:
            - default
            - llm
            - agent
            - ops
            - user
          description: Actor type that produced the last edit. API clients send `user`.
        editedByLabel:
          type: string
          description: >-
            Optional human-readable label for the editor (e.g. email for users,
            agent name for agents).
        editedAt:
          type: string
          format: date-time
          description: ISO-8601 timestamp of the last edit.
    StringFormatFormatRule:
      type: object
      description: >-
        Pattern format. Values must match a named pattern preset or a custom
        regular expression.
      required:
        - kind
        - source
        - editedBy
        - editedAt
      properties:
        kind:
          type: string
          enum:
            - FORMAT
        source:
          $ref: '#/components/schemas/StringPatternSource'
        editedBy:
          type: string
          enum:
            - default
            - llm
            - agent
            - ops
            - user
          description: Actor type that produced the last edit. API clients send `user`.
        editedByLabel:
          type: string
          description: >-
            Optional human-readable label for the editor (e.g. email for users,
            agent name for agents).
        editedAt:
          type: string
          format: date-time
          description: ISO-8601 timestamp of the last edit.
    StringFormatListRule:
      type: object
      description: List format. Values must come from a named list preset or a custom list.
      required:
        - kind
        - source
        - editedBy
        - editedAt
      properties:
        kind:
          type: string
          enum:
            - LIST
        source:
          $ref: '#/components/schemas/StringListSource'
        editedBy:
          type: string
          enum:
            - default
            - llm
            - agent
            - ops
            - user
          description: Actor type that produced the last edit. API clients send `user`.
        editedByLabel:
          type: string
          description: >-
            Optional human-readable label for the editor (e.g. email for users,
            agent name for agents).
        editedAt:
          type: string
          format: date-time
          description: ISO-8601 timestamp of the last edit.
    DateFixedBoundRule:
      type: object
      description: A fixed calendar date bound.
      required:
        - kind
        - date
        - editedBy
        - editedAt
      properties:
        kind:
          type: string
          enum:
            - FIXED
        date:
          type: string
          format: date
          description: A valid calendar date in `YYYY-MM-DD` format.
        editedBy:
          type: string
          enum:
            - default
            - llm
            - agent
            - ops
            - user
          description: Actor type that produced the last edit. API clients send `user`.
        editedByLabel:
          type: string
          description: >-
            Optional human-readable label for the editor (e.g. email for users,
            agent name for agents).
        editedAt:
          type: string
          format: date-time
          description: ISO-8601 timestamp of the last edit.
    DateRelativeBoundRule:
      type: object
      description: >
        A bound relative to the run date (UTC). As a minimum it resolves to the
        first day of the

        period, as a maximum to the last day (e.g. `THIS_MONTH` is the 1st or
        the last day of the run month).
      required:
        - kind
        - preset
        - editedBy
        - editedAt
      properties:
        kind:
          type: string
          enum:
            - RELATIVE
        preset:
          type: string
          enum:
            - TODAY
            - YESTERDAY
            - THIS_WEEK
            - THIS_MONTH
            - THIS_YEAR
        editedBy:
          type: string
          enum:
            - default
            - llm
            - agent
            - ops
            - user
          description: Actor type that produced the last edit. API clients send `user`.
        editedByLabel:
          type: string
          description: >-
            Optional human-readable label for the editor (e.g. email for users,
            agent name for agents).
        editedAt:
          type: string
          format: date-time
          description: ISO-8601 timestamp of the last edit.
    StringCharsetPreset:
      type: object
      description: A named character-class restriction.
      required:
        - kind
        - preset
      properties:
        kind:
          type: string
          enum:
            - PRESET
        preset:
          type: string
          enum:
            - natural_language
            - alphanumeric
            - alpha
    StringPatternSource:
      oneOf:
        - $ref: '#/components/schemas/StringPatternPreset'
        - $ref: '#/components/schemas/StringCustomPattern'
      discriminator:
        propertyName: kind
    StringListSource:
      oneOf:
        - $ref: '#/components/schemas/StringListPreset'
        - $ref: '#/components/schemas/StringCustomList'
      discriminator:
        propertyName: kind
    StringPatternPreset:
      type: object
      description: A named pattern preset.
      required:
        - kind
        - preset
      properties:
        kind:
          type: string
          enum:
            - PRESET
        preset:
          type: string
          enum:
            - url
            - email
            - phone
            - date
            - datetime
            - time
            - uuid
            - slug
    StringCustomPattern:
      type: object
      description: A custom regular expression.
      required:
        - kind
        - pattern
      properties:
        kind:
          type: string
          enum:
            - CUSTOM
        pattern:
          type: string
          minLength: 1
          description: Must be a valid regular expression.
    StringListPreset:
      type: object
      description: A named list of allowed values.
      required:
        - kind
        - preset
      properties:
        kind:
          type: string
          enum:
            - PRESET
        preset:
          type: string
          enum:
            - language2
            - country2
            - country3
            - currency3
            - month3
            - usState2
    StringCustomList:
      type: object
      description: A custom closed set of allowed values.
      required:
        - kind
        - values
      properties:
        kind:
          type: string
          enum:
            - CUSTOM
        values:
          type: array
          items:
            type: string
            minLength: 1
          minItems: 1
          description: The closed set of allowed values.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key for authentication

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.