Cancel Task - Memories.ai API Tools

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
}

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)

This endpoint cancels an in-progress screenplay extraction task. Once cancelled, the task cannot be resumed.

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 pending or running status 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

Authorization

string

header

required

API key for authentication

Path Parameters

task_id

string

required

The screenplay task ID to cancel

Example:

"ros-sd-20260313-a3f8c2b1"

Response

200 - application/json

Task cancelled 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 cancellation was successful

Example:

true

failed

boolean

Indicates whether the cancellation failed

Example:

false

Get Task Status Download Task Result

​Code Examples

​Path Parameters

​Response

​Response Parameters

​Notes

Authorizations

Path Parameters

Response

Code Examples

Path Parameters

Response

Response Parameters

Notes