Resume dispatch for a batch
curl --request POST \
--url https://api.getdialed.ai/v1/flows/batches/{batch_id}/resume \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.getdialed.ai/v1/flows/batches/{batch_id}/resume"
headers = {"X-API-Key": "<api-key>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.getdialed.ai/v1/flows/batches/{batch_id}/resume', 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.getdialed.ai/v1/flows/batches/{batch_id}/resume",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"X-API-Key: <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://api.getdialed.ai/v1/flows/batches/{batch_id}/resume"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.getdialed.ai/v1/flows/batches/{batch_id}/resume")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.getdialed.ai/v1/flows/batches/{batch_id}/resume")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body[
{
"cause": "admin_request",
"created_at": "2026-07-29T12:00:00Z",
"created_by": "user_11223344",
"expires_at": "2026-07-29T13:00:00Z",
"extensions": [],
"id": "pause_9f2c1a7b3d4e5f60",
"reason": "Provider maintenance window",
"scope": "global",
"status": "active"
}
]{
"detail": "Authentication required"
}{
"detail": "Admin role required"
}{
"detail": "Batch not found"
}{
"detail": "The request failed validation."
}{
"detail": "Rate limit exceeded: 100 per 1 minute"
}Batches
Resume dispatch for a batch
Admin only. Releases the batch’s active hold(s), clears the dispatcher’s skip flag on its queued work, and restores the batch to the status it held before the pause. Nothing is re-sent: work already dispatched stays dispatched, and dispatch picks up exactly where it stopped.
Idempotent: when nothing is held, an empty list comes back rather than an error. Releasing never deletes — each record survives with released_at and released_by completing its audit trail. Cross-tenant access returns 404, never 403.
POST
/
flows
/
batches
/
{batch_id}
/
resume
Resume dispatch for a batch
curl --request POST \
--url https://api.getdialed.ai/v1/flows/batches/{batch_id}/resume \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.getdialed.ai/v1/flows/batches/{batch_id}/resume"
headers = {"X-API-Key": "<api-key>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.getdialed.ai/v1/flows/batches/{batch_id}/resume', 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.getdialed.ai/v1/flows/batches/{batch_id}/resume",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"X-API-Key: <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://api.getdialed.ai/v1/flows/batches/{batch_id}/resume"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.getdialed.ai/v1/flows/batches/{batch_id}/resume")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.getdialed.ai/v1/flows/batches/{batch_id}/resume")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body[
{
"cause": "admin_request",
"created_at": "2026-07-29T12:00:00Z",
"created_by": "user_11223344",
"expires_at": "2026-07-29T13:00:00Z",
"extensions": [],
"id": "pause_9f2c1a7b3d4e5f60",
"reason": "Provider maintenance window",
"scope": "global",
"status": "active"
}
]{
"detail": "Authentication required"
}{
"detail": "Admin role required"
}{
"detail": "Batch not found"
}{
"detail": "The request failed validation."
}{
"detail": "Rate limit exceeded: 100 per 1 minute"
}Authorizations
APIKeyHeaderHTTPBearer
Path Parameters
Response
Successful Response