Properties
| Name | Type | Description |
|---|---|---|
| limit | integer | Maximum complete result actions; the shared JSON byte budget can return fewer. |
| cursor | integer | Continue using next_cursor. Read saved proposal actions with get_action_batch to avoid another write; dry runs repeat the same inputs. |
| actions | array | |
| rationale | string | |
| idempotency_key | string | |
| evidence | array | |
| target_source | string | |
| account_id | integer | |
| workspace_id | integer |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://raw.githubusercontent.com/api-evangelist/plainrouter/main/json-schema/plainrouter-action-proposal-input-schema.json",
"title": "ActionProposalInput",
"x-generated": "2026-10-18",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/plainrouter-openapi.json#/components/schemas/ActionProposalInput",
"properties": {
"limit": {
"description": "Maximum complete result actions; the shared JSON byte budget can return fewer.",
"default": 25,
"minimum": 1,
"maximum": 100,
"type": "integer"
},
"cursor": {
"description": "Continue using next_cursor. Read saved proposal actions with get_action_batch to avoid another write; dry runs repeat the same inputs.",
"minimum": 0,
"type": "integer"
},
"actions": {
"minItems": 1,
"maxItems": 25,
"items": {
"anyOf": [
{
"properties": {
"type": {
"enum": [
"increase_budget"
],
"type": "string"
},
"target_entity": {
"additionalProperties": false,
"properties": {
"type": {
"enum": [
"ad_account",
"campaign",
"ad_set",
"ad"
],
"maxLength": 64,
"type": "string"
},
"id": {
"maxLength": 128,
"pattern": "^[0-9]+$",
"type": "string"
},
"name": {
"maxLength": 255,
"type": [
"string",
"null"
]
}
},
"type": "object",
"required": [
"type",
"id"
]
},
"params": {
"additionalProperties": false,
"properties": {
"new_daily_budget_minor": {
"minimum": 1,
"type": "integer"
}
},
"type": "object",
"required": [
"new_daily_budget_minor"
]
},
"rationale": {
"maxLength": 2000,
"type": "string"
},
"idempotency_key": {
"maxLength": 255,
"type": "string"
}
},
"type": "object",
"required": [
"type",
"target_entity",
"params",
"rationale"
]
},
{
"properties": {
"type": {
"enum": [
"decrease_budget"
],
"type": "string"
},
"target_entity": {
"additionalProperties": false,
"properties": {
"type": {
"enum": [
"ad_account",
"campaign",
"ad_set",
"ad"
],
"maxLength": 64,
"type": "string"
},
"id": {
"maxLength": 128,
"pattern": "^[0-9]+$",
"type": "string"
},
"name": {
"maxLength": 255,
"type": [
"string",
"null"
]
}
},
"type": "object",
"required": [
"type",
"id"
]
},
"params": {
"additionalProperties": false,
"properties": {
"new_daily_budget_minor": {
"minimum": 1,
"type": "integer"
}
},
"type": "object",
"required": [
"new_daily_budget_minor"
]
},
"rationale": {
"maxLength": 2000,
"type": "string"
},
"idempotency_key": {
"maxLength": 255,
"type": "string"
}
},
"type": "object",
"required": [
"type",
"target_entity",
"params",
"rationale"
]
},
{
"properties": {
"type": {
"enum": [
"pause"
],
"type": "string"
},
"target_entity": {
"additionalProperties": false,
"properties": {
"type": {
"enum": [
"ad_account",
"campaign",
"ad_set",
"ad"
],
"maxLength": 64,
"type": "string"
},
"id": {
"maxLength": 128,
"pattern": "^[0-9]+$",
"type": "string"
},
"name": {
"maxLength": 255,
"type": [
"string",
"null"
]
}
},
"type": "object",
"required": [
"type",
"id"
]
},
"params": {
"additionalProperties": false,
"type": "object"
},
"rationale": {
"maxLength": 2000,
"type": "string"
},
"idempotency_key": {
"maxLength": 255,
"type": "string"
}
},
"type": "object",
"required": [
"type",
"target_entity",
"params",
"rationale"
]
},
{
"properties": {
"type": {
"enum": [
"resume"
],
"type": "string"
},
"target_entity": {
"additionalProperties": false,
"properties": {
"type": {
"enum": [
"ad_account",
"campaign",
"ad_set",
"ad"
],
"maxLength": 64,
"type": "string"
},
"id": {
"maxLength": 128,
"pattern": "^[0-9]+$",
"type": "string"
},
"name": {
"maxLength": 255,
"type": [
"string",
"null"
]
}
},
"type": "object",
"required": [
"type",
"id"
]
},
"params": {
"additionalProperties": false,
"type": "object"
},
"rationale": {
"maxLength": 2000,
"type": "string"
},
"idempotency_key": {
"maxLength": 255,
"type": "string"
}
},
"type": "object",
"required": [
"type",
"target_entity",
"params",
"rationale"
]
},
{
"properties": {
"type": {
"enum": [
"replace_creative"
],
"type": "string"
},
"target_entity": {
"additionalProperties": false,
"properties": {
"type": {
"enum": [
"ad_account",
"campaign",
"ad_set",
"ad"
],
"maxLength": 64,
"type": "string"
},
"id": {
"maxLength": 128,
"type": "string"
},
"name": {
"maxLength": 255,
"type": [
"string",
"null"
]
}
},
"type": "object",
"required": [
"type",
"id"
]
},
"params": {
"additionalProperties": false,
"type": "object"
},
"rationale": {
"maxLength": 2000,
"type": "string"
},
"idempotency_key": {
"maxLength": 255,
"type": "string"
}
},
"type": "object",
"required": [
"type",
"target_entity",
"params",
"rationale"
]
},
{
"properties": {
"type": {
"enum": [
"shift_spend"
],
"type": "string"
},
"target_entity": {
"additionalProperties": false,
"properties": {
"type": {
"enum": [
"ad_account",
"campaign",
"ad_set",
"ad"
],
"maxLength": 64,
"type": "string"
},
"id": {
"maxLength": 128,
"type": "string"
},
"name": {
"maxLength": 255,
"type": [
"string",
"null"
]
}
},
"type": "object",
"required": [
"type",
"id"
]
},
"params": {
"additionalProperties": false,
"type": "object"
},
"rationale": {
"maxLength": 2000,
"type": "string"
},
"idempotency_key": {
"maxLength": 255,
"type": "string"
}
},
"type": "object",
"required": [
"type",
"target_entity",
"params",
"rationale"
]
},
{
"properties": {
"type": {
"enum": [
"rollback"
],
"type": "string"
},
"target_entity": {
"additionalProperties": false,
"properties": {
"type": {
"enum": [
"ad_account",
"campaign",
"ad_set",
"ad"
],
"maxLength": 64,
"type": "string"
},
"id": {
"maxLength": 128,
"type": "string"
},
"name": {
"maxLength": 255,
"type": [
"string",
"null"
]
}
},
"type": "object",
"required": [
"type",
"id"
]
},
"params": {
"additionalProperties": false,
"type": "object"
},
"rationale": {
"maxLength": 2000,
"type": "string"
},
"idempotency_key": {
"maxLength": 255,
"type": "string"
}
},
"type": "object",
"required": [
"type",
"target_entity",
"params",
"rationale"
]
},
{
"properties": {
"type": {
"enum": [
"create_campaign"
],
"type": "string"
},
"target_entity": {
"additionalProperties": false,
"properties": {
"type": {
"enum": [
"ad_account",
"campaign",
"ad_set",
"ad"
],
"maxLength": 64,
"type": "string"
},
"id": {
"maxLength": 128,
"type": "string"
},
"name": {
"maxLength": 255,
"type": [
"string",
"null"
]
}
},
"type": "object",
"required": [
"type",
"id"
]
},
"params": {
"additionalProperties": false,
"type": "object"
},
"rationale": {
"maxLength": 2000,
"type": "string"
},
"idempotency_key": {
"maxLength": 255,
"type": "string"
}
},
"type": "object",
"required": [
"type",
"target_entity",
"params",
"rationale"
]
},
{
"properties": {
"type": {
"enum": [
"create_ad_set"
],
"type": "string"
},
"target_entity": {
"additionalProperties": false,
"properties": {
"type": {
"enum": [
"ad_account",
"campaign",
"ad_set",
"ad"
],
"maxLength": 64,
"type": "string"
},
"id": {
"maxLength": 128,
"type": "string"
},
"name": {
"maxLength": 255,
"type": [
"string",
"null"
]
}
},
"type": "object",
"required": [
"type",
"id"
]
},
"params": {
"additionalProperties": false,
"type": "object"
},
"rationale": {
"maxLength": 2000,
"type": "string"
},
"idempotency_key": {
"maxLength": 255,
"type": "string"
}
},
"type": "object",
"required": [
"type",
"target_entity",
"params",
"rationale"
]
},
{
"properties": {
"type": {
"enum": [
"create_ad"
],
"type": "string"
},
"target_entity": {
"additionalProperties": false,
"properties": {
"type": {
"enum": [
"ad_account",
"campaign",
"ad_set",
"ad"
],
"maxLength": 64,
"type": "string"
},
"id": {
"maxLength": 128,
"type": "string"
},
"name": {
"maxLength": 255,
"type": [
"string",
"null"
]
}
},
"type": "object",
"required": [
"type",
"id"
]
},
"params": {
"additionalProperties": false,
"type": "object"
},
"rationale": {
"maxLength": 2000,
"type": "string"
},
"idempotency_key": {
"maxLength": 255,
"type": "string"
}
},
"type": "object",
"required": [
"type",
"target_entity",
"params",
"rationale"
]
},
{
"properties": {
"type": {
"enum": [
"upload_asset"
],
"type": "string"
},
"target_entity": {
"additionalProperties": false,
"properties": {
"type": {
"enum": [
"ad_account",
"campaign",
"ad_set",
"ad"
],
"maxLength": 64,
"type": "string"
},
"id": {
"maxLength": 128,
"type": "string"
},
"name": {
"maxLength": 255,
"type": [
"string",
"null"
]
}
},
"type": "object",
"required": [
"type",
"id"
]
},
"params": {
"additionalProperties": false,
"properties": {
"staged_asset_id": {
"maxLength": 255,
"pattern": "^stage_[a-f0-9]{40}$",
"type": "string"
},
"asset_type": {
"enum": [
"image"
],
"type": "string"
},
"filename": {
"maxLength": 255,
"type": "string"
},
"content_sha256": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"mime_type": {
"maxLength": 255,
"type": [
"string",
"null"
]
},
"size_bytes": {
"minimum": 1,
"type": [
"integer",
"null"
]
}
},
"type": "object",
"required": [
"staged_asset_id",
"asset_type",
"filename",
"content_sha256"
]
},
"rationale": {
"maxLength": 2000,
"type": "string"
},
"idempotency_key": {
"maxLength": 255,
"type": "string"
}
},
"type": "object",
"required": [
"type",
"target_entity",
"params",
"rationale"
]
},
{
"properties": {
"type": {
"enum": [
"adjust_budget"
],
"type": "string"
},
"target_entity": {
"additionalProperties": false,
"properties": {
"type": {
"enum": [
"ad_account",
"campaign",
"ad_set",
"ad"
],
"maxLength": 64,
"type": "string"
},
"id": {
"maxLength": 128,
"type": "string"
},
"name": {
"maxLength": 255,
"type": [
"string",
"null"
]
}
},
"type": "object",
"required": [
"type",
"id"
]
},
"params": {
"additionalProperties": false,
"properties": {
"new_daily_budget_minor": {
"minimum": 1,
"type": "integer"
}
},
"type": "object",
"required": [
"new_daily_budget_minor"
]
},
"rationale": {
"maxLength": 2000,
"type": "string"
},
"idempotency_key": {
"maxLength": 255,
"type": "string"
}
},
"type": "object",
"required": [
"type",
"target_entity",
"params",
"rationale"
]
},
{
"properties": {
"type": {
"enum": [
"set_status"
],
"type": "string"
},
"target_entity": {
"additionalProperties": false,
"properties": {
"type": {
"enum": [
"ad_account",
"campaign",
"ad_set",
"ad"
],
"maxLength": 64,
"type": "string"
},
"id": {
"maxLength": 128,
"type": "string"
},
"name": {
"maxLength": 255,
"type": [
"string",
"null"
]
}
},
"type": "object",
"required": [
"type",
"id"
]
},
"params": {
"additionalProperties": false,
"properties": {
"status": {
"enum": [
"active",
"paused"
],
"type": "string"
}
},
"type": "object",
"required": [
"status"
]
},
"rationale": {
"maxLength": 2000,
"type": "string"
},
"idempotency_key": {
"maxLength": 255,
"type": "string"
}
},
"type": "object",
"required": [
"type",
"target_entity",
"params",
"rationale"
]
},
{
"properties": {
"type": {
"enum": [
"duplicate_ad_with_creative"
],
"type": "string"
},
"target_entity": {
"additionalProperties": false,
"properties": {
"type": {
"enum": [
"ad_account",
"campaign",
"ad_set",
"ad"
],
"maxLength": 64,
"type": "string"
},
"id": {
"maxLength": 128,
"type": "string"
},
"name": {
"maxLength": 255,
"type": [
"string",
"null"
]
}
},
"type": "object",
"required": [
"type",
"id"
]
},
"params": {
"additionalProperties": false,
"properties": {
"asset_id": {
"maxLength": 255,
"pattern": "^(image|video):.+$",
"type": "string"
},
"status": {
"enum": [
"paused"
],
"type": "string"
},
"name_suffix": {
"maxLength": 100,
"type": [
"string",
"null"
]
}
},
"type": "object",
"required": [
"asset_id",
"status"
]
},
"rationale": {
"maxLength": 2000,
"type": "string"
},
"idempotency_key": {
"maxLength": 255,
"type": "string"
}
},
"type": "object",
"required": [
"type",
"target_entity",
"params",
"rationale"
]
}
]
},
"type": "array"
},
"rationale": {
"maxLength": 4000,
"type": "string"
},
"idempotency_key": {
"maxLength": 64,
"type": "string"
},
"evidence": {
"minItems": 1,
"maxItems": 3,
"items": {
"additionalProperties": false,
"properties": {
"source_tool": {
"enum": [
"get_account_state",
"get_signal_health",
"get_performance",
"get_inventory_metrics",
"get-creative-library",
"staged-asset-manifest"
],
"type": "string"
},
"fields_used": {
"minItems": 1,
"maxItems": 50,
"items": {
"maxLength": 255,
"type": "string"
},
"type": "array"
},
"action_index": {
"minimum": 0,
"type": "integer"
}
},
"type": "object",
"required": [
"source_tool",
"fields_used"
]
},
"type": "array"
},
"target_source": {
"enum": [
"human_supplied"
],
"type": "string"
},
"account_id": {
"minimum": 1,
"type": "integer"
},
"workspace_id": {
"minimum": 1,
"type": "integer"
}
},
"type": "object",
"required": [
"actions",
"rationale",
"idempotency_key",
"evidence",
"target_source"
]
}Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/plainrouter-action-proposal-input"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.