Public REST/JSON reference

Ad Spend Auto-Governor API

Monitor Meta and Google ad campaign ROAS, budget pacing, and spend variance; recommend or execute pauses, reactivations, caps, and reallocations before underperforming campaigns burn through budget. Part of the Logic Igniter E-commerce Operations bundle.

Access boundary

These examples describe public API calls only. Use the service output to review, score, summarize, analyze, or recommend; do not treat the API reference as permission for an assistant to write, send, publish, charge, schedule, notify, delete, or modify records.

Base URL

https://api.logicigniter.com

Auth

Authorization: Bearer YOUR_API_KEY

Version

OpenAPI 3.0.3 · 1.0.0

Spec

/api-specs/adgovernor.json

Operations rendered

Response models rendered

GET/api/v1/adgovernor/health

Service liveness

Liveness probe for Ad Spend Auto-Governor API. Returns 200 when the public API route is reachable.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/adgovernor/health" \
  -H "Accept: application/json"

Responses

200

Service healthy

GET/api/v1/adgovernor/customers

List customers

List customers record for the customer workspace used by Ad Spend Auto-Governor API.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/adgovernor/customers" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200CustomerList

Successful response

400Error

Invalid request payload or parameters

401Error

Missing or invalid bearer token

403Error

Workspace does not have access to the ecommerce-operations bundle

404Error

Requested resource was not found

PUT/api/v1/adgovernor/customers/{id}

Update customer

Update customer record for the customer workspace used by Ad Spend Auto-Governor API.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`id`required	path	string	Id

Request body (required)

Schema: CustomerInput

Sample JSON payload for evaluation.

{
  "companyName": "Mira Home Goods",
  "email": "[email protected]"
}

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X PUT "https://api.logicigniter.com/api/v1/adgovernor/customers/:id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"companyName":"Mira Home Goods","email":"[email protected]"}'

Responses

200Customer

Successful response

400Error

Invalid request payload or parameters

401Error

Missing or invalid bearer token

403Error

Workspace does not have access to the ecommerce-operations bundle

404Error

Requested resource was not found

GET/api/v1/adgovernor/budget/allocation

Get budget allocation

Return current spend allocation, pacing, and remaining budget by channel.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/adgovernor/budget/allocation" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200BudgetAllocation

Successful response

400Error

Invalid request payload or parameters

401Error

Missing or invalid bearer token

403Error

Workspace does not have access to the ecommerce-operations bundle

POST/api/v1/adgovernor/budget/reallocate

Reallocate budget

Move budget from underperforming campaigns to higher-ROAS campaigns.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Request body (required)

Schema: BudgetReallocateRequest

Sample JSON payload for evaluation.

{
  "id": "obj_123",
  "status": "READY",
  "summary": "BudgetReallocateRequest"
}

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X POST "https://api.logicigniter.com/api/v1/adgovernor/budget/reallocate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"id":"obj_123","status":"READY","summary":"BudgetReallocateRequest"}'

Responses

200BudgetAllocation

Successful response

400Error

Invalid request payload or parameters

401Error

Missing or invalid bearer token

403Error

Workspace does not have access to the ecommerce-operations bundle

GET/api/v1/adgovernor/budget/caps

Get budget caps

Read active spend caps and enforcement thresholds.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/adgovernor/budget/caps" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200BudgetCaps

Successful response

400Error

Invalid request payload or parameters

401Error

Missing or invalid bearer token

403Error

Workspace does not have access to the ecommerce-operations bundle

POST/api/v1/adgovernor/campaigns/sync

Sync campaigns

Import campaign, ad set, and spend data from connected ad platforms.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Request body (required)

Schema: CampaignSyncRequest

Sample JSON payload for evaluation.

{
  "id": "obj_123",
  "status": "READY",
  "summary": "CampaignSyncRequest"
}

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X POST "https://api.logicigniter.com/api/v1/adgovernor/campaigns/sync" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"id":"obj_123","status":"READY","summary":"CampaignSyncRequest"}'

Responses

200CampaignSyncResult

Successful response

400Error

Invalid request payload or parameters

401Error

Missing or invalid bearer token

403Error

Workspace does not have access to the ecommerce-operations bundle

GET/api/v1/adgovernor/campaigns

List campaigns

List campaigns with budget, spend, ROAS, and governor status.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/adgovernor/campaigns" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200CampaignList

Successful response

400Error

Invalid request payload or parameters

401Error

Missing or invalid bearer token

403Error

Workspace does not have access to the ecommerce-operations bundle

GET/api/v1/adgovernor/campaigns/{campaign_id}/performance

Get campaign performance

Read hourly spend, ROAS, conversions, and variance for one campaign.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`campaign_id`required	path	string	Campaign Id

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/adgovernor/campaigns/:campaign_id/performance" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200CampaignPerformance

Successful response

400Error

Invalid request payload or parameters

401Error

Missing or invalid bearer token

403Error

Workspace does not have access to the ecommerce-operations bundle

404Error

Requested resource was not found

POST/api/v1/adgovernor/governor/analyze

Analyze performance

Evaluate campaign performance against ROAS and pacing rules.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Request body (required)

Schema: GovernorAnalyzeRequest

Sample JSON payload for evaluation.

{
  "id": "obj_123",
  "status": "READY",
  "summary": "GovernorAnalyzeRequest"
}

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X POST "https://api.logicigniter.com/api/v1/adgovernor/governor/analyze" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"id":"obj_123","status":"READY","summary":"GovernorAnalyzeRequest"}'

Responses

200GovernorDecisionList

Successful response

400Error

Invalid request payload or parameters

401Error

Missing or invalid bearer token

403Error

Workspace does not have access to the ecommerce-operations bundle

POST/api/v1/adgovernor/governor/execute

Execute governance

Execute approved pause, cap, or reallocation actions.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Request body (required)

Schema: GovernorExecuteRequest

Sample JSON payload for evaluation.

{
  "id": "obj_123",
  "status": "READY",
  "summary": "GovernorExecuteRequest"
}

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X POST "https://api.logicigniter.com/api/v1/adgovernor/governor/execute" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"id":"obj_123","status":"READY","summary":"GovernorExecuteRequest"}'

Responses

200GovernorActionList

Successful response

400Error

Invalid request payload or parameters

401Error

Missing or invalid bearer token

403Error

Workspace does not have access to the ecommerce-operations bundle

POST/api/v1/adgovernor/campaigns/{campaign_id}/pause

Pause campaign

Pause a campaign that breached ROAS or pacing thresholds.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`campaign_id`required	path	string	Campaign Id

Request body (required)

Schema: PauseCampaignRequest

Sample JSON payload for evaluation.

{
  "id": "obj_123",
  "status": "READY",
  "summary": "PauseCampaignRequest"
}

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X POST "https://api.logicigniter.com/api/v1/adgovernor/campaigns/:campaign_id/pause" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"id":"obj_123","status":"READY","summary":"PauseCampaignRequest"}'

Responses

200GovernorAction

Successful response

400Error

Invalid request payload or parameters

401Error

Missing or invalid bearer token

403Error

Workspace does not have access to the ecommerce-operations bundle

404Error

Requested resource was not found

POST/api/v1/adgovernor/campaigns/{campaign_id}/reactivate

Reactivate campaign

Reactivate a campaign after recovery criteria are met.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`campaign_id`required	path	string	Campaign Id

Request body (required)

Schema: ReactivateCampaignRequest

Sample JSON payload for evaluation.

{
  "id": "obj_123",
  "status": "READY",
  "summary": "ReactivateCampaignRequest"
}

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X POST "https://api.logicigniter.com/api/v1/adgovernor/campaigns/:campaign_id/reactivate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"id":"obj_123","status":"READY","summary":"ReactivateCampaignRequest"}'

Responses

200GovernorAction

Successful response

400Error

Invalid request payload or parameters

401Error

Missing or invalid bearer token

403Error

Workspace does not have access to the ecommerce-operations bundle

404Error

Requested resource was not found

GET/api/v1/adgovernor/governor/actions

List governor actions

List automatic and manual governance actions.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/adgovernor/governor/actions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200GovernorActionList

Successful response

400Error

Invalid request payload or parameters

401Error

Missing or invalid bearer token

403Error

Workspace does not have access to the ecommerce-operations bundle

Data models

Customer

Field	Type	Notes
`id`required	string	Example: "cus_mira_home"
`companyName`required	string	Example: "Mira Home Goods"
`email`required	string (email)	Example: "[email protected]"
`bundle`required	string	Example: "ecommerce-operations"
`createdAt`	string (date-time)

CustomerInput

Field	Type	Notes
`companyName`required	string	Example: "Mira Home Goods"
`email`required	string (email)	Example: "[email protected]"
`bundle`	string	Example: "ecommerce-operations"

CustomerList

Field	Type	Notes
`customers`	array<Customer>

Error

Field	Type	Notes
`error`required	string	Example: "validation failed"
`message`	string	Example: "sku is required"
`requestId`	string	Example: "req_01HX9E2M7K8Q4J3V"

BudgetAllocation

Field	Type	Notes
`id`required	string	Example: "obj_123"
`status`required	string	Example: "READY"
`summary`	string	Example: "BudgetAllocation"

BudgetCaps

Field	Type	Notes
`id`required	string	Example: "obj_123"
`status`required	string	Example: "READY"
`summary`	string	Example: "BudgetCaps"

BudgetCapsRequest

Field	Type	Notes
`id`required	string	Example: "obj_123"
`status`required	string	Example: "READY"
`summary`	string	Example: "BudgetCapsRequest"

BudgetReallocateRequest

Field	Type	Notes
`id`required	string	Example: "obj_123"
`status`required	string	Example: "READY"
`summary`	string	Example: "BudgetReallocateRequest"

CampaignList

Field	Type	Notes
`id`required	string	Example: "obj_123"
`status`required	string	Example: "READY"
`summary`	string	Example: "CampaignList"

CampaignPerformance

Field	Type	Notes
`id`required	string	Example: "obj_123"
`status`required	string	Example: "READY"
`summary`	string	Example: "CampaignPerformance"

CampaignSyncRequest

Field	Type	Notes
`id`required	string	Example: "obj_123"
`status`required	string	Example: "READY"
`summary`	string	Example: "CampaignSyncRequest"

CampaignSyncResult

Field	Type	Notes
`id`required	string	Example: "obj_123"
`status`required	string	Example: "READY"
`summary`	string	Example: "CampaignSyncResult"

GovernorAction

Field	Type	Notes
`id`required	string	Example: "obj_123"
`status`required	string	Example: "READY"
`summary`	string	Example: "GovernorAction"

GovernorActionList

Field	Type	Notes
`id`required	string	Example: "obj_123"
`status`required	string	Example: "READY"
`summary`	string	Example: "GovernorActionList"

GovernorAnalyzeRequest

Field	Type	Notes
`id`required	string	Example: "obj_123"
`status`required	string	Example: "READY"
`summary`	string	Example: "GovernorAnalyzeRequest"

GovernorDecisionList

Field	Type	Notes
`id`required	string	Example: "obj_123"
`status`required	string	Example: "READY"
`summary`	string	Example: "GovernorDecisionList"

GovernorExecuteRequest

Field	Type	Notes
`id`required	string	Example: "obj_123"
`status`required	string	Example: "READY"
`summary`	string	Example: "GovernorExecuteRequest"

PauseCampaignRequest

Field	Type	Notes
`id`required	string	Example: "obj_123"
`status`required	string	Example: "READY"
`summary`	string	Example: "PauseCampaignRequest"

ReactivateCampaignRequest

Field	Type	Notes
`id`required	string	Example: "obj_123"
`status`required	string	Example: "READY"
`summary`	string	Example: "ReactivateCampaignRequest"