Agents / CLI
Accept coach action
Execute a Coach recommendation. Action is a discriminated union by type: pause_brief, archive_brief, refill_campaign, spawn_variant, increase_daily_cap, decrease_daily_cap, switch_framework, tighten_icp_filter. Each type carries its own required fields. Pair with get-coach-performance-reviews to inspect the evidence before accepting.
pipeline accept-coach-actionDeterministic operationParameters
workspaceIdOptional · string- Optional workspace ID or slug. Required when this credential can access multiple workspaces and no workspace was configured on the client.
recommendationTextRequired · string- The recommendation text from Coach (used for the audit trail).
proposalIdOptional · string- Optional proposal ID from the performance review. Forward it to close the proposal lifecycle atomically.
actionRequired · object- See the input schema for this field.
pipeline accept-coach-action \
--recommendation-text "example" \
--action-json '{"type":"spawn_variant","sourceBriefId":"00000000-0000-4000-8000-000000000000"}'Full input schema
{
"type": "object",
"properties": {
"workspaceId": {
"type": "string",
"minLength": 1,
"description": "Optional workspace ID or slug. Required when this credential can access multiple workspaces and no workspace was configured on the client."
},
"recommendationText": {
"type": "string",
"description": "The recommendation text from Coach (used for the audit trail)."
},
"proposalId": {
"type": "string",
"description": "Optional proposal ID from the performance review. Forward it to close the proposal lifecycle atomically."
},
"action": {
"oneOf": [
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"spawn_variant"
]
},
"sourceBriefId": {
"type": "string"
},
"targetIcpProfileId": {
"type": "string"
},
"targetOfferId": {
"type": "string"
}
},
"required": [
"type",
"sourceBriefId"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"refill_campaign"
]
},
"campaignId": {
"type": "string"
},
"briefId": {
"type": "string"
},
"reason": {
"type": "string"
}
},
"required": [
"type",
"campaignId",
"reason"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"pause_brief"
]
},
"briefId": {
"type": "string"
},
"reason": {
"type": "string"
}
},
"required": [
"type",
"briefId",
"reason"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"archive_brief"
]
},
"briefId": {
"type": "string"
}
},
"required": [
"type",
"briefId"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"increase_daily_cap",
"decrease_daily_cap"
]
},
"agentRole": {
"type": "string",
"enum": [
"scout"
]
},
"newCap": {
"type": "number"
},
"reason": {
"type": "string"
}
},
"required": [
"type",
"agentRole",
"newCap",
"reason"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"switch_framework"
]
},
"briefId": {
"type": "string"
},
"framework": {
"type": "string"
},
"reason": {
"type": "string"
}
},
"required": [
"type",
"briefId",
"framework",
"reason"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"tighten_icp_filter"
]
},
"briefId": {
"type": "string"
},
"field": {
"type": "string"
},
"value": {},
"reason": {
"type": "string"
}
},
"required": [
"type",
"briefId",
"field",
"value",
"reason"
]
}
]
}
},
"required": [
"recommendationText",
"action"
]
}