TransaktDocs

entitlement.user_tenant_mismatch

Product API call with a user token whose tid differs from {tenantId}.

Codeentitlement.user_tenant_mismatch
HTTP status403
CategoryForbidden
ArgumentsNone (args is {})

What the portals show

The portals translate the code, never the title. The English (en-GB) message, in ICU format with the arguments as placeholders:

This person belongs to a different Microsoft tenant.

Example response

application/problem+json
{
  "type": "https://docs.test.konsolutelab.uk/errors/entitlement.user_tenant_mismatch",
  "title": "…",
  "status": 403,
  "code": "entitlement.user_tenant_mismatch",
  "args": {},
  "traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
  "instance": "/api/v1/…"
}

Handling it

Branch on code, not on title or the status alone, and log traceId. Codes are stable; new codes may appear, so fall back on the HTTP status for a code you do not know. See Handling errors and the list of codes.