Cancel Task
curl --request DELETE \
--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.delete(url, headers=headers)
print(response.text)const options = {method: 'DELETE', 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 => "DELETE",
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("DELETE", 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.delete("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::Delete.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": "cancelled"
},
"failed": false,
"success": true
}
Screenplay Extraction
Cancel Task
Cancel a running screenplay extraction task
DELETE
/
screenplay
/
tasks
/
{task_id}
Cancel Task
curl --request DELETE \
--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.delete(url, headers=headers)
print(response.text)const options = {method: 'DELETE', 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 => "DELETE",
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("DELETE", 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.delete("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::Delete.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": "cancelled"
},
"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: 'DELETE',
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.delete(`${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 cancel_screenplay_task(task_id):
url = f"{BASE_URL}/screenplay/tasks/{task_id}"
response = requests.delete(url, headers=HEADERS)
return response.json()
# Usage example
result = cancel_screenplay_task("ros-sd-20260313-a3f8c2b1")
print(result)
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| task_id | string | Yes | The screenplay task ID to cancel |
Response
{
"code": 200,
"msg": "success",
"data": {
"task_id": "ros-sd-20260313-a3f8c2b1",
"status": "cancelled"
},
"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 cancelled task ID |
| data.status | string | Task status: "cancelled" |
| success | boolean | Indicates whether the cancellation was successful |
| failed | boolean | Indicates whether the cancellation failed |
Notes
- Only tasks in
pendingorrunningstatus can be cancelled - Cancellation is irreversible — a cancelled task cannot be resumed
- The processing cost charged at submission time is not refunded upon cancellation
- After cancellation, Get Task Status will return
"cancelled"status
Authorizations
API key for authentication
Path Parameters
The screenplay task ID to cancel
Example:
"ros-sd-20260313-a3f8c2b1"
Response
200 - application/json
Task cancelled successfully
