latestOpenAPI 3.1.02026-08-194237902.5 MB

563848e0ecc0

Tenant Specialty

Fetch a single tenant specialty by its ID

Returns the detail of a single tenant specialty record belonging to the tenant identified by the tenant-id header.

What it does: Retrieves one tenant specialty by its unique identifier, including its tenant-specific metadata (display name, description, change reason).

When to use: Use this when you already hold the id of a tenant specialty (for example, from a prior GET /tenant-specialties response) and need its detail. Do not use this as a lookup-by-name or lookup-by-classification — use the list or by-classification endpoints for those.

How to call it: Supply the required tenant-id header and the tenant specialty id as a path segment. id is an opaque, server-assigned string (assigned as a UUIDv4 by the data layer at creation time); the API does not otherwise constrain its format. Requires the READ_TENANT_SPECIALTY permission.

What you get back: The tenant specialty's entity content (display name, description, change reason) on 200. Returns 404 if no specialty with the given id exists for the supplied tenant-id.

get/tenant-specialties/{id}

Path parameters

idstring required

Opaque, server-assigned identifier of the tenant specialty to retrieve.

Headers

tenant-idstring required

Tenant identifier that scopes the lookup.

Response

The tenant specialty matching the given id.