Skip to main content
String
A key you choose, up to 100 characters, that makes a retry safe. For 24 hours, repeating the request with the same key returns the first result and writes nothing; that result is null if it has since been deleted or hidden. The same key with a different request throws IDEMPOTENCY_KEY_REUSED (422): repeat the first request exactly, or use a new key. While the first request is still running, a repeat throws CONFLICT (409): retry with the same key in a moment. A request that fails without writing frees its key, so a retry runs it again. Each mutation has its own keys.
Parts of the macro to leave out, as an agent dismisses them in the composer.
ID
The thread the macro’s internal note goes on: one of the ticket’s threads. Required when a note is added; otherwise BAD_USER_INPUT. Ignored when none is.