Update learning
Change a learning's statement, scope or status. Status moves are appended.
Supported or refuted without a test_id needs a reason. Retire with status retired.
Requires a key with write scope or higher.
MCP: meta_update_learning.
bearerAuthAuthorizationBearer <token>An API key from Settings → API keys, sent as Authorization: Bearer rsk_….
Authorization has two independent axes.
The scope is ranked — a key satisfies any requirement at or below its own tier:
read— every GET.write— launch ads PAUSED, sync, pull history, edit thresholds, Values, briefs, tests, swipes and research.admin— everythingwritecan. No operation requires more thanwritetoday.
There is no approve scope. It was a rung once; it is not one now, and a key requested with it is rejected.
The approval grant (can_approve) is a separate boolean, not a rung. Changing spend on Meta — activating a launch, pausing or resuming ads, retargeting an ad set, or rebuilding a launch's live creative — needs write and the grant. Keeping them on separate axes is what makes the review gate a control rather than a convention: a key that may propose is not automatically a key that may approve its own proposal.
A key reaches the one workspace — one Meta ad account — it was minted in, and stops working when the operator who minted it leaves the workspace. The same key authenticates the MCP endpoint (/api/mcp) for a headless agent, with the same scope and grant.
learningId*stringA learning id, from GET /api/v1/learnings.
uuidapplication/json- body
statement?string1 <= length <= 600observation?|nullimplication?|nullscope?array<>items <= 8status?string"hypothesis""supported""refuted""retired"reason?stringlength <= 400test_id?string^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$uuidagent?stringlength <= 40Success. The body is the tool's own result — the same payload the MCP tool returns.
application/json- response
curl -X PATCH 'https://winandscale.com/api/v1/learnings/497f6eca-6276-4993-bfeb-53cbbbba6f08' \ -H 'Content-Type: application/json' \ -d '{}'{}