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

# Update workflow metadata



## OpenAPI

````yaml put /v4/workflows/{workflowId}/metadata
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}/metadata:
    put:
      tags:
        - Workflows
      summary: Update workflow metadata
      parameters:
        - name: workflowId
          in: path
          required: true
          description: ID of the workflow to update
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                urls:
                  type: array
                  description: List of target URLs for the workflow
                  items:
                    type: string
                limit:
                  type: integer
                  description: The new limit for the workflow
                updateInterval:
                  type: string
                  description: The new update interval for the workflow
                  enum:
                    - ONLY_ONCE
                    - HOURLY
                    - DAILY
                    - WEEKLY
                    - MONTHLY
                    - CUSTOM
                schedules:
                  type: array
                  items:
                    type: string
                  description: Array of cron expressions for the workflow schedule
                name:
                  type: string
                  description: The new name for the workflow
                description:
                  type: string
                  description: The new description for the workflow
                tags:
                  type: array
                  items:
                    type: string
                  description: The tags for the workflow
                  example:
                    - tag1
                    - tag2
                location:
                  type: object
                  description: The new location for the workflow
                  properties:
                    type:
                      type: string
                      enum:
                        - auto
                        - manual
                      description: Type of location selection
                    isoCode:
                      type: string
                      description: ISO code of the country (required when type is manual)
                monitoring:
                  type: object
                  description: The monitoring config for the workflow
                  properties:
                    fields:
                      type: array
                      items:
                        type: object
                        properties:
                          fieldName:
                            type: string
                            description: The name of the field to monitor
                          operator:
                            type: string
                            enum:
                              - changed
                              - added
                              - removed
                            description: The operator to use for monitoring
                    conditions:
                      type: object
                      description: The conditions for monitoring
                      properties:
                        logicalOperator:
                          type: string
                          enum:
                            - AND
                            - OR
                          description: The logical operator to use for conditions
                        conditions:
                          type: array
                          items:
                            type: object
                            properties:
                              type:
                                type: string
                                enum:
                                  - SINGLE
                                  - ANY
                                description: Type of condition
                              field:
                                type: string
                                description: Field name (required for SINGLE type)
                              operator:
                                type: string
                                description: Condition operator
                              value:
                                type: string
                                description: Value to compare against
                entity:
                  type: string
                  description: The new entity for the workflow
                  example: job_posting
                schema:
                  type: array
                  description: The new extraction schema for the workflow
                  items:
                    type: object
                    properties:
                      name:
                        type: string
                      description:
                        type: string
                      example:
                        type: string
                      dataType:
                        type: string
                        enum:
                          - STRING
                          - NUMBER
                          - BOOLEAN
                          - DATE
                          - DATETIME
                          - MONEY
                          - IMAGE
                          - LINK
                          - OBJECT
                          - ARRAY
                      isPrimaryKey:
                        type: boolean
                      isRequired:
                        type: boolean
                      isUnique:
                        type: boolean
                additionalData:
                  type: object
                  description: Additional static data for the workflow
                userPrompt:
                  type: string
                  minLength: 10
                  maxLength: 5000
                  description: Natural language instructions for the workflow.
      responses:
        '200':
          description: Workflow metadata updated successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
        '400':
          description: Bad request (invalid input)
        '401':
          description: Unauthorized
        '404':
          description: Workflow not found
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key for authentication

````