Menu

Mattering Auth API

Login, tokens, JWKS, organizations, teams, workspaces, apps, entitlements, plans and organization API keys. Django REST Framework class-based views.

User APIhttps://auth.mattering.io/api/ Service tierhttps://auth.mattering.io/api/internal/
Auth is the grandfathered Django REST Framework service. Its public tier lives at /api/ (no v1 segment) and accepts a Bearer JWT, a mat_ organization key, an OAuth2 token, or the X-API-Key / X-API-Secret pair on the public app directory.
Response bodies are DRF serializer output, not the {data, meta} envelope. Errors are {error: message} without a stable code.

Resources

61 endpoints, 36 on the User API, 25 service-only.

ResourceEndpointsMethodsTiers
Accounts 12 GETPOSTPUT User API
API keys 2 GETPOSTPATCHDELETE User API
Apps 9 GETPOSTPUTDELETE User API
Organizations 7 GETPOSTDELETE User API
Plans 4 GETPOST User API
Teams 5 GETPOSTPATCHDELETE User API
Workspaces 14 GETPOSTPUTDELETE 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
Service 8 GETPOST

Shape against the shared standard

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

Not yet 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 0 of 61 endpoints
Not yet Collection reads paginate with meta.total 0 of 19 list endpoints paginate; hard caps on 1
Not yet Errors carry a snake_case code and a detail 51 of 122 error returns use a stable code

Unpaginated reads with a hard cap (results beyond the cap are not returned and no total is reported): workspaces/{public_id}/agents/set/ (30).

Source: mattering_auth/urls.py, mattering_auth/internal_urls.py. Regenerated by tools/build_api_docs.py.

Start Free Explore our Products