Edits

Use edit() to rewrite the content of a previously sent outbound message. Edits are fire-and-forget: space.send(edit(...)) resolves to undefined.

import { edit, text } from "spectrum-ts";

const sent = await space.send("Draft");
await space.send(edit(text("Final version"), sent));

edit() cannot wrap edit, reply, reaction, group, typing, rename, avatar, addMember, removeMember, leaveSpace, unsend, or read content. Provider constraints surface at send time. For example, a provider may reject edits after its native edit window closes.

Update an iMessage app card

iMessage app cards support in-place updates. Save the message returned by the original send and use it as the edit target:

import { app, edit } from "spectrum-ts";

const card = await space.send(app("https://example.com/status/pending"));

await space.send(
  edit(app("https://example.com/status/complete"), card)
);

The original send returns the message record that identifies the card. The edit itself returns undefined, so keep using card if you need to update it again. App-card updates require @spectrum-ts/imessage; they are not supported by @spectrum-ts/imessage-local. See App cards for live rendering and session details, or Customized mini-app cards when you own the iMessage extension.

Replies

Unsend

⌘I

Get started

Core concepts

Content

Providers

Advanced

Integrations

Best Practices

Troubleshooting

Update an iMessage app card

​Update an iMessage app card

Update an iMessage app card