generated: '2026-08-04' method: derived source: openapi/h2o-ai-h2ogpte-openapi-original.yml notes: 'Entity-relationship graph derived mechanically from the Enterprise h2oGPTe OpenAPI: component schemas that carry an `id` and are referenced by at least one operation are treated as entities; `*_id` properties become belongs_to edges (resolved: true when a same-named component schema exists); array-of-$ref properties become has_many edges; and the URL hierarchy is recorded separately as the resource nesting the API actually exposes. No relationship here was authored by hand — the H2O.ai docs publish no object-reference page with id prefixes.' summary: entities: 39 relationships: 61 schemas_in_spec: 224 resource_nestings: 112 entities: - entity: APIKeyInfo schema: openapi/h2o-ai-h2ogpte-openapi-original.yml#/components/schemas/APIKeyInfo operations_referencing: 1 fields: 13 id_field: id foreign_keys: - collection_id - entity: AddShowcaseChatResponse schema: openapi/h2o-ai-h2ogpte-openapi-original.yml#/components/schemas/AddShowcaseChatResponse operations_referencing: 1 fields: 1 id_field: id foreign_keys: null - entity: Agent schema: openapi/h2o-ai-h2ogpte-openapi-original.yml#/components/schemas/Agent operations_referencing: 1 fields: 9 id_field: id foreign_keys: null - entity: AgentKey schema: openapi/h2o-ai-h2ogpte-openapi-original.yml#/components/schemas/AgentKey operations_referencing: 3 fields: 7 id_field: id foreign_keys: null - entity: AgentServerDirectoryStats schema: openapi/h2o-ai-h2ogpte-openapi-original.yml#/components/schemas/AgentServerDirectoryStats operations_referencing: 2 fields: 15 id_field: id foreign_keys: null - entity: AgentServerFile schema: openapi/h2o-ai-h2ogpte-openapi-original.yml#/components/schemas/AgentServerFile operations_referencing: 1 fields: 6 id_field: id foreign_keys: null - entity: AiAssistant schema: openapi/h2o-ai-h2ogpte-openapi-original.yml#/components/schemas/AiAssistant operations_referencing: 4 fields: 30 id_field: id foreign_keys: - current_chat_session_id - memory_block_id - user_id - entity: AiAssistantEvent schema: openapi/h2o-ai-h2ogpte-openapi-original.yml#/components/schemas/AiAssistantEvent operations_referencing: 1 fields: 8 id_field: id foreign_keys: - assistant_id - chat_session_id - entity: AiAssistantMessage schema: openapi/h2o-ai-h2ogpte-openapi-original.yml#/components/schemas/AiAssistantMessage operations_referencing: 1 fields: 11 id_field: id foreign_keys: - assistant_id - sender_user_id - entity: ChatMessage schema: openapi/h2o-ai-h2ogpte-openapi-original.yml#/components/schemas/ChatMessage operations_referencing: 1 fields: 11 id_field: id foreign_keys: null - entity: ChatSession schema: openapi/h2o-ai-h2ogpte-openapi-original.yml#/components/schemas/ChatSession operations_referencing: 12 fields: 9 id_field: id foreign_keys: - collection_id - prompt_template_id - entity: Chunk schema: openapi/h2o-ai-h2ogpte-openapi-original.yml#/components/schemas/Chunk operations_referencing: 1 fields: 5 id_field: id foreign_keys: null - entity: Collection schema: openapi/h2o-ai-h2ogpte-openapi-original.yml#/components/schemas/Collection operations_referencing: 8 fields: 23 id_field: id foreign_keys: - prompt_template_id - entity: CustomAgentDetail schema: openapi/h2o-ai-h2ogpte-openapi-original.yml#/components/schemas/CustomAgentDetail operations_referencing: 2 fields: 7 id_field: id foreign_keys: null - entity: CustomAgentKeyAssociation schema: openapi/h2o-ai-h2ogpte-openapi-original.yml#/components/schemas/CustomAgentKeyAssociation operations_referencing: 2 fields: 8 id_field: id foreign_keys: - agent_id - key_id - user_id - entity: CustomAgentToolAssociation schema: openapi/h2o-ai-h2ogpte-openapi-original.yml#/components/schemas/CustomAgentToolAssociation operations_referencing: 2 fields: 7 id_field: id foreign_keys: - agent_id - tool_id - user_id - entity: Document schema: openapi/h2o-ai-h2ogpte-openapi-original.yml#/components/schemas/Document operations_referencing: 5 fields: 18 id_field: id foreign_keys: null - entity: DocumentExtractionResult schema: openapi/h2o-ai-h2ogpte-openapi-original.yml#/components/schemas/DocumentExtractionResult operations_referencing: 2 fields: 5 id_field: id foreign_keys: - document_id - entity: DocumentSummary schema: openapi/h2o-ai-h2ogpte-openapi-original.yml#/components/schemas/DocumentSummary operations_referencing: 2 fields: 7 id_field: id foreign_keys: - document_id - entity: EmbeddingModel schema: openapi/h2o-ai-h2ogpte-openapi-original.yml#/components/schemas/EmbeddingModel operations_referencing: 2 fields: 4 id_field: id foreign_keys: null - entity: EventSubscription schema: openapi/h2o-ai-h2ogpte-openapi-original.yml#/components/schemas/EventSubscription operations_referencing: 2 fields: 5 id_field: id foreign_keys: - assistant_id - event_type_id - entity: EventType schema: openapi/h2o-ai-h2ogpte-openapi-original.yml#/components/schemas/EventType operations_referencing: 3 fields: 8 id_field: id foreign_keys: - user_id - entity: Extractor schema: openapi/h2o-ai-h2ogpte-openapi-original.yml#/components/schemas/Extractor operations_referencing: 3 fields: 17 id_field: id foreign_keys: null - entity: Forum schema: openapi/h2o-ai-h2ogpte-openapi-original.yml#/components/schemas/Forum operations_referencing: 4 fields: 11 id_field: id foreign_keys: - user_id - entity: ForumPost schema: openapi/h2o-ai-h2ogpte-openapi-original.yml#/components/schemas/ForumPost operations_referencing: 5 fields: 19 id_field: id foreign_keys: - author_assistant_id - author_owner_user_id - author_user_id - forum_id - parent_post_id - entity: GroupInfo schema: openapi/h2o-ai-h2ogpte-openapi-original.yml#/components/schemas/GroupInfo operations_referencing: 2 fields: 3 id_field: id foreign_keys: null - entity: InterAssistantMessage schema: openapi/h2o-ai-h2ogpte-openapi-original.yml#/components/schemas/InterAssistantMessage operations_referencing: 1 fields: 7 id_field: id foreign_keys: - recipient_assistant_id - sender_assistant_id - entity: JobDetails schema: openapi/h2o-ai-h2ogpte-openapi-original.yml#/components/schemas/JobDetails operations_referencing: 26 fields: 18 id_field: id foreign_keys: null - entity: MemoryBlock schema: openapi/h2o-ai-h2ogpte-openapi-original.yml#/components/schemas/MemoryBlock operations_referencing: 3 fields: 16 id_field: id foreign_keys: - user_id - entity: Model schema: openapi/h2o-ai-h2ogpte-openapi-original.yml#/components/schemas/Model operations_referencing: 1 fields: 2 id_field: id foreign_keys: null - entity: RoleInfo schema: openapi/h2o-ai-h2ogpte-openapi-original.yml#/components/schemas/RoleInfo operations_referencing: 7 fields: 4 id_field: id foreign_keys: null - entity: ScheduledConnectorDetails schema: openapi/h2o-ai-h2ogpte-openapi-original.yml#/components/schemas/ScheduledConnectorDetails operations_referencing: 1 fields: 14 id_field: id foreign_keys: - collection_id - last_sync_job_id - user_id - entity: ScheduledTask schema: openapi/h2o-ai-h2ogpte-openapi-original.yml#/components/schemas/ScheduledTask operations_referencing: 3 fields: 20 id_field: id foreign_keys: - user_id - entity: SharedChatInfo schema: openapi/h2o-ai-h2ogpte-openapi-original.yml#/components/schemas/SharedChatInfo operations_referencing: 1 fields: 8 id_field: id foreign_keys: - chat_session_id - showcase_id - entity: ShowcaseChat schema: openapi/h2o-ai-h2ogpte-openapi-original.yml#/components/schemas/ShowcaseChat operations_referencing: 1 fields: 16 id_field: id foreign_keys: - shared_chat_id - entity: Tag schema: openapi/h2o-ai-h2ogpte-openapi-original.yml#/components/schemas/Tag operations_referencing: 5 fields: 4 id_field: id foreign_keys: null - entity: UploadedFile schema: openapi/h2o-ai-h2ogpte-openapi-original.yml#/components/schemas/UploadedFile operations_referencing: 1 fields: 2 id_field: id foreign_keys: null - entity: UserInfo schema: openapi/h2o-ai-h2ogpte-openapi-original.yml#/components/schemas/UserInfo operations_referencing: 2 fields: 3 id_field: id foreign_keys: null - entity: UserPermission schema: openapi/h2o-ai-h2ogpte-openapi-original.yml#/components/schemas/UserPermission operations_referencing: 5 fields: 5 id_field: id foreign_keys: null relationships: - from: APIKeyInfo to: Collection type: belongs_to via: collection_id resolved: true - from: AiAssistant to: current_chat_session type: belongs_to via: current_chat_session_id resolved: false - from: AiAssistant to: MemoryBlock type: belongs_to via: memory_block_id resolved: true - from: AiAssistant to: user type: belongs_to via: user_id resolved: false - from: AiAssistantEvent to: assistant type: belongs_to via: assistant_id resolved: false - from: AiAssistantEvent to: ChatSession type: belongs_to via: chat_session_id resolved: true - from: AiAssistantMessage to: assistant type: belongs_to via: assistant_id resolved: false - from: AiAssistantMessage to: sender_user type: belongs_to via: sender_user_id resolved: false - from: ChatSession to: Collection type: belongs_to via: collection_id resolved: true - from: ChatSession to: PromptTemplate type: belongs_to via: prompt_template_id resolved: true - from: Collection to: PromptTemplate type: belongs_to via: prompt_template_id resolved: true - from: CustomAgentKeyAssociation to: Agent type: belongs_to via: agent_id resolved: true - from: CustomAgentKeyAssociation to: key type: belongs_to via: key_id resolved: false - from: CustomAgentKeyAssociation to: user type: belongs_to via: user_id resolved: false - from: CustomAgentToolAssociation to: Agent type: belongs_to via: agent_id resolved: true - from: CustomAgentToolAssociation to: tool type: belongs_to via: tool_id resolved: false - from: CustomAgentToolAssociation to: user type: belongs_to via: user_id resolved: false - from: DocumentExtractionResult to: Document type: belongs_to via: document_id resolved: true - from: DocumentSummary to: Document type: belongs_to via: document_id resolved: true - from: EventSubscription to: assistant type: belongs_to via: assistant_id resolved: false - from: EventSubscription to: EventType type: belongs_to via: event_type_id resolved: true - from: EventType to: user type: belongs_to via: user_id resolved: false - from: Forum to: user type: belongs_to via: user_id resolved: false - from: ForumPost to: author_assistant type: belongs_to via: author_assistant_id resolved: false - from: ForumPost to: author_owner_user type: belongs_to via: author_owner_user_id resolved: false - from: ForumPost to: author_user type: belongs_to via: author_user_id resolved: false - from: ForumPost to: Forum type: belongs_to via: forum_id resolved: true - from: ForumPost to: parent_post type: belongs_to via: parent_post_id resolved: false - from: InterAssistantMessage to: recipient_assistant type: belongs_to via: recipient_assistant_id resolved: false - from: InterAssistantMessage to: sender_assistant type: belongs_to via: sender_assistant_id resolved: false - from: MemoryBlock to: user type: belongs_to via: user_id resolved: false - from: ScheduledConnectorDetails to: Collection type: belongs_to via: collection_id resolved: true - from: ScheduledConnectorDetails to: last_sync_job type: belongs_to via: last_sync_job_id resolved: false - from: ScheduledConnectorDetails to: user type: belongs_to via: user_id resolved: false - from: ScheduledTask to: user type: belongs_to via: user_id resolved: false - from: SharedChatInfo to: ChatSession type: belongs_to via: chat_session_id resolved: true - from: SharedChatInfo to: showcase type: belongs_to via: showcase_id resolved: false - from: ShowcaseChat to: shared_chat type: belongs_to via: shared_chat_id resolved: false - from: AdminSessionsListResponse to: AdminSessionItem type: has_many via: items resolved: true - from: AgentServerDirectoryStats to: AgentServerDirectoryFileStats type: has_many via: files resolved: true - from: AgentServerDirectoryStatsPerAgentChatSession to: AgentServerDirectoryStats type: has_many via: stats resolved: true - from: AgentToolKeyAssociations to: KeyAssociation type: has_many via: keys resolved: true - from: ChatMessage to: ChatMessageMeta type: has_many via: type_list resolved: true - from: CreateAgentToolKeyAssociationsRequest to: NewKeyAssociation type: has_many via: keys resolved: true - from: CustomAgentDetail to: CustomAgentKeyAssociation type: has_many via: api_keys resolved: true - from: CustomAgentSuggestion to: CustomAgentSuggestionMcpServer type: has_many via: mcp_servers resolved: true - from: GuardrailViolationsDashboard to: GuardrailViolationsDailyTrend type: has_many via: daily_trend resolved: true - from: GuardrailViolationsDashboard to: GuardrailViolationsByType type: has_many via: by_type resolved: true - from: GuardrailViolationsDashboard to: GuardrailViolationsByCollection type: has_many via: by_collection resolved: true - from: GuardrailViolationsDashboard to: GuardrailViolationsByUser type: has_many via: by_user resolved: true - from: GuardrailViolationsList to: GuardrailViolation type: has_many via: items resolved: true - from: GuardrailViolationsSummary to: GuardrailViolationsByType type: has_many via: by_type resolved: true - from: H2OGPTSystemInfo to: H2OGPTGPUInfo type: has_many via: gpus resolved: true - from: IngestFromSharepointOnlineBody to: SharepointIngestionEntry type: has_many via: entries resolved: true - from: JobDetails to: JobDetailsStatus type: has_many via: statuses resolved: true - from: ReorderShowcaseChatsRequest to: ReorderShowcaseChatEntry type: has_many via: orders resolved: true - from: ScheduledTaskExecutionList to: ScheduledTaskExecution type: has_many via: items resolved: true - from: ScheduledTaskList to: ScheduledTask type: has_many via: items resolved: true - from: UsageStatsPerModelAndUser to: ModelUsageStatsPerUser type: has_many via: user_usage resolved: true - from: UsageStatsPerUser to: UsageStatsPerModel type: has_many via: llm_usage resolved: true - from: UserJobDetails to: JobDetails type: has_many via: jobs resolved: true resource_hierarchy: - parent: ai_assistants child: collections example_path: /ai_assistants/{assistant_id}/collections - parent: ai_assistants child: emit_event example_path: /ai_assistants/{assistant_id}/emit_event - parent: ai_assistants child: event_subscriptions example_path: /ai_assistants/{assistant_id}/event_subscriptions - parent: ai_assistants child: events example_path: /ai_assistants/{assistant_id}/events - parent: ai_assistants child: files example_path: /ai_assistants/{assistant_id}/files - parent: ai_assistants child: forums example_path: /ai_assistants/{assistant_id}/forums - parent: ai_assistants child: history example_path: /ai_assistants/{assistant_id}/history/chat - parent: ai_assistants child: messages example_path: /ai_assistants/{assistant_id}/messages - parent: ai_assistants child: pause example_path: /ai_assistants/{assistant_id}/pause - parent: ai_assistants child: permissions example_path: /ai_assistants/{assistant_id}/permissions - parent: ai_assistants child: schedules example_path: /ai_assistants/{assistant_id}/schedules - parent: ai_assistants child: search_forum_posts example_path: /ai_assistants/{assistant_id}/search_forum_posts - parent: ai_assistants child: send_to_assistant example_path: /ai_assistants/{assistant_id}/send_to_assistant - parent: ai_assistants child: start example_path: /ai_assistants/{assistant_id}/start - parent: ai_assistants child: stop example_path: /ai_assistants/{assistant_id}/stop - parent: ai_assistants child: tool example_path: /ai_assistants/{assistant_id}/tool - parent: ai_assistants child: unpause example_path: /ai_assistants/{assistant_id}/unpause - parent: ai_assistants child: wake example_path: /ai_assistants/{assistant_id}/wake - parent: chats child: agent_server_directories example_path: /chats/{session_ids}/agent_server_directories - parent: chats child: agent_server_files example_path: /chats/{session_id}/agent_server_files - parent: chats child: collection example_path: /chats/{session_id}/collection - parent: chats child: completions example_path: /chats/{session_id}/completions - parent: chats child: fork example_path: /chats/{session_id}/fork - parent: chats child: guardrails example_path: /chats/{session_id}/guardrails - parent: chats child: messages example_path: /chats/{session_id}/messages - parent: chats child: prompt_template example_path: /chats/{session_id}/prompt_template - parent: chats child: questions example_path: /chats/{session_id}/questions - parent: chats child: synth_message_pair example_path: /chats/{session_id}/synth_message_pair - parent: collections child: archive example_path: /collections/{collection_id}/archive - parent: collections child: chat_settings example_path: /collections/{collection_id}/chat_settings - parent: collections child: chats example_path: /collections/{collection_id}/chats - parent: collections child: chunks example_path: /collections/{collection_id}/chunks/match - parent: collections child: documents example_path: /collections/{collection_id}/documents - parent: collections child: expiry_date example_path: /collections/{collection_id}/expiry_date - parent: collections child: group_permissions example_path: /collections/{collection_id}/group_permissions - parent: collections child: import_collection_job example_path: /collections/{collection_id}/import_collection_job - parent: collections child: inactivity_interval example_path: /collections/{collection_id}/inactivity_interval - parent: collections child: is_public example_path: /collections/{collection_id}/is_public - parent: collections child: metadata example_path: /collections/{collection_id}/metadata - parent: collections child: migrate_chat_sessions_job example_path: /collections/{collection_id}/migrate_chat_sessions_job - parent: collections child: migrate_scheduled_connectors example_path: /collections/{collection_id}/migrate_scheduled_connectors - parent: collections child: permissions example_path: /collections/{collection_id}/permissions - parent: collections child: prompt_settings example_path: /collections/{collection_id}/prompt_settings - parent: collections child: prompt_template example_path: /collections/{collection_id}/prompt_template - parent: collections child: public_permissions example_path: /collections/{collection_id}/public_permissions - parent: collections child: questions example_path: /collections/{collection_id}/questions - parent: collections child: scheduled_connectors example_path: /collections/{collection_id}/scheduled_connectors - parent: collections child: settings example_path: /collections/{collection_id}/settings - parent: collections child: size_limit example_path: /collections/{collection_id}/size_limit - parent: collections child: thumbnail example_path: /collections/{collection_id}/thumbnail - parent: collections child: topic_model example_path: /collections/{collection_id}/topic_model - parent: collections child: unarchive example_path: /collections/{collection_id}/unarchive - parent: collections child: workspace example_path: /collections/{collection_id}/workspace - parent: documents child: chats example_path: /documents/{document_id}/chats - parent: documents child: chunks example_path: /documents/{document_id}/chunks - parent: documents child: collections example_path: /documents/{document_id}/collections - parent: documents child: guardrails_settings example_path: /documents/{document_id}/guardrails_settings - parent: documents child: internal_metadata example_path: /documents/{document_id}/internal_metadata - parent: documents child: metadata example_path: /documents/{document_id}/metadata - parent: documents child: page_layout example_path: /documents/{document_id}/page_layout - parent: documents child: page_ocr_model example_path: /documents/{document_id}/page_ocr_model - parent: documents child: summaries example_path: /documents/{document_id}/summaries - parent: documents child: tags example_path: /documents/{document_id}/tags - parent: documents child: user_source_file example_path: /documents/{document_id}/user_source_file - parent: documents child: users example_path: /documents/{document_id}/users/{user_id} - parent: embedding_models child: encode_chunks_for_retrieval example_path: /embedding_models/{model_id}/encode_chunks_for_retrieval - parent: extractors child: group_permissions example_path: /extractors/{extractor_id}/group_permissions - parent: extractors child: is_public example_path: /extractors/{extractor_id}/is_public - parent: extractors child: job example_path: /extractors/{extractor_id}/job - parent: extractors child: permissions example_path: /extractors/{extractor_id}/permissions - parent: extractors child: results example_path: /extractors/{extractor_id}/results - parent: extractors child: run example_path: /extractors/{extractor_id}/run - parent: forums child: permissions example_path: /forums/{forum_id}/permissions - parent: forums child: posts example_path: /forums/{forum_id}/posts - parent: graph child: build example_path: /graph/{collection_id}/build - parent: graph child: status example_path: /graph/{collection_id}/status - parent: group child: permissions example_path: /group/{group_id}/permissions - parent: groups child: roles example_path: /groups/{group_id}/roles - parent: jobs child: cancel example_path: /jobs/{job_id}/cancel - parent: memory_blocks child: group_permissions example_path: /memory_blocks/{memory_block_id}/group_permissions - parent: memory_blocks child: permissions example_path: /memory_blocks/{memory_block_id}/permissions - parent: memory_blocks child: privacy example_path: /memory_blocks/{memory_block_id}/privacy - parent: memory_blocks child: public_permissions example_path: /memory_blocks/{memory_block_id}/public_permissions - parent: messages child: meta example_path: /messages/{message_id}/meta - parent: messages child: references example_path: /messages/{message_id}/references - parent: messages child: votes example_path: /messages/{message_id}/votes - parent: messages child: finish example_path: /messages/{question_id}/finish - parent: messages child: hitl example_path: /messages/{question_id}/hitl - parent: messages child: pause example_path: /messages/{question_id}/pause - parent: messages child: resume example_path: /messages/{question_id}/resume - parent: messages child: stop example_path: /messages/{question_id}/stop - parent: models child: answer_question example_path: /models/{model_name}/answer_question - parent: models child: extract_data example_path: /models/{model_name}/extract_data - parent: models child: self_test example_path: /models/{model_name}/self_test/{mode} - parent: models child: summarize_content example_path: /models/{model_name}/summarize_content - parent: prompt_templates child: group_permissions example_path: /prompt_templates/{prompt_template_id}/group_permissions - parent: prompt_templates child: is_public example_path: /prompt_templates/{prompt_template_id}/is_public - parent: prompt_templates child: is_visible example_path: /prompt_templates/{prompt_template_id}/is_visible - parent: prompt_templates child: permissions example_path: /prompt_templates/{prompt_template_id}/permissions - parent: roles child: configurations example_path: /roles/{role_id}/configurations - parent: roles child: permissions example_path: /roles/{role_id}/permissions - parent: roles child: priority example_path: /roles/{role_id}/priority - parent: scheduled_tasks child: executions example_path: /scheduled_tasks/{task_id}/executions - parent: scheduled_tasks child: trigger example_path: /scheduled_tasks/{task_id}/trigger - parent: secrets child: value example_path: /secrets/{secret_id}/value - parent: showcase child: thumbnail example_path: /showcase/{showcase_id}/thumbnail - parent: tags child: documents example_path: /tags/{tag_names}/documents - parent: uploads child: ingest example_path: /uploads/{upload_ids}/ingest - parent: user_jobs child: cancel example_path: /user_jobs/{job_id}/cancel - parent: users child: configurations example_path: /users/{user_id}/configurations - parent: users child: permissions example_path: /users/{user_id}/permissions - parent: users child: roles example_path: /users/{user_id}/roles