/v1/blasts/{id}Change a blast's words
Edits a blast that is still a draft: name, subject, body, goal, sendFrom, templateId, audienceFilter. An absent field leaves the column alone, and goal: "" clears the goal. sendFrom is the line the copies leave on, one of get_comms_senders; sendFrom: "" goes back to the workspace's default. goal is what a reply to the blast should lead to and is what Neo is handed when a recipient answers. subject and body may carry merge fields and either/ors ({{first_name|lead.name|"there"}}); something that looks like a field and is not one is refused here rather than sent as typed. Past draft the words are frozen with the audience — a scheduled or sent blast is the record of what a workspace said to a list of people, so the edit is refused rather than rewriting history. Who it reaches is a separate act (post_blasts_id_audience), also draft-only.
Access class: workspace.
Send request
Use the documented inputs to call this endpoint directly.
Parameters
Values are applied to the request and the example on the right.
Request body
application/jsonrequiredResponses
the action's answer
{
"data": {
"audienceFilter": {},
"audienceFrozenAt": "2026-01-01T00:00:00Z",
"body": "string",
"bodyFormat": "string",
"cancellationReason": "string",
"cancelledAt": "2026-01-01T00:00:00Z",
"createdAt": "2026-01-01T00:00:00Z",
"createdByUserId": 1,
"detail": {},
"goal": "string",
"id": 1,
"kind": "string",
"name": "string",
"retargetOfBlastId": 1,
"scheduledAt": "2026-01-01T00:00:00Z",
"sendFrom": "string",
"sentAt": "2026-01-01T00:00:00Z",
"status": "string",
"subject": "string",
"templateId": 1,
"updatedAt": "2026-01-01T00:00:00Z"
}
}a refusal: {"error": "<what a person needs to read>"}. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.
{
"error": "string"
}