curl -X POST 'https://api.poddata.ai/v1/diligence-reports/dlr_01JD9K4M5N6P00000000000000/runs' \
-H "Authorization: Bearer $PODDATA_API_KEY" \
-H 'Content-Type: application/json' \
-d '{}'import requests
url = "https://api.poddata.ai/v1/diligence-reports/{id}/runs"
payload = {}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({})
};
fetch('https://api.poddata.ai/v1/diligence-reports/{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.poddata.ai/v1/diligence-reports/{id}/runs",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.poddata.ai/v1/diligence-reports/{id}/runs"
payload := strings.NewReader("{}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
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.poddata.ai/v1/diligence-reports/{id}/runs")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.poddata.ai/v1/diligence-reports/{id}/runs")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{}"
response = http.request(request)
puts response.read_body{
"id": "drn_01JD9M7Q8R9S00000000000000",
"report": "dlr_01JD9K4M5N6P00000000000000",
"company": "northwind-dental",
"kind": "write",
"message": null,
"status": "queued",
"why": null,
"model": "claude-sonnet-5-5",
"playbook": "2",
"usd": 0,
"cap_usd": 5,
"turns": 0,
"agents": [],
"refusals": null,
"started_by": {
"via": "key",
"key": "key_01JD9H6J7K8M00000000000000"
},
"created_at": "2026-11-14T10:00:00.000Z",
"updated_at": "2026-11-14T10:00:00.000Z",
"ended_at": null
}{
"error": {
"code": "bad_request",
"message": "<string>"
}
}Starts PodData's agent on a report: a first draft, or with a message, a change that leaves the rest
Has PodData’s own agent write one of your reports, in the background over some minutes: an agent for each page still empty, then one for the overview, each reading PodData’s records through the tools an assistant has, then the report’s check. On a new report that’s every page; after a run that ended capped, the pages it left. A page that’s written or waits on a source is left as it is, and with nothing left the run only checks the report. With message, one agent makes that change and leaves the rest. 202 with the run, started_by naming your key.
Before: The report, from POST /diligence-reports, on one of your targets whose links and rivals a person has confirmed and PodData has read: GET /targets/{company}/coverage says when the read is done.
Next: Read the run with GET /diligence-runs/{id} every minute or so until its status is done, stopped, capped, refused or failed, then the report with GET /diligence-reports/{id}. One that ended capped says which pages are still empty: start another run with no message to write them.
Limits: PodData pays for its turns, up to the run’s cap_usd, $5, so ask the person first. One run of a report at a time: a second while one is going is a 409 naming it. No run starts while the target has a gap open, for it or a confirmed rival: no read asked, a read going or held by a day’s cap, a link or rival decided after its read, or one still proposed. That’s a 409 naming each gap and what fills it, with Retry-After when a cap holds the read. Runs a key or an assistant starts a UTC day: 0 on Free, 3 on Pro and Pilot, and 10 on Enterprise; past them a 429 with Retry-After at midnight UTC, and on a plan that starts none a 403. A run started in the workspace isn’t counted.
curl -X POST 'https://api.poddata.ai/v1/diligence-reports/dlr_01JD9K4M5N6P00000000000000/runs' \
-H "Authorization: Bearer $PODDATA_API_KEY" \
-H 'Content-Type: application/json' \
-d '{}'import requests
url = "https://api.poddata.ai/v1/diligence-reports/{id}/runs"
payload = {}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({})
};
fetch('https://api.poddata.ai/v1/diligence-reports/{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.poddata.ai/v1/diligence-reports/{id}/runs",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.poddata.ai/v1/diligence-reports/{id}/runs"
payload := strings.NewReader("{}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
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.poddata.ai/v1/diligence-reports/{id}/runs")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.poddata.ai/v1/diligence-reports/{id}/runs")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{}"
response = http.request(request)
puts response.read_body{
"id": "drn_01JD9M7Q8R9S00000000000000",
"report": "dlr_01JD9K4M5N6P00000000000000",
"company": "northwind-dental",
"kind": "write",
"message": null,
"status": "queued",
"why": null,
"model": "claude-sonnet-5-5",
"playbook": "2",
"usd": 0,
"cap_usd": 5,
"turns": 0,
"agents": [],
"refusals": null,
"started_by": {
"via": "key",
"key": "key_01JD9H6J7K8M00000000000000"
},
"created_at": "2026-11-14T10:00:00.000Z",
"updated_at": "2026-11-14T10:00:00.000Z",
"ended_at": null
}{
"error": {
"code": "bad_request",
"message": "<string>"
}
}start_report_run, on PodData’s MCP server at https://api.poddata.ai/mcp, does what this route does, with the same key. See The MCP server.Authorizations
Body
Response
Started: it runs in the background. Read it with GET /v1/diligence-runs/{id}