Contents

API reference / Actions

Edit a proposal's text

PATCH /api/v1/actions/{action}

update_action Write MCP tool

Change the wording of a draft or proposed action before a person approves it: an issue's title and body, an outreach email's subject and body, a meeting offer's text. What a message or a routing sends cannot be edited: reject it and propose it again. The person approving sees the edited text, and an approval of the earlier version is refused.

A full-access key (ss_sk_…), or an editor or owner signed in.

Parameters

NameTypeDescription
action required
path
string The action's id.

Request body

JSON, sent with Content-Type: application/json.

NameTypeDescription
title string
up to 250 characters
An issue's title.
subject string
up to 250 characters
An outreach email's subject.
body string
up to 20000 characters
An issue's or an outreach email's body.
text string
up to 20000 characters
A meeting offer's text.

Returns

{ data: Action }

Example

curl -X PATCH "https://sniffington.com/api/v1/actions/{action}" \
  -H "Authorization: Bearer $SCOUT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"…","subject":"…"}'