Regenerate Tutor AI

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

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

NameInTypeRequiredDescription
assistant_idpathstring (UUID)YesTutor AI identifier.

Request Body

Optional. When omitted, all eligible items are reprocessed. When provided, only the specified items are retried.

NameTypeRequiredDescription
itemsarrayNoList 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" }
Path Params
uuid
required
Body Params
items
array of objects
items
Responses
200

Regeneration started

400

Bad request or no retryable items

404

Assistant not found

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here!