Menu

Mattering Automations API

Workspaces, Data Studio datatables, read-only node execution and agent invocation on the user tier; automations, secrets, connectors, telephony and the canvas builder on the service tier.

User APIhttps://automations.mattering.io/api/user/v1/ Service tierhttps://automations.mattering.io/api/internal/ 22 MCP tools
The user tier is deliberately narrow: workspaces, Data Studio and read-only node execution (query nodes only). Action nodes, secrets and connector management stay on the service tier.
Routes are registered by hand in the project urls.py rather than one api_urls.py mounted twice, and the versioned /api/internal/v1/ prefix is not used yet.

Resources

81 endpoints, 15 on the User API, 66 service-only.

ResourceEndpointsMethodsTiers
Agents 5 GETPOST User API
Data Studio 8 GETPOSTPATCHDELETE User API
Node execution 2 POST User API
Workspaces 2 GETPOSTPATCHDELETE User API

Service tier only

These resources are reachable with the internal secret only. They are documented for operators and for anyone reading the MCP tools that wrap them.

ResourceEndpointsMethods
Agent routines 3 GETPOST
Automations 2 GETPOSTDELETE
Canvas builder 11 GETPOST
Connectors 10 GETPOST
Org erasure 1 POST
Org export 1 POST
Search 1 GET
Secrets 19 GETPOSTDELETE
Telephony 14 GETPOSTPUT
User erasure 1 POST
User export 1 POST

MCP tools

The Mattering MCP gateway exposes 22 tools for Automations. Each wraps one of the endpoints above on the service tier, carrying your identity in headers.

See the Automations MCP tools

Shape against the shared standard

Mattering is converging every app on one API shape (the Base API Template). This is where Automations stands, measured from its code. Read it before assuming the envelope on one app matches another.

Yes User tier mounted (/api/user/v1/)
Not yet Internal tier versioned (/api/internal/v1/)
Not yet One api_urls.py included on both tiers
Not yet Responses use the {data, meta} envelope 28 of 81 endpoints
Not yet Collection reads paginate with meta.total 1 of 21 list endpoints paginate; hard caps on 14
Not yet Errors carry a snake_case code and a detail 88 of 151 error returns use a stable code

Unpaginated reads with a hard cap (results beyond the cap are not returned and no total is reported): automations/ (200), canvas-ai/create/ (2000), canvas-ai/node-types/ (117), canvas-ai/{automation_id}/configure-node/ (10), canvas-ai/{automation_id}/run/ (40), canvas-ai/{automation_id}/runs/ (10), connectors/v1/credentials/ (64), connectors/v1/instances/manage/ (64), connectors/v1/instances/{instance_id}/disconnect/ (64), data-studio/datatables/{datatable_id}/entries/bulk/ (100), node-exec/ (40), telephony/v1/numbers/buy/ (120), telephony/v1/numbers/search/ (10), telephony/v1/numbers/{public_id}/assign/ (120).

Source: AutomationsCore/urls.py. Regenerated by tools/build_api_docs.py.

Start Free Explore our Products