Get Media Config

matrix.get_media_config
ActionChat & messagingconnection required

Calls the Matrix API with the connection's credentials.

Read the homeserver's media limits, including the maximum upload size.

Connection

Required
Yes — the node will not save without one
Auth type
Bearer token
Providers
Matrix
Secret shape
the account access token, or {"access_token": "…"}
Config it needs
base_url, user_id, default_room_id
Resolved by
config.connection_id, else node.connection_id

Configuration

This node takes no configuration beyond its connection.

Output

One shape.

result

FieldTypeExample
upload_size
The largest upload the homeserver accepts, in bytes; absent when the server publishes no limit.
number—
{
  "upload_size": 0
}

Notes

  • The connection's base_url is the homeserver (e.g. https://matrix.example.org), not the account's server name; the two differ whenever .well-known delegation is in use.
  • Rooms are addressed by room id (!abc:server). Resolve a #alias:server with matrix.resolve_room_alias first, or set a default room on the connection.
  • Uses the authenticated media API, which homeservers implement from Matrix 1.11; an older homeserver answers 404 here.

See Get Media Config run in a workflow.

In a technical demo we add the Matrix connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.