curl --request GET \
--url https://plainrouter.com/api/v1/agent/workspaces/{workspace}/actions \
--header 'Authorization: Bearer <token>'import requests
url = "https://plainrouter.com/api/v1/agent/workspaces/{workspace}/actions"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://plainrouter.com/api/v1/agent/workspaces/{workspace}/actions', 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://plainrouter.com/api/v1/agent/workspaces/{workspace}/actions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$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://plainrouter.com/api/v1/agent/workspaces/{workspace}/actions"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://plainrouter.com/api/v1/agent/workspaces/{workspace}/actions")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://plainrouter.com/api/v1/agent/workspaces/{workspace}/actions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"id": "<string>",
"batch_id": "<string>",
"workspace_id": 123,
"type": "increase_budget",
"target_entity_type": "<string>",
"target_entity_id": "<string>",
"target_entity_name": "<string>",
"params": {},
"rationale": "<string>",
"status": "pending",
"batch_status": "pending",
"disposition": {
"receipt_status": "pending",
"outcome_payload": {
"status": "measurable",
"observed_at": "2023-11-07T05:31:56Z",
"reason_code": "<string>",
"reason": "<string>",
"baseline": {
"scope": "target",
"days": [
"2023-12-25"
],
"currency": "<string>",
"timezone": "<string>",
"spend_minor": "<string>",
"counted_arrivals": 123,
"cost_per_counted_arrival_minor": "<string>"
},
"metrics": {
"scope": "target",
"days": [
"2023-12-25"
],
"currency": "<string>",
"timezone": "<string>",
"spend_minor": "<string>",
"counted_arrivals": 123,
"cost_per_counted_arrival_minor": "<string>",
"verdict": "held",
"loss_threshold_percent": "<string>"
},
"inverse": {
"status": "proposed",
"batch_id": "<string>",
"reason_code": "<string>"
}
},
"outcome_status": "measurable",
"outcome_reason_code": "<string>",
"outcome_checked_at": "2023-11-07T05:31:56Z",
"compensation_reason_code": "<string>",
"recovery_disposition": "no_compensation",
"late_restored": true
},
"policy_decision": "allow",
"policy_reasons": [
"<string>"
],
"policy_result": {
"id": "<string>",
"policy_id": "<string>",
"policy_version": 123,
"phase": "proposal",
"outcome": "allowed",
"reasons": [
"<string>"
],
"reason_details": [
"<string>"
],
"requested_minor": 123,
"evaluated_at": "2023-11-07T05:31:56Z"
},
"policy_results": [
{
"id": "<string>",
"policy_id": "<string>",
"policy_version": 123,
"phase": "proposal",
"outcome": "allowed",
"reasons": [
"<string>"
],
"reason_details": [
"<string>"
],
"requested_minor": 123,
"evaluated_at": "2023-11-07T05:31:56Z"
}
],
"automation_context": {},
"copy_result": {
"source_root_id": "<string>",
"new_root_id": "<string>",
"id_map": [
{
"level": "campaign",
"source_id": "<string>",
"copied_id": "<string>"
}
],
"expected_counts": {
"campaign": 123,
"ad_set": 123,
"ad": 123
},
"observed_counts": {
"campaign": 123,
"ad_set": 123,
"ad": 123
},
"objects": [
{
"level": "campaign",
"id": "<string>",
"configured_status": "PAUSED",
"effective_status": "<string>"
}
],
"compensation": {
"attempted": true,
"verified": true,
"reason_code": "<string>"
},
"reconciliation": {
"method": "returned_ids",
"attempted_at": "2023-11-07T05:31:56Z",
"created_from": "2023-11-07T05:31:56Z",
"created_to": "2023-11-07T05:31:56Z",
"candidate_count": 123,
"listing_complete": true
},
"complete": true,
"all_paused": true,
"reconciled": true,
"pause_repairs": [
{
"id": "<string>",
"level": "campaign",
"attempted": true,
"accepted": true,
"verified": true
}
],
"automation": {
"automation_id": "<string>",
"run_id": "<string>",
"revision_id": "<string>",
"copy_index": 3
}
},
"counted_evidence": {
"target": {
"kind": "<string>",
"id": "<string>"
},
"captured_at": "<string>",
"window": {
"since": "<string>",
"until": "<string>",
"timezone": "<string>",
"days": 123
},
"currency": "<string>",
"currency_note": "<string>",
"meta_reported": {
"inline_link_clicks": 123,
"purchase_count": 123,
"purchase_value": "<string>",
"spend": "<string>",
"impressions": 123
},
"counted": {
"arrivals": 123,
"purchase_count": 123,
"purchase_value": "<string>",
"observed_conversions": 123
},
"coverage": {
"arrivals": {
"since": "<string>",
"until": "<string>",
"timezone": "<string>",
"days": 123
},
"purchases": {
"since": "<string>",
"until": "<string>",
"timezone": "<string>",
"days": 123
}
},
"conversion_definition": {
"version": "<string>",
"events": [
"<string>"
]
}
},
"proposer": {
"type": "user",
"name": "<string>"
},
"evidence": {
"original_action_id": "<string>",
"outcome": {
"status": "measurable",
"observed_at": "2023-11-07T05:31:56Z",
"reason_code": "<string>",
"reason": "<string>",
"baseline": {
"scope": "target",
"days": [
"2023-12-25"
],
"currency": "<string>",
"timezone": "<string>",
"spend_minor": "<string>",
"counted_arrivals": 123,
"cost_per_counted_arrival_minor": "<string>"
},
"metrics": {
"scope": "target",
"days": [
"2023-12-25"
],
"currency": "<string>",
"timezone": "<string>",
"spend_minor": "<string>",
"counted_arrivals": 123,
"cost_per_counted_arrival_minor": "<string>",
"verdict": "held",
"loss_threshold_percent": "<string>"
},
"inverse": {
"status": "proposed",
"batch_id": "<string>",
"reason_code": "<string>"
}
}
}
}
],
"meta": {
"current_page": 123,
"last_page": 123,
"per_page": 123,
"total": 123,
"next_cursor": 123,
"truncated": true,
"continuation": "<string>"
}
}{
"error": "invalid_token",
"error_description": "<string>"
}{
"error": "invalid_token",
"error_description": "<string>"
}{
"error": {
"code": "api_route_not_found",
"message": "<string>",
"resolution": "<string>"
},
"request": {
"method": "<string>",
"path": "<string>"
},
"resources": {
"documentation": "<string>",
"openapi": "<string>"
}
}{
"message": "<string>",
"errors": {}
}List actions
Read persisted Actions data for the authorized account. Unbound keys require exactly one active account; account_id cannot select among multiple accounts.
curl --request GET \
--url https://plainrouter.com/api/v1/agent/workspaces/{workspace}/actions \
--header 'Authorization: Bearer <token>'import requests
url = "https://plainrouter.com/api/v1/agent/workspaces/{workspace}/actions"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://plainrouter.com/api/v1/agent/workspaces/{workspace}/actions', 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://plainrouter.com/api/v1/agent/workspaces/{workspace}/actions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$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://plainrouter.com/api/v1/agent/workspaces/{workspace}/actions"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://plainrouter.com/api/v1/agent/workspaces/{workspace}/actions")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://plainrouter.com/api/v1/agent/workspaces/{workspace}/actions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"id": "<string>",
"batch_id": "<string>",
"workspace_id": 123,
"type": "increase_budget",
"target_entity_type": "<string>",
"target_entity_id": "<string>",
"target_entity_name": "<string>",
"params": {},
"rationale": "<string>",
"status": "pending",
"batch_status": "pending",
"disposition": {
"receipt_status": "pending",
"outcome_payload": {
"status": "measurable",
"observed_at": "2023-11-07T05:31:56Z",
"reason_code": "<string>",
"reason": "<string>",
"baseline": {
"scope": "target",
"days": [
"2023-12-25"
],
"currency": "<string>",
"timezone": "<string>",
"spend_minor": "<string>",
"counted_arrivals": 123,
"cost_per_counted_arrival_minor": "<string>"
},
"metrics": {
"scope": "target",
"days": [
"2023-12-25"
],
"currency": "<string>",
"timezone": "<string>",
"spend_minor": "<string>",
"counted_arrivals": 123,
"cost_per_counted_arrival_minor": "<string>",
"verdict": "held",
"loss_threshold_percent": "<string>"
},
"inverse": {
"status": "proposed",
"batch_id": "<string>",
"reason_code": "<string>"
}
},
"outcome_status": "measurable",
"outcome_reason_code": "<string>",
"outcome_checked_at": "2023-11-07T05:31:56Z",
"compensation_reason_code": "<string>",
"recovery_disposition": "no_compensation",
"late_restored": true
},
"policy_decision": "allow",
"policy_reasons": [
"<string>"
],
"policy_result": {
"id": "<string>",
"policy_id": "<string>",
"policy_version": 123,
"phase": "proposal",
"outcome": "allowed",
"reasons": [
"<string>"
],
"reason_details": [
"<string>"
],
"requested_minor": 123,
"evaluated_at": "2023-11-07T05:31:56Z"
},
"policy_results": [
{
"id": "<string>",
"policy_id": "<string>",
"policy_version": 123,
"phase": "proposal",
"outcome": "allowed",
"reasons": [
"<string>"
],
"reason_details": [
"<string>"
],
"requested_minor": 123,
"evaluated_at": "2023-11-07T05:31:56Z"
}
],
"automation_context": {},
"copy_result": {
"source_root_id": "<string>",
"new_root_id": "<string>",
"id_map": [
{
"level": "campaign",
"source_id": "<string>",
"copied_id": "<string>"
}
],
"expected_counts": {
"campaign": 123,
"ad_set": 123,
"ad": 123
},
"observed_counts": {
"campaign": 123,
"ad_set": 123,
"ad": 123
},
"objects": [
{
"level": "campaign",
"id": "<string>",
"configured_status": "PAUSED",
"effective_status": "<string>"
}
],
"compensation": {
"attempted": true,
"verified": true,
"reason_code": "<string>"
},
"reconciliation": {
"method": "returned_ids",
"attempted_at": "2023-11-07T05:31:56Z",
"created_from": "2023-11-07T05:31:56Z",
"created_to": "2023-11-07T05:31:56Z",
"candidate_count": 123,
"listing_complete": true
},
"complete": true,
"all_paused": true,
"reconciled": true,
"pause_repairs": [
{
"id": "<string>",
"level": "campaign",
"attempted": true,
"accepted": true,
"verified": true
}
],
"automation": {
"automation_id": "<string>",
"run_id": "<string>",
"revision_id": "<string>",
"copy_index": 3
}
},
"counted_evidence": {
"target": {
"kind": "<string>",
"id": "<string>"
},
"captured_at": "<string>",
"window": {
"since": "<string>",
"until": "<string>",
"timezone": "<string>",
"days": 123
},
"currency": "<string>",
"currency_note": "<string>",
"meta_reported": {
"inline_link_clicks": 123,
"purchase_count": 123,
"purchase_value": "<string>",
"spend": "<string>",
"impressions": 123
},
"counted": {
"arrivals": 123,
"purchase_count": 123,
"purchase_value": "<string>",
"observed_conversions": 123
},
"coverage": {
"arrivals": {
"since": "<string>",
"until": "<string>",
"timezone": "<string>",
"days": 123
},
"purchases": {
"since": "<string>",
"until": "<string>",
"timezone": "<string>",
"days": 123
}
},
"conversion_definition": {
"version": "<string>",
"events": [
"<string>"
]
}
},
"proposer": {
"type": "user",
"name": "<string>"
},
"evidence": {
"original_action_id": "<string>",
"outcome": {
"status": "measurable",
"observed_at": "2023-11-07T05:31:56Z",
"reason_code": "<string>",
"reason": "<string>",
"baseline": {
"scope": "target",
"days": [
"2023-12-25"
],
"currency": "<string>",
"timezone": "<string>",
"spend_minor": "<string>",
"counted_arrivals": 123,
"cost_per_counted_arrival_minor": "<string>"
},
"metrics": {
"scope": "target",
"days": [
"2023-12-25"
],
"currency": "<string>",
"timezone": "<string>",
"spend_minor": "<string>",
"counted_arrivals": 123,
"cost_per_counted_arrival_minor": "<string>",
"verdict": "held",
"loss_threshold_percent": "<string>"
},
"inverse": {
"status": "proposed",
"batch_id": "<string>",
"reason_code": "<string>"
}
}
}
}
],
"meta": {
"current_page": 123,
"last_page": 123,
"per_page": 123,
"total": 123,
"next_cursor": 123,
"truncated": true,
"continuation": "<string>"
}
}{
"error": "invalid_token",
"error_description": "<string>"
}{
"error": "invalid_token",
"error_description": "<string>"
}{
"error": {
"code": "api_route_not_found",
"message": "<string>",
"resolution": "<string>"
},
"request": {
"method": "<string>",
"path": "<string>"
},
"resources": {
"documentation": "<string>",
"openapi": "<string>"
}
}{
"message": "<string>",
"errors": {}
}Authorizations
Workspace key with read-actions for reads or propose-actions for writes. Optional positive account ID. A bound key may name only its own account; a different ID returns 422. An unbound key requires exactly one active available advertising account with an active connection; omission uses that account and a supplied ID must match it. Multiple active accounts return 422 even when account_id is supplied.
Query Parameters
Optional positive account ID. A bound key may name only its own account; a different ID returns 422. An unbound key requires exactly one active available advertising account with an active connection; omission uses that account and a supplied ID must match it. Multiple active accounts return 422 even when account_id is supplied.
x >= 1Response
Authorized Actions resource. Result projections share the 80,000-byte MCP JSON budget; defaults are bounded, next_cursor continues complete rows, and oversized single rows are explicitly refused. Plan creative continuation uses the read endpoint; proposal continuation uses the batch read endpoint.