generated: '2026-08-15'
method: derived
source: openapi/*.json (15 harvested specs, every documented operation) + https://reference.humanapi.co/llms.txt
note: >-
  Entity-relationship graph for the Health Intelligence Platform (HIP) Admin API, derived
  from the harvested OpenAPI schemas and the documented endpoint surface. Identifiers:
  humanId (Human API user id), orderId (uuid), reportId (uuid), subscriptionId. Regenerated
  2026-08-15 against the full 15-operation spec set - the earlier round saw only 5 operations,
  so the Subscription, Report-by-id, Provider and Resource edges were documented from the
  reference index rather than from schemas. They are now backed by harvested OpenAPI.
entities:
- name: User
  id: humanId
  also: clientUserId
  fields: [firstName, lastName, dateOfBirth, humanId, clientUserEmail, status, suggestedSources, inviteLink, createdAt, updatedAt]
  operations: [getUsersList, createUser, getUserDetails, performActionForUser]
- name: Provider
  belongs_to: User
  operations: [userProviders]
- name: OrderType
  operations: [getOrderTypes]
- name: Order
  id: orderId
  note: An EHR retrieval request; transitions through the fulfillment lifecycle.
- name: Subscription
  id: subscriptionId
  operations: [getUsersSubscriptions, createSubscription, getSubscriptionDetails, deleteSubscription]
- name: Report
  id: reportId
  also: createdByOrderId
  fields: [individualReportGroup, combinedReportGroup, individualReportInfo, combinedReportInfo]
  operations: [getUserReports, getReportById]
- name: Resource
  operations: [getTasksLiistLink]
  note: operationId is misspelled in the provider's own spec; preserved verbatim.
relationships:
- from: Order
  to: User
  kind: belongs_to
  via: humanId
- from: Report
  to: Order
  kind: belongs_to
  via: createdByOrderId
- from: Report
  to: User
  kind: belongs_to
  via: humanId
- from: User
  to: Provider
  kind: has_many
- from: User
  to: Report
  kind: has_many
- from: Subscription
  to: User
  kind: belongs_to
  via: humanId
schemas_harvested:
- { entity: user, spec: openapi/human-api-admin-users-list-openapi.json, schema: user }
- { entity: user, spec: openapi/human-api-admin-user-create-openapi.json, schema: user }
- { entity: subscription, spec: openapi/human-api-admin-subscription-create-openapi.json, schema: subscription }
- { entity: error, spec: openapi/*.json, schema: error }
- { entity: error, spec: openapi/human-api-admin-user-create-openapi.json, schema: errorInvalidInput }
subscription_shape:
  fields: [clientUserId, subscriberEmail, subscriberFirstName, subscriberLastName, subscriberOffice, role]
  note: >-
    A Subscription binds a NAMED HUMAN (an agent or case manager, by email and role) to a
    case identified by clientUserId - it is a people-notification record, not a webhook
    endpoint registration.
render: null