latestOpenAPI 3.1.02026-08-194237902.5 MB

563848e0ecc0

Specialty

Create a NUCC taxonomy specialty entry

Creates a new NUCC (National Uniform Claim Committee) taxonomy specialty entry for the tenant. NUCC specialties represent standardized provider taxonomy codes used in claim and credentialing workflows, and are distinct from the general medical specialties managed via POST /specialties.

When to use: Use this endpoint when you need to add a tenant-level NUCC taxonomy specialty record. For general (non-NUCC) specialties use POST /specialties.

Preconditions: Requires the CREATE_SPECIALTY permission. The tenant-id header must be supplied. The request body contains only a data object, which is validated against the NuccSpecialty JSON Schema before storage — a schema violation returns 400. The createdBy and updatedBy audit fields are both automatically set to the authenticated user's ID from the JWT at creation time; they are not accepted in the request body.

Result: Returns 201 with the created NUCC specialty object, including the server-assigned id (a UUID-format string generated by the data layer). Not idempotent — repeat calls create duplicate entries. 400 is returned for either JSON Schema validation failure or a downstream data-layer error.

post/specialties/nucc

Headers

tenant-idstring required

Request body

Response

The NUCC specialty entry was created; the response body is the new record with its server-assigned ID.

idstring

Server-assigned NUCC specialty identifier.

createdAtstring date

Date the record was created.

createdBystring

ID of the user who created the record.

updatedAtstring date

Date the record was last updated.

updatedBystring

ID of the user who last updated the record.