List all Tutors (paginated)

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

GET /assist-ai/get_all

Returns a paginated list of Tutor AIs with filters and per-item status. This is the endpoint the dashboard uses.

Query Parameters

NameTypeRequiredDefaultDescription
pageintegerNo1Page number (starts at 1).
limitintegerNo20Items per page. Maximum 50 (higher values are silently capped).
statusstringNo-Filter by status. Accepts one or more values separated by comma: ready, failed, disabled, processing, queued, payment_failed.
searchstringNo-Search by Tutor name (case-insensitive, up to 100 characters).
video_idstring (UUID)No-Returns the Tutor that contains this video.
GET /assist-ai/get_all?page=1&limit=20&status=failed

Response

{
  "items": [
    {
      "id": "{assistant_id}",
      "name": "Curso de Financas",
      "status": "failed",
      "lang": "pt-BR",
      "initial_question": "Como posso te ajudar hoje?",
      "question_suggestions": true,
      "open_new_tab": false,
      "show_watch_video_button": true,
      "videos_count": 2,
      "video_ids": ["{video_id_1}", "{video_id_2}"],
      "files_count": 0,
      "answers_count": 0,
      "updating": false,
      "suggestions": [
        "Como evitar que legendas aparecam durante gravacoes?",
        "Quais sao os desafios do uso de legendas?"
      ],
      "failure_reason": "provider_error",
      "items": [
        { "id": "{video_id_1}", "type": "video", "status": "success", "failure_reason": null },
        { "id": "{video_id_2}", "type": "video", "status": "failed",
          "failure_reason": "provider_error", "title": "Aula 02.mkv" }
      ],
      "has_processing_items": false
    }
  ],
  "page": 1,
  "limit": 20,
  "total": 3
}
FieldTypeDescription
items[].statusstringTutor status: queued, processing, ready, failed, disabled, payment_failed.
items[].failure_reasonstring or nullTutor-level failure reason. null when the Tutor is not in a failure state.
items[].show_watch_video_buttonbooleanWhether the "Watch video" button appears in chat answers.
items[].videos_countintegerNumber of videos bound to the Tutor.
items[].files_countintegerNumber of files in the knowledge base.
items[].answers_countintegerTotal chat answers delivered.
items[].updatingbooleantrue when the Tutor was previously ready and is reprocessing items.
items[].items[].statusstringPer-item status: processing, success, failed, trashed (video in trash).
items[].items[].failure_reasonstring or nullPer-item failure reason: no_speech, subtitle_error, provider_error, insufficient_credits, or null.
items[].items[].titlestringOnly present on items with failed or trashed status.
pageintegerCurrent page.
limitintegerEffective limit (capped at 50).
totalintegerTotal number of Tutors matching the filters. There is no pages field; calculate from total and limit.

Trashed items. A video in the trash appears as status: "trashed" with deleted_at and days_left (up to 30 days). The video still answers in the chat until it is permanently deleted.

updating: true means the Tutor was previously ready and is reprocessing something (e.g. after a regenerate call). It remains functional during the update.

Order: most recently created first. Deleted Tutors never appear.

Errors

// 400 - invalid status filter
{ "errCode": "InvalidStatus", "errMsg": "Invalid status" }

// 400 - video_id not UUID
{ "errCode": "BadRequest", "errMsg": "video_id must be a valid UUID" }
Query Params
integer
Defaults to 1
integer
≤ 50
Defaults to 20
string
uuid
Responses
200

Paginated list of Tutors

400

Invalid status or video_id format

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