Skip to main content
Version: 1.0.0

MDM Platform API

One governed record per real-world thing, served over HTTP.

Every request carries a bearer token and is answered in the scope of a single tenant: you reach only your own organisation's data, and only the parts your permissions allow. Values you may not see come back masked rather than omitted, so a response never quietly misleads you about what exists.

Base URL: /api/v1

Errors carry a machine-readable code, a message written for a person, the offending fields where that applies, and a trace identifier to quote when asking for help.

Pagination: ?page=1&pageSize=25 (maximum 100). Every list response reports the page, the page size, and the totals.

Sorting: ?sort=-createdAt,displayName — a leading - sorts descending.

Filtering: ?filter[status]=active

Authentication

JWT issued by the MDM auth service

Security Scheme Type:

http

HTTP Authorization Scheme:

bearer

Bearer format:

JWT

License

MIT