Research

Update messaging line

Rewrite a copy line (it becomes a human line, keeping the quotes it cites).

PATCH
/api/v1/research/messaging/{messagingId}

The angle and kind cannot change — add a new line and reject the old one. status (draft or approved) may ride along.

Requires a key with write scope or higher.

MCP: meta_save_messaging.

Authorization

bearerAuth
headerAuthorizationBearer <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 — everything write can. No operation requires more than write today.

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.

Path Parameters

messagingId*string

A copy line id, from GET /api/v1/research/messaging.

Formatuuid

Request Body

application/json
  1. body
angle_id?string

New line: the angle it argues.

Match^([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)$
Formatuuid
kind?string

New line: its kind.

Value in"hook""headline""primary_text""objection"
text*string
Length1 <= length <= 2000
verbatim_ids?array<>

New line: ids of the quotes it was written from. Optional.

Itemsitems <= 10
status?string

Draft by default. approved makes it available to prefill launches.

Value in"draft""approved"

Response Body

Success. The body is the tool's own result — the same payload the MCP tool returns.

application/json
  1. response
Example Request
curl -X PATCH 'https://winandscale.com/api/v1/research/messaging/497f6eca-6276-4993-bfeb-53cbbbba6f08' \  -H 'Content-Type: application/json' \  -d '{  "text": "string"}'
Example Response
{}