> ## 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.

# Create support issue

> Create a new support ticket linked to a workflow or data change



## OpenAPI

````yaml post /v4/support/issues
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/support/issues:
    post:
      tags:
        - Support
      summary: Create a new support issue
      description: Creates a support ticket. User info is inferred from auth context.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - title
                - category
                - description
              properties:
                title:
                  type: string
                  description: Issue title
                category:
                  type: string
                  enum:
                    - bug
                    - feature
                    - workflow_issue
                    - template_issue
                    - integration
                    - billing
                    - data_diff
                priority:
                  type: number
                  enum:
                    - 0
                    - 1
                    - 2
                    - 3
                    - 4
                description:
                  type: string
                files:
                  type: array
                  description: >-
                    File attachments to include with the issue. Each file must
                    already be hosted at a publicly accessible URL.
                  items:
                    type: object
                    required:
                      - name
                      - url
                      - type
                      - size
                    properties:
                      name:
                        type: string
                        description: File name (e.g. screenshot.png)
                      url:
                        type: string
                        description: Publicly accessible URL of the file
                      type:
                        type: string
                        description: MIME type (e.g. image/png, application/pdf)
                      size:
                        type: number
                        description: File size in bytes
                workflowId:
                  type: string
                  description: Optional workflow ID to link the issue
                templateId:
                  type: string
                  format: uuid
                  description: >-
                    Optional template ID to link the issue. Only relevant when
                    category is template_issue.
                dataChangeId:
                  type: string
                  description: >-
                    ID of a data change from the Data Changes API (GET
                    /v4/changes). Links the support issue to a specific data
                    diff so the team can review the exact change being reported.
                    Only relevant when category is data_diff.
                subcategory:
                  type: string
                  enum:
                    - wrong_data
                    - missing_fields
                    - wrong_website
                    - scraper_broken
                    - other
                    - integration_slack
                    - integration_snowflake
                    - integration_cloud_storage
                    - integration_sdk
                    - integration_other
                  description: Optional subcategory for workflow or integration issues
      responses:
        '202':
          description: Issue creation accepted
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  issueId:
                    type: string
                    description: Local support request ID
                  supportRequestId:
                    type: string
                    description: Local support request ID
                  jobId:
                    type: string
                    description: Engine event job ID
                  status:
                    type: string
                    enum:
                      - accepted
        '409':
          description: The linked workflow already has an open support issue
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  supportRequestId:
                    type: string
                  issueId:
                    type: string
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key for authentication

````