| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
POST /assist-ai/regenerate/{assistant_id}
Retries processing for failed items in a Tutor AI. This is the "Try again" action available in the dashboard's knowledge base tab.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| assistant_id | path | string (UUID) | Yes | Tutor AI identifier. |
Request Body
Optional. When omitted, all eligible items are reprocessed. When provided, only the specified items are retried.
| Name | Type | Required | Description |
|---|---|---|---|
| items | array | No | List of items to retry. Each item has id (UUID) and type ("video" or "file"). |
// Retry everything eligible
POST /assist-ai/regenerate/{assistant_id}
(no body)
// Retry specific items
{
"items": [
{ "id": "{video_id}", "type": "video" },
{ "id": "{file_id}", "type": "file" }
]
}Which items can be retried
Only items with failure_reason of subtitle_error or provider_error are eligible. Items with no_speech cannot be retried (the result would be the same) - remove them from the Tutor instead.
The Tutor must be in ready or failed status.
Response
{
"assistant_id": "{assistant_id}",
"status": "processing",
"items": [
{ "id": "{video_id}", "type": "video", "status": "processing" },
{ "id": "{file_id}", "type": "file", "status": "processing" }
]
}Retrying may consume credits. If a failed video still has no subtitle in the Tutor AI language, the retry generates it and charges 1 credit per 5 minutes of video (free on Gold and Enterprise within the daily quota of 100 videos/day). Videos that already have a subtitle and files do not cost anything. The call does not ask for cost confirmation.
Errors
// 400 - assistant_id not UUID
{ "errCode": "BadRequest", "errMsg": "assistant_id must be a valid UUID" }
// 404 - Tutor not found
{ "errCode": "NotFound", "errMsg": "Assistant not found" }
// 400 - no eligible items (e.g. only no_speech items)
{ "errCode": "BadRequest", "errMsg": "No retryable items" }
// 400 - Tutor in wrong state (queued, processing, disabled, payment_failed)
{ "errCode": "BadRequest", "errMsg": "Assistant is not in a retryable state" }
// 400 - malformed body
{ "errCode": "BadRequest", "errMsg": "items must be a list of { id, type }" }
// 400 - insufficient credits for subtitle generation
{ "errCode": "BadRequest", "errMsg": "Insufficient credits" } 200Regeneration started
400Bad request or no retryable items
404Assistant not found
