twelvelabs-io Check Video Indexing Status
Check the status of video indexing tasks to see if videos are ready for search and analysis.
When to Use This Skill
Use this skill when the user:
- Asks if their video is ready ("is my video ready?", "can I search my video yet?")
- Wants to know indexing progress ("how long until it's done?", "what's the status?")
- Asks about a pending indexing task ("is it still processing?")
- Wants to check on a specific task ("check task xyz")
Instructions
Step 1: Determine What to Check
Based on the user's request:
- Specific task mentioned: Check that specific task ID
- General status question: Check all recent/pending tasks
Step 2: Call the MCP Tool
Use the mcp__twelvelabs-mcp__get-video-indexing-tasks tool:
For a specific task:
Tool: mcp__twelvelabs-mcp__get-video-indexing-tasks
Parameters:
taskId: "<task-id>"
For all recent tasks (no specific task mentioned):
Tool: mcp__twelvelabs-mcp__get-video-indexing-tasks
Parameters: (none - returns latest 10 tasks)
Step 3: Interpret Status Values
Tasks progress through these statuses:
| Status | Meaning | User-Friendly Message |
|---|---|---|
validating |
Video uploaded, being validated | "Your video is being validated..." |
pending |
Waiting for processing server | "Your video is queued for processing..." |
queued |
Server assigned, preparing | "Processing is about to start..." |
indexing |
Converting to searchable format | "Your video is being indexed..." |
ready |
Complete! | "Your video is ready!" |
failed |
Something went wrong | "Indexing failed. Please try again." |
Step 4: Display Results
For a single task (ready):
Your video is ready!
Task ID: <task-id>
Video ID: <video-id>
Status: Ready
You can now:
- Search the video: "find the part where..."
- Analyze it: "summarize this video" or "create chapters"
For a single task (in progress):
Your video is still processing.
Task ID: <task-id>
Status: <status>
<User-friendly status message from table above>
Check back in a few minutes.
For a single task (failed):
Indexing failed.
Task ID: <task-id>
Status: Failed
Error: <error message if available>
This might happen if:
- The video is too short (minimum 4 seconds)
- The video format is not supported
- The URL is not accessible
Please try indexing again with a different video or check the source.
For multiple tasks:
Indexing Task Status
| Status | Source | Task ID |
|--------|--------|---------|
| Ready | demo.mp4 | abc123 |
| Indexing | meeting.mp4 | def456 |
| Queued | tutorial.mp4 | ghi789 |
Ready videos can be searched and analyzed.
In-progress videos will be available soon.
No tasks found:
No indexing tasks found.
To index a video, just say:
"Index this video: <path-or-url>"
Example Interactions
User: "Is my video ready?" Action: Call get-video-indexing-tasks (no params) → show status of recent tasks
User: "Is my video ready yet? I uploaded it 5 minutes ago" Action: Call get-video-indexing-tasks → show status with context that indexing takes time
User: "Check status of task abc123" Action: Call get-video-indexing-tasks with taskId: "abc123"
User: "Can I search my demo.mp4 now?" Action: Call get-video-indexing-tasks → find the task for demo.mp4 → report status
Important Notes
- Processing Time: Indexing typically takes several minutes depending on video length
- Async Nature: Indexing happens in the background - users can check back anytime
- Ready for Use: Only videos with "ready" status can be searched and analyzed
- Failed Tasks: Suggest re-indexing with a different video or checking the source