Tools that change things say so

Every tool carries annotations. A client reads them to decide whether to ask you before making a call.

The three shapes

• Read-only — it looks, and changes nothing.
• Additive — it creates something new and leaves what exists alone.
• Destructive — it changes or removes something that is already there.

The middle label is the one that is easy to get wrong. Creating a post is not destructive. Updating one is, because the previous text is gone.