List Agent Runs
curl --request GET \
--url https://api.example.com/agent/{agent_id}/runsimport requests
url = "https://api.example.com/agent/{agent_id}/runs"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.example.com/agent/{agent_id}/runs', 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://api.example.com/agent/{agent_id}/runs",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$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://api.example.com/agent/{agent_id}/runs"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/agent/{agent_id}/runs")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/agent/{agent_id}/runs")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_bodyAgent Runs
List Agent Runs
List recent runs for an agent with pagination and optional status/date filters.
GET
/
agent
/
{agent_id}
/
runs
List Agent Runs
curl --request GET \
--url https://api.example.com/agent/{agent_id}/runsimport requests
url = "https://api.example.com/agent/{agent_id}/runs"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.example.com/agent/{agent_id}/runs', 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://api.example.com/agent/{agent_id}/runs",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$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://api.example.com/agent/{agent_id}/runs"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/agent/{agent_id}/runs")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/agent/{agent_id}/runs")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_bodyLists recent runs for one agent.
Request
curl -X GET "https://api.mosaic.so/agent/[agent_id]/runs?limit=25&status=running,completed" \
-H "Authorization: Bearer mk_your_api_key"
Query Parameters
| Field | Type | Required | Description |
|---|---|---|---|
limit | number | No | Page size (1-100, default 25). |
cursor | string | No | Pagination cursor from next_cursor. |
status | string | No | Comma-separated statuses (for example: running,completed). |
from | string | No | ISO timestamp lower bound on created_at. |
to | string | No | ISO timestamp upper bound on created_at. |
Response
{
"runs": [
{
"run_id": "7f8d9c2b-4a6e-8b3f-1d5c-9e2f3a4b5c6d",
"agent_id": "123e4567-e89b-12d3-a456-789012345678",
"status": "completed",
"status_message": null,
"started_at": "2026-03-02T09:00:00Z",
"updated_at": "2026-03-02T09:06:00Z",
"node_status_counts": {
"completed": 10,
"in_progress": 0,
"failed": 0
},
"inputs": [],
"outputs": [
{
"id": "7ba7b810-9dad-11d1-80b4-00c04fd430c8",
"video_url": "https://storage.googleapis.com/mosaic-outputs/...",
"thumbnail_url": "https://storage.googleapis.com/mosaic-thumbnails/...",
"premiere_prproj_url": "https://storage.googleapis.com/mosaic-outputs/.../timeline.zip?...",
"completed_at": "2026-03-02T09:06:00Z",
"original_node_id": "2ba7b810-9dad-11d1-80b4-00c04fd430c8"
}
],
"triggered_by": null
}
],
"next_cursor": null
}
outputs[] uses the same shape as Get Agent Run, including premiere_prproj_url when a Premiere Pro timeline package is attached to the render and sources[] when the output contains source citations.
This summary response does not include needs_credits. To check whether a run is credit-blocked, call Get Agent Run (run-level) and/or Get Agent Run Nodes (node-level).Was this page helpful?
⌘I