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

# Generate tool inputs from natural language (DEPRECATED)

> DEPRECATED: This endpoint is no longer maintained. It still works for existing integrations but may be removed in a future release. To build tool arguments, fetch the tool's input schema with `GET /api/v3/tools/{tool_slug}` and generate the arguments in your own application. Uses AI to translate a natural language description into structured arguments for a specific tool.



## OpenAPI

````yaml api-reference/openapi-v3.json POST /api/v3/tools/execute/{tool_slug}/input
openapi: 3.0.0
info:
  version: 3.0.0
  title: Composio Platform API
  description: >-
    Composio v3 API — legacy endpoints under /api/v3/. Use v3.1 for new
    integrations.
  contact:
    name: Composio Support
    url: https://composio.dev/support
    email: support@composio.dev
  license:
    name: Proprietary
    url: https://composio.dev/terms
servers:
  - url: https://backend.composio.dev
    description: Composio production API
security:
  - ApiKeyAuth: []
tags:
  - name: Authentication
    description: Authentication related endpoints
    x-group: Authentication
  - name: Auth Configs
    description: Authentication configuration management
    x-group: Auth Configs
  - name: Connected Accounts
    description: Connected account management
    x-group: Connected Accounts
  - name: Logs
    description: Logging and monitoring
    x-group: Logs
  - name: OpenAPI
    description: OpenAPI specification management
    x-group: OpenAPI
  - name: Organization
    description: Organization management
    x-group: Organization
  - name: API Keys
    description: API key management
    x-group: API Keys
  - name: Webhooks
    description: Webhook configuration
    x-group: Webhooks
  - name: Webhook Endpoints
    description: >-
      Per-OAuth-app webhook ingress endpoints. Inbound URLs the provider posts
      to, plus signing secret storage and verification.
    x-group: Webhook Endpoints
  - name: Webhook Subscriptions
    description: >-
      Webhook delivery subscriptions. Outbound URLs Composio posts trigger
      events to, plus signing secret rotation and event-type filters.
    x-group: Webhook Subscriptions
  - name: Team
    description: Team member management
    x-group: Team
  - name: Consumer Skills
    description: Organization-authored Skill management
    x-group: Consumer Skills
  - name: Toolkits
    description: Toolkit and tool management
    x-group: Toolkits
  - name: Tools
    description: Tool execution endpoints
    x-group: Tools
  - name: Triggers
    description: Trigger management and execution
    x-group: Triggers
  - name: Payments
    description: Payment and subscription management
    x-group: Payments
  - name: Billing
    description: Dashboard billing state — usage, subscription, contract (cookie-auth only)
    x-group: Billing
  - name: Compliance
    description: Organization compliance agreements and acceptance state
    x-group: Compliance
  - name: Files
    description: File management
    x-group: Files
  - name: MCP
    description: MCP server management
    x-group: MCP
  - name: MCP Partner
    description: MCP partner management
    x-group: MCP Partner
  - name: Stripe Projects
    description: Stripe Projects provisioning
    x-group: Stripe Projects
  - name: Tool Router
    description: (Labs) Tool router endpoints
    x-group: Sessions (Prev Tool Router)
  - name: Playground
    description: Dashboard playground chat
    x-group: Playground
  - name: Arena
    description: Arena conversations, messages and terms
    x-group: Arena
  - name: Organization Management
    description: Organization Management API endpoints.
    x-group: Organization Management
  - name: Projects
    description: Projects API endpoints.
    x-group: Projects
paths:
  /api/v3/tools/execute/{tool_slug}/input:
    post:
      tags:
        - Tools
      summary: Generate tool inputs from natural language (DEPRECATED)
      description: >-
        DEPRECATED: This endpoint is no longer maintained. It still works for
        existing integrations but may be removed in a future release. To build
        tool arguments, fetch the tool's input schema with `GET
        /api/v3/tools/{tool_slug}` and generate the arguments in your own
        application. Uses AI to translate a natural language description into
        structured arguments for a specific tool.
      operationId: postToolsExecuteByToolSlugInput
      parameters:
        - schema:
            type: string
          required: true
          description: The tool slug to generate inputs for
          name: tool_slug
          in: path
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                text:
                  type: string
                  description: >-
                    Natural language description of what you want to accomplish
                    with this tool
                  example: >-
                    I need to trigger the main workflow in the
                    octocat/Hello-World repository to deploy to production
                custom_description:
                  type: string
                  description: >-
                    Custom description of the tool to help guide the LLM in
                    generating more accurate inputs
                  example: >-
                    This tool triggers GitHub Actions workflows in a repository.
                    It requires the repository name, workflow ID, and optional
                    input parameters.
                system_prompt:
                  type: string
                  description: >-
                    System prompt to control and guide the behavior of the LLM
                    when generating inputs
                  example: >-
                    You are an expert assistant that generates precise GitHub
                    Actions workflow parameters. Extract exact repository names,
                    workflow IDs, and input values from user descriptions.
                version:
                  type: string
                  description: >-
                    Tool version to use when generating inputs. Defaults to the
                    pinned version ("00000000_00") when omitted.
                  example: latest
              required:
                - text
      responses:
        '200':
          description: >-
            Successfully generated structured inputs for the action based on
            natural language description
          content:
            application/json:
              schema:
                type: object
                properties:
                  arguments:
                    type: object
                    additionalProperties: {}
                    description: >-
                      Key-value pairs of arguments required by the tool to
                      accomplish the described task
                    example:
                      repository: octocat/Hello-World
                      workflow_id: main.yml
                      ref: main
                      inputs:
                        environment: production
                  error:
                    type: string
                    description: >-
                      Error message if the arguments could not be generated
                      (null if successful)
                    example: >-
                      Unable to determine the repository name from the provided
                      description
        '400':
          description: >-
            Bad request - Invalid input parameters or insufficient description
            to generate tool arguments
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Unauthorized - Authentication credentials are missing or invalid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Not found - The specified tool does not exist
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: Unprocessable entity - Invalid state of the connected account
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: >-
            Too many requests - Rate limit exceeded for natural language
            processing
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: >-
            Internal server error - AI processing failed or other server error
            occurred
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      deprecated: true
      security:
        - ApiKeyAuth: []
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
            code:
              type: number
            slug:
              type: string
            status:
              type: number
            request_id:
              type: string
            suggested_fix:
              type: string
            errors:
              type: array
              items:
                type: string
          required:
            - message
            - code
            - slug
            - status
      required:
        - error
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Your Composio project API key. Create or copy it from the Composio
        dashboard.
      x-default: your-project-api-key

````