POST /api/internal/node-exec/: execute a single node function.
Body: {
node_type: str, # e.g. "action_slack_send_message"
capability_name: str, # alternative: "exec_slack_send_message"
space_id: str,
config: dict, # node config
org_id: str, # optional, falls back to header
describe: bool, # true returns return the node's config schema, run nothing
max_chars: int, # optional cap on the serialized result size
}Returns the node handler's output directly. An unknown node_type answers 400 with suggestions (closest registered names). When the registry declares required config keys, a config missing them answers 400 missing_config BEFORE any credit is metered.
URL
- Service tierhttps://automations.mattering.io/api/internal/node-exec/
Body keys (JSON)
| Key | Required | Default |
|---|---|---|
allowed_connector_node_types | optional or conditional | none |
allowed_connector_slugs | optional or conditional | none |
capability_name | optional or conditional | none |
config | optional or conditional | {} |
describe | optional or conditional | none |
execution_payload | optional or conditional | none |
max_chars | optional or conditional | none |
node_type | optional or conditional | none |
org_id | optional or conditional | none |
space_id | optional or conditional | none |
Keys the view reads. A key not in this list is ignored by the view. Where a key is required only for some actions (for example the action dispatch), the description above says which.
Responses
200 bare JSON object (no envelope)
...
200 bare JSON object (no envelope)
{
"node": "...",
"executed": false
}
Field names come from the code; values are placeholders (... is a string, 0 a number, dates are ISO 8601).
Errors
| Status | Code |
|---|---|
| 400 | missing_config |
| 400 | node_type or capability_name is required message |
| 400 | org_context_required |
| 402 | credits_exhausted |
| 403 | connector_node_not_allowed |
| 403 | connector_not_allowed |
Example
curl -X POST "https://automations.mattering.io/api/internal/node-exec/" \
-H "X-Internal-Secret: $MATTERING_INTERNAL_API_SECRET" \
-H "X-Internal-Org-Id: $ORG_ID" \
-H "X-Internal-User-Email: you@example.com" \
-H "Content-Type: application/json" \
-d '{
"allowed_connector_node_types": "...",
"allowed_connector_slugs": "...",
"capability_name": "...",
"config": {},
"describe": "...",
"execution_payload": "...",
"max_chars": "...",
"node_type": "..."
}'
Source: AutomationsCore/agent_bridge_views.py (agent_bridge_views.node_exec)