Get Task Status - Memories.ai API Tools

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
}

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)

This endpoint returns the current status of a screenplay extraction task, including progress information for running tasks and error details for failed tasks.

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 progress field is only available when the task is in "running" status

Authorizations

Authorization

string

header

required

API key for authentication

Path Parameters

task_id

string

required

The screenplay task ID

Example:

"ros-sd-20260313-a3f8c2b1"

Response

200 - application/json

Task status retrieved successfully

code

integer

Response code indicating the result status

Example:

200

msg

string

Response message

Example:

"success"

data

object

Show child attributes

success

boolean

Indicates whether the API call was successful

Example:

true

failed

boolean

Indicates whether the API call failed

Example:

false

Submit Screenplay Task Cancel Task

​Code Examples

​Path Parameters

​Response

​Response Parameters

​Task Status Values

​Notes

Authorizations

Path Parameters

Response

Code Examples

Path Parameters

Response

Response Parameters

Task Status Values

Notes