Update a message

Edit an unsent outbound message, and with send: true queue it for the launcher. Works on drafted, awaiting_approval and blocked messages; one already queued or sent answers 409.

PATCHhttps://app.trygtm.com/api/v1/messages/{message_id}

Scope: write
MCP tool: update_draft

Path parameters

message_idstringrequired: The draft's id, from read_conversation.

Headers

Idempotency-Keystringoptional: A key unique to this write, up to 255 characters. A retry carrying the same key returns the first response instead of running again. Kept for 24 hours.

Body

bodystringoptional: Replacement text.
subjectstringoptional: Replacement subject. Email only.
sendbooleanoptionaldefault: false: Release it for sending after the edit.

Request

curl -X PATCH https://app.trygtm.com/api/v1/messages/8f2a91c4-6d1e-4c0a-9a57-2f3b1c7e9d10 \
  -H "Authorization: Bearer $TRYGTM_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "body": "Tuesday at 10 works. I'll send an invite.",
    "send": false
  }'

Response

{
  "data": {
    "id": "aa11bb22-cc33-4d44-8e55-ff6677889900",
    "conversation_id": "0f1e2d3c-4b5a-4697-8877-665544332211",
    "direction": "outbound",
    "channel": "email",
    "kind": "message",
    "status": "queued",
    "subject": "Re: routing software",
    "body": "Tuesday at 10 works. I'll send an invite.",
    "gate_result": null,
    "error": null,
    "created_at": "2026-09-18T10:15:00.000Z",
    "updated_at": "2026-09-18T10:15:00.000Z"
  }
}