Update Post
mattermost.update_post
ActionChat & messagingconnection required
Calls the Mattermost API with the connection's credentials.
Edit a post's message — and optionally its attachments or pinned state — leaving every other field as it was.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- Bearer token
- Providers
- Mattermost
- Secret shape
- the personal access token, or {"token": "…"}
- Config it needs
- base_url, team_id
- Resolved by
- config.connection_id, else node.connection_id
Configuration
5 fields, 2 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
post_id The post to edit. | string | Yes | — | — | — |
message The replacement markdown message. | string | Yes | — | — | — |
file_ids Replacement file ids, from mattermost.upload_file. | array | No | — | array of string | — |
props Replacement post props (JSON). | object | No | — | — | — |
is_pinned Pin or unpin the post in its channel. | boolean | No | — | — | — |
Output
One shape.
result
| Field | Type | Example |
|---|---|---|
id The post id. | string | pst1234567890abcdefghijklmn |
channel_id The channel the post belongs to. | string | — |
user_id The author — the token's user for a post this node made. | string | — |
message The post's markdown message. | string | — |
root_id The thread root, or an empty string for a top-level post. | string | — |
create_at Creation time, in milliseconds since the epoch. | number | — |
type The post type; empty for an ordinary user post. | string | — |
{
"channel_id": "",
"create_at": 0,
"id": "pst1234567890abcdefghijklmn",
"message": "",
"root_id": "",
"type": "",
"user_id": ""
}Notes
- This is Mattermost's partial update (PUT /posts/{id}/patch); the full PUT would blank every field the request omits.
See Update Post run in a workflow.
In a technical demo we add the Mattermost connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.