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

# AI Conversation Summary Request

> This API requests asynchronous AI-powered summarization of customer-agent conversations. The generated AI summary comes in the desired language specified in the request (automated translation), with the option to direct the output as a webhook.

Request Body Parameters:
- **Text** (mandatory) with the object's content
- **Language** (mandatory) with the desired language of the output
- **Callback_url** (optional) with the Webhook URL destination of the summary

**Note:** AI summaries are available for 12 hours, after which they are deleted from the cache and the action_ids become invalid. Conversation text must be at least 150 characters.

## OpenAPI

````json POST /ai-services/summary_conversation
{
  "openapi": "3.0.3",
  "info": {
    "title": "CommBox API",
    "x-logo": {
      "url": "https://www.commbox.io/logo/commbox_logo_large.png"
    },
    "version": "2.07",
    "termsOfService": "https://www.commbox.io/end-user-license-agreement-eula/",
    "contact": {
      "name": "commbox",
      "url": "https://www.commbox.io",
      "email": "contactus@commbox.io"
    }
  },
  "servers": [
    {
      "url": "https://api.commbox.io/",
      "description": "Production server"
    }
  ],
  "paths": {
    "/ai-services/summary_conversation": {
      "post": {
        "tags": [
          "AI Services"
        ],
        "summary": "AI Conversation Summary Request",
        "description": "This API requests asynchronous AI-powered summarization of customer-agent conversations. The generated AI summary comes in the desired language specified in the request (automated translation), with the option to direct the output as a webhook.\n\nRequest Body Parameters:\n- **Text** (mandatory) with the object's content\n- **Language** (mandatory) with the desired language of the output\n- **Callback_url** (optional) with the Webhook URL destination of the summary\n\n**Note:** AI summaries are available for 12 hours, after which they are deleted from the cache and the action_ids become invalid. Conversation text must be at least 150 characters.",
        "operationId": "Summary_conversation_request",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "text",
                  "language"
                ],
                "properties": {
                  "text": {
                    "type": "string",
                    "description": "The content of the object (conversation for summary)",
                    "example": "Agent: Good morning! Welcome to First National Bank. How can I help you today? Customer: Hi, I'm having a couple of issues..."
                  },
                  "language": {
                    "type": "string",
                    "description": "Language of the output",
                    "example": "english"
                  },
                  "callback_url": {
                    "type": "string",
                    "description": "Webhook URL destination of the summary",
                    "example": "https://webhook.site/0088b4fa-3b8b-4e00-b3e4-35353ea79b45"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Summary generated successfully",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "description": "The request status for the AI conversation summary",
                      "example": "Initialized"
                    },
                    "answer": {
                      "type": "string",
                      "description": "Conversation summary. Empty object (populated when completed)",
                      "example": null
                    },
                    "action_id": {
                      "type": "string",
                      "description": "Unique identifier for tracking this request",
                      "example": "AI_API_SUMMARY_2f6995be-d52b-484b-9bae-2578227caf58"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request - invalid input parameters",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string",
                      "example": "Invalid language parameter or Text too short"
                    },
                    "status": {
                      "type": "integer",
                      "example": 400
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string",
                      "example": "true"
                    },
                    "message": {
                      "type": "string",
                      "example": "Invalid or missing authentication token"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "integer",
                      "example": 404
                    },
                    "description": {
                      "type": "string",
                      "example": "Not found"
                    },
                    "response_time": {
                      "type": "string",
                      "format": "date-time",
                      "example": "2025-12-14T07:26:35.9759271Z"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string",
                      "example": "Internal server error occurred"
                    },
                    "status": {
                      "type": "integer",
                      "example": 500
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
````