Get Task Status
curl --request GET \
--url https://mavi-backend.memories.ai/serve/api/v2/screenplay/tasks/{task_id} \
--header 'Authorization: <api-key>'import requests
url = "https://mavi-backend.memories.ai/serve/api/v2/screenplay/tasks/{task_id}"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://mavi-backend.memories.ai/serve/api/v2/screenplay/tasks/{task_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://mavi-backend.memories.ai/serve/api/v2/screenplay/tasks/{task_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://mavi-backend.memories.ai/serve/api/v2/screenplay/tasks/{task_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://mavi-backend.memories.ai/serve/api/v2/screenplay/tasks/{task_id}")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://mavi-backend.memories.ai/serve/api/v2/screenplay/tasks/{task_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"code": 200,
"msg": "success",
"data": {
"task_id": "ros-sd-20260313-a3f8c2b1",
"status": "running",
"progress": {
"total_episodes": 87,
"completed_episodes": 12
}
},
"failed": false,
"success": true
}
{
"code": 200,
"msg": "success",
"data": {
"task_id": "ros-sd-20260313-a3f8c2b1",
"status": "completed"
},
"failed": false,
"success": true
}
{
"code": 200,
"msg": "success",
"data": {
"task_id": "ros-sd-20260313-a3f8c2b1",
"status": "failed",
"error_code": "PROCESSING_FAILED",
"error_message": "Episode 3 processing failed: episode-pipeline ep3 failed: ..."
},
"failed": false,
"success": true
}
Screenplay Extraction
Get Task Status
Query the current status and progress of a screenplay extraction task
GET
/
screenplay
/
tasks
/
{task_id}
Get Task Status
curl --request GET \
--url https://mavi-backend.memories.ai/serve/api/v2/screenplay/tasks/{task_id} \
--header 'Authorization: <api-key>'import requests
url = "https://mavi-backend.memories.ai/serve/api/v2/screenplay/tasks/{task_id}"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://mavi-backend.memories.ai/serve/api/v2/screenplay/tasks/{task_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://mavi-backend.memories.ai/serve/api/v2/screenplay/tasks/{task_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://mavi-backend.memories.ai/serve/api/v2/screenplay/tasks/{task_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://mavi-backend.memories.ai/serve/api/v2/screenplay/tasks/{task_id}")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://mavi-backend.memories.ai/serve/api/v2/screenplay/tasks/{task_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"code": 200,
"msg": "success",
"data": {
"task_id": "ros-sd-20260313-a3f8c2b1",
"status": "running",
"progress": {
"total_episodes": 87,
"completed_episodes": 12
}
},
"failed": false,
"success": true
}
{
"code": 200,
"msg": "success",
"data": {
"task_id": "ros-sd-20260313-a3f8c2b1",
"status": "completed"
},
"failed": false,
"success": true
}
{
"code": 200,
"msg": "success",
"data": {
"task_id": "ros-sd-20260313-a3f8c2b1",
"status": "failed",
"error_code": "PROCESSING_FAILED",
"error_message": "Episode 3 processing failed: episode-pipeline ep3 failed: ..."
},
"failed": false,
"success": true
}
Product: Visual Agents
Use case: Managed endpoints powering Memories.ai’s open-source video search and editing agents (queries, video clipping/editing, screenplay extraction)
Host:
https://mavi-backend.memories.ai/serve/api/v2
Auth: Authorization: sk-mavi-... (no Bearer prefix)Code Examples
const BASE_URL = "https://mavi-backend.memories.ai/serve/api/v2";
const API_KEY = "sk-mavi-...";
const taskId = "ros-sd-20260313-a3f8c2b1";
const response = await fetch(`${BASE_URL}/screenplay/tasks/${taskId}`, {
method: 'GET',
headers: {
'Authorization': API_KEY
}
});
const data = await response.json();
console.log(data);
import axios from 'axios';
const BASE_URL = "https://mavi-backend.memories.ai/serve/api/v2";
const API_KEY = "sk-mavi-...";
const taskId = "ros-sd-20260313-a3f8c2b1";
const response = await axios.get(`${BASE_URL}/screenplay/tasks/${taskId}`, {
headers: {
'Authorization': API_KEY
}
});
console.log(response.data);
import requests
BASE_URL = "https://mavi-backend.memories.ai/serve/api/v2"
API_KEY = "sk-mavi-..."
HEADERS = {
"Authorization": f"{API_KEY}"
}
def get_screenplay_task_status(task_id):
url = f"{BASE_URL}/screenplay/tasks/{task_id}"
response = requests.get(url, headers=HEADERS)
return response.json()
# Usage example
result = get_screenplay_task_status("ros-sd-20260313-a3f8c2b1")
print(result)
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| task_id | string | Yes | The screenplay task ID returned from the Submit Task endpoint |
Response
{
"code": 200,
"msg": "success",
"data": {
"task_id": "ros-sd-20260313-a3f8c2b1",
"status": "running",
"progress": {
"total_episodes": 87,
"completed_episodes": 12
}
},
"failed": false,
"success": true
}
{
"code": 200,
"msg": "success",
"data": {
"task_id": "ros-sd-20260313-a3f8c2b1",
"status": "completed"
},
"failed": false,
"success": true
}
{
"code": 200,
"msg": "success",
"data": {
"task_id": "ros-sd-20260313-a3f8c2b1",
"status": "failed",
"error_code": "PROCESSING_FAILED",
"error_message": "Episode 3 processing failed: episode-pipeline ep3 failed: ..."
},
"failed": false,
"success": true
}
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | integer | Response code indicating the result status |
| msg | string | Response message |
| data.task_id | string | The screenplay task ID |
| data.status | string | Current task status (see status values below) |
| data.progress | object | Progress information (only present when status is "running") |
| data.progress.total_episodes | integer | Total number of episodes to process |
| data.progress.completed_episodes | integer | Number of episodes completed so far |
| data.error_code | string | Error code (only present when status is "failed") |
| data.error_message | string | Detailed error message (only present when status is "failed") |
| success | boolean | Indicates whether the API call was successful |
| failed | boolean | Indicates whether the API call failed |
Task Status Values
| Status | Description |
|---|---|
pending | Task has been submitted and is waiting to be processed |
running | Task is currently being processed, check progress for details |
completed | Task has finished successfully, use Download Task Result to get the output files |
failed | Task has failed, check error_code and error_message for details |
cancelled | Task has been cancelled via Cancel Task |
Notes
- Poll this endpoint to track progress of long-running tasks
- When status is
"completed", use the Download Task Result endpoint to download the output files - The
progressfield is only available when the task is in"running"status
Authorizations
API key for authentication
Path Parameters
The screenplay task ID
Example:
"ros-sd-20260313-a3f8c2b1"
Response
200 - application/json
Task status retrieved successfully
⌘I
