query searches text. Follow next_cursor until complete is true. Time filters form a half-open interval: include started_after, exclude started_before.
The tables list arguments and common nested fields. Expand Full input schema for all fields and allowed values. Workspace and account permissions apply to every tool.
activity_list
Search tool calls, actions, and rule runs. Use exact filters such astool_name and status, or use query for text search. Follow next_cursor until complete is true.
Access: mcp:read.
| Parameter | Type | Required / default | Details |
|---|---|---|---|
payload | object | Required | Filters and pagination for the activity log. |
payload fields
| Parameter | Type | Required / default | Details |
|---|---|---|---|
query | string or null | null | |
activity_type | tool_call, action, rule_run, launch_run, creative_import or null | null | Kind of operation to include. |
status | running, succeeded, failed, denied, skipped, undone, undo_failed, reconciliation_needed or null | null | |
team_member_user_id | uuid or null | null | Filter by the member who initiated the operation. |
initiator_type | string or null | null | |
ad_account_id | uuid or null | null | Superlaunch account UUID from ad_accounts_list. |
mcp_connection_id | uuid or null | null | Filter by a specific MCP connection. |
rule_id | uuid or null | null | Rule UUID from rules_list. |
rule_run_id | uuid or null | null | Filter by a specific rule run. |
launch_id | uuid or null | null | Launch UUID from submission or launcher_launches_list. |
tool_name | string or null | null | Exact MCP tool name to filter by. |
action_name | string or null | null | Exact action name to filter by. |
target_type | string or null | null | |
target_id | string or null | null | |
started_after | date-time or null | null | Include operations starting at or after this timestamp. |
started_before | date-time or null | null | Exclude operations starting at or after this timestamp. |
limit | integer | 25 | minimum: 1. maximum: 100. |
cursor | integer | 0 | minimum: 0. maximum: 4294967295. |
Full input schema
Full input schema
{
"$defs": {
"ActivityQuery": {
"additionalProperties": false,
"description": "Bounded page request for the unified activity log.",
"properties": {
"query": {
"anyOf": [
{
"maxLength": 200,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"activity_type": {
"anyOf": [
{
"$ref": "#/$defs/ActivityType"
},
{
"type": "null"
}
],
"default": null
},
"status": {
"anyOf": [
{
"$ref": "#/$defs/ActivityStatus"
},
{
"type": "null"
}
],
"default": null
},
"team_member_user_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"initiator_type": {
"anyOf": [
{
"maxLength": 32,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"ad_account_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"mcp_connection_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"rule_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"rule_run_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"launch_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"tool_name": {
"anyOf": [
{
"maxLength": 100,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"action_name": {
"anyOf": [
{
"maxLength": 64,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"target_type": {
"anyOf": [
{
"maxLength": 64,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"target_id": {
"anyOf": [
{
"maxLength": 300,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"started_after": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"started_before": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"limit": {
"default": 25,
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"cursor": {
"default": 0,
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
}
},
"type": "object"
},
"ActivityStatus": {
"description": "Small shared activity lifecycle.",
"enum": [
"running",
"succeeded",
"failed",
"denied",
"skipped",
"undone",
"undo_failed",
"reconciliation_needed"
],
"type": "string"
},
"ActivityType": {
"description": "User-visible kinds of work.",
"enum": [
"tool_call",
"action",
"rule_run",
"launch_run",
"creative_import"
],
"type": "string"
}
},
"additionalProperties": false,
"properties": {
"payload": {
"$ref": "#/$defs/ActivityQuery"
}
},
"required": [
"payload"
],
"type": "object"
}
activity_get
Read one complete authorized activity record by ID. Access:mcp:read.
| Parameter | Type | Required / default | Details |
|---|---|---|---|
activity_id | uuid | Required | Activity UUID from the tool result or activity_list. |
Full input schema
Full input schema
{
"additionalProperties": false,
"properties": {
"activity_id": {
"format": "uuid",
"type": "string"
}
},
"required": [
"activity_id"
],
"type": "object"
}
activity_summary
Count the complete authorized result set for activity filters. Access:mcp:read.
| Parameter | Type | Required / default | Details |
|---|---|---|---|
payload | object | Required | Permission-filtered search criteria for the unified activity log. |
payload fields
| Parameter | Type | Required / default | Details |
|---|---|---|---|
query | string or null | null | |
activity_type | tool_call, action, rule_run, launch_run, creative_import or null | null | Kind of operation to include. |
status | running, succeeded, failed, denied, skipped, undone, undo_failed, reconciliation_needed or null | null | |
team_member_user_id | uuid or null | null | Filter by the member who initiated the operation. |
initiator_type | string or null | null | |
ad_account_id | uuid or null | null | Superlaunch account UUID from ad_accounts_list. |
mcp_connection_id | uuid or null | null | Filter by a specific MCP connection. |
rule_id | uuid or null | null | Rule UUID from rules_list. |
rule_run_id | uuid or null | null | Filter by a specific rule run. |
launch_id | uuid or null | null | Launch UUID from submission or launcher_launches_list. |
tool_name | string or null | null | Exact MCP tool name to filter by. |
action_name | string or null | null | Exact action name to filter by. |
target_type | string or null | null | |
target_id | string or null | null | |
started_after | date-time or null | null | Include operations starting at or after this timestamp. |
started_before | date-time or null | null | Exclude operations starting at or after this timestamp. |
Full input schema
Full input schema
{
"$defs": {
"ActivityFilters": {
"additionalProperties": false,
"description": "Permission-filtered search criteria for the unified activity log.",
"properties": {
"query": {
"anyOf": [
{
"maxLength": 200,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"activity_type": {
"anyOf": [
{
"$ref": "#/$defs/ActivityType"
},
{
"type": "null"
}
],
"default": null
},
"status": {
"anyOf": [
{
"$ref": "#/$defs/ActivityStatus"
},
{
"type": "null"
}
],
"default": null
},
"team_member_user_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"initiator_type": {
"anyOf": [
{
"maxLength": 32,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"ad_account_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"mcp_connection_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"rule_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"rule_run_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"launch_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"tool_name": {
"anyOf": [
{
"maxLength": 100,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"action_name": {
"anyOf": [
{
"maxLength": 64,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"target_type": {
"anyOf": [
{
"maxLength": 64,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"target_id": {
"anyOf": [
{
"maxLength": 300,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"started_after": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"started_before": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"type": "object"
},
"ActivityStatus": {
"description": "Small shared activity lifecycle.",
"enum": [
"running",
"succeeded",
"failed",
"denied",
"skipped",
"undone",
"undo_failed",
"reconciliation_needed"
],
"type": "string"
},
"ActivityType": {
"description": "User-visible kinds of work.",
"enum": [
"tool_call",
"action",
"rule_run",
"launch_run",
"creative_import"
],
"type": "string"
}
},
"additionalProperties": false,
"properties": {
"payload": {
"$ref": "#/$defs/ActivityFilters"
}
},
"required": [
"payload"
],
"type": "object"
}