> ## Documentation Index
> Fetch the complete documentation index at: https://io-migration.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Workflows Run



## OpenAPI

````yaml openapi/workflows-run.json post /api/v1/workflows/run
openapi: 3.1.0
info:
  title: IO Intelligence
  version: '1.0'
servers:
  - url: https://api.intelligence.io.solutions
security:
  - sec0: []
paths:
  /api/v1/workflows/run:
    post:
      summary: Workflows Run
      operationId: workflows-run
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - objective
                - agent_names
                - args
              properties:
                objective:
                  type: string
                  description: >-
                    The input text that will be analyzed, classified,
                    summarized, translated, or processed by AI agents.
                agent_names:
                  type: array
                  description: >-
                    A list of AI agents that will process the input text.
                    Available agents include reasoning, sentiment analysis,
                    classification, summarization, translation, and more.
                  items:
                    type: string
                args:
                  type: object
                  description: >-
                    Parameters required for a specific AI workflow. The
                    structure varies depending on the selected workflow.
                  required:
                    - type
                  properties:
                    type:
                      type: string
                      description: >-
                        This field determines which workflow-specific parameters
                        are required.
                    name:
                      type: string
                      description: Unique identifier for the custom workflow step.
                    instructions:
                      type: object
                      description: Any extra contextual information needed for processing.
                      properties: {}
                    classify_by:
                      type: array
                      description: >-
                        Defines the criteria used for classification (e.g.,
                        categories or labels).
                      items:
                        type: string
                    objective:
                      type: string
                      description: The main goal or intent of the workflow.
                    threshold:
                      type: integer
                      description: >-
                        Defines the sensitivity level for content moderation.
                        Higher values may filter out more content.
                      format: int32
                    target_language:
                      type: string
                      description: >-
                        The target language for translation (e.g., "fr" for
                        French).
                    max_words:
                      type: integer
                      description: >-
                        Maximum number of words allowed for summarization
                        (default: 100).
                      format: int32
                    context:
                      type: object
                      description: Additional parameters or metadata for processing.
                      properties: {}
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value:
                    result:
                      summary: >-
                        AI transforms businesses with automation, data-driven
                        insights, and enhanced decision-making. It improves
                        efficiency and customer experience.
                      key_points:
                        - AI in customer service
                        - AI-powered analytics
                        - Challenges with ethical concerns and data privacy
              schema:
                type: object
                properties:
                  result:
                    type: object
                    properties:
                      summary:
                        type: string
                        example: >-
                          AI transforms businesses with automation, data-driven
                          insights, and enhanced decision-making. It improves
                          efficiency and customer experience.
                      key_points:
                        type: array
                        items:
                          type: string
                          example: AI in customer service
        '404':
          description: '404'
          content:
            text/plain:
              examples:
                Result:
                  value: string
              schema:
                type: string
                example: string
        '422':
          description: '422'
          content:
            application/json:
              examples:
                Validation Error:
                  value:
                    detail:
                      - loc:
                          - string
                          - 0
                        msg: string
                        type: string
              schema:
                type: object
                properties:
                  detail:
                    type: array
                    items:
                      type: object
                      properties:
                        loc:
                          type: array
                        msg:
                          type: string
                          example: string
                        type:
                          type: string
                          example: string
      deprecated: false
      security: []
components:
  securitySchemes:
    sec0:
      type: oauth2
      flows: {}

````

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