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

# Retry a failed tool execution

> Retries a tool from a prior conversation. Creates a new brain_request with action_type='tool_retry' and starts a Temporal workflow with a forceTool directive. Enforces budget and rate limits.




## OpenAPI

````yaml /openapi/ai-brain.yaml post /brain/retry-tool
openapi: 3.1.0
info:
  title: Connie AI & Brain API
  version: 1.0.0
  description: >
    API for the AI & Brain module — the orchestration layer powering all AI
    features: the main conversational AI (Brain), AI chat conversations, browser
    automation tasks, agent identity management, and AI usage tracking.

    The Brain is the core AI engine. It accepts messages, orchestrates tool
    calls via Temporal workflows, and streams responses back. It powers the AI
    copilot across the entire product.
servers:
  - url: https://connie.ai/api
    description: Production
security:
  - cookieAuth: []
tags:
  - name: Brain
    description: Core AI engine — conversation, streaming, and workflow orchestration
  - name: Brain Plans
    description: Agent planning context (goal, steps, status)
  - name: AI Chat
    description: Persistent conversation and message management
  - name: AI Chat Attachments
    description: File uploads for AI context
  - name: Browser Tasks
    description: AI-driven browser automation tasks
  - name: Artifacts
    description: KB, table, and workflow artifacts attached to conversations
  - name: Agent Identities
    description: Named AI agent configuration and tool assignments
  - name: AI Cache
    description: FAQ response caching
  - name: AI Usage
    description: Token usage statistics
paths:
  /brain/retry-tool:
    post:
      tags:
        - Brain
      summary: Retry a failed tool execution
      description: >
        Retries a tool from a prior conversation. Creates a new brain_request
        with action_type='tool_retry' and starts a Temporal workflow with a
        forceTool directive. Enforces budget and rate limits.
      operationId: retryBrainTool
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - toolName
              properties:
                toolName:
                  type: string
                  maxLength: 200
                toolArgs:
                  type: object
                  description: Original tool arguments
                modifiedArgs:
                  type: object
                  description: Override tool args for retry (max 10KB JSON)
                originalRequestId:
                  type: string
                  format: uuid
                conversationId:
                  type: string
                workspaceId:
                  type: string
                  format: uuid
      responses:
        '202':
          description: Tool retry started
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  requestId:
                    type: string
                  channelId:
                    type: string
                  workflowId:
                    type: string
        '402':
          description: Insufficient credits
        '429':
          description: Rate limited
components:
  securitySchemes:
    cookieAuth:
      type: apiKey
      in: cookie
      name: session

````

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