TransaktDocs

organisation.tenant_already_covered

Creating an organisation while another organisation of the partner already holds the caller's tenant. A matching email domain never refuses creation; it only suggests that organisation.

Codeorganisation.tenant_already_covered
HTTP status409
CategoryConflict
ArgumentsorganisationName, reason (TenantLinked)

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:

{organisationName} already uses your Microsoft tenant. Ask one of its owners to invite you.

Example response

application/problem+json
{
  "type": "https://docs.test.konsolutelab.uk/errors/organisation.tenant_already_covered",
  "title": "…",
  "status": 409,
  "code": "organisation.tenant_already_covered",
  "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.