Menu

Mattering Platform API

The file service (every upload in every app is a managed file) and the organization custom field registry.

User APIhttps://platform.mattering.io/api/user/v1/ Service tierhttps://platform.mattering.io/api/internal/ 22 MCP tools
On the user tier every lookup is scoped to the caller's organization and the raw storage path surfaces (register, serve-by-path) answer 403 internal_only.

Resources

53 endpoints, 43 on the User API, 10 service-only.

ResourceEndpointsMethodsTiers
Custom fields 7 GETPOST User API
Files 33 GETPOSTDELETE User API
Folders 3 GETPOST 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
V1 10 GETPOST

MCP tools

The Mattering MCP gateway exposes 22 tools for Platform. Each wraps one of the endpoints above on the User API, forwarding your token.

See the Platform MCP tools

Shape against the shared standard

Mattering is converging every app on one API shape (the Base API Template). This is where Platform 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 40 of 53 endpoints
Not yet Collection reads paginate with meta.total 2 of 18 list endpoints paginate; hard caps on 13
Not yet Errors carry a snake_case code and a detail 160 of 182 error returns use a stable code

Unpaginated reads with a hard cap (results beyond the cap are not returned and no total is reported): files/create/ (120), files/google/ (100), files/manage/ (255), files/native/image/ (200), files/native/model/ (500), files/people/ (50), files/shares/manage/ (160), files/upload/finish/ (200), files/upload/session/ (200), files/upload/start/ (200), files/versions/manage/ (255), files/{file_id}/ops/ (120), folders/manage/ (255).

Source: files/api_urls.py, custom_fields/api_urls.py, platform_app/data_rights_urls.py, platform_app/notification_urls.py. Regenerated by tools/build_api_docs.py.

Start Free Explore our Products