H2O.ai

H2O.ai AI Assistants API

The AI Assistants API from H2O.ai — 30 operation(s) for ai assistants.

GitHub OpenAPI
Business capability
Artificial Intelligence Management BC-610.60

Operations 42

POST /ai_assistants Create an AI assistant #
GET /ai_assistants List AI assistants #
POST /ai_assistants/generate_spec Generate AI assistant spec from a prompt #
GET /ai_assistants/{assistant_id} Get an AI assistant by ID #
PUT /ai_assistants/{assistant_id} Update an AI assistant #
DELETE /ai_assistants/{assistant_id} Delete an AI assistant #
POST /ai_assistants/{assistant_id}/pause Pause an AI assistant #
POST /ai_assistants/{assistant_id}/unpause Unpause an AI assistant #
POST /ai_assistants/{assistant_id}/start Start an AI assistant #
POST /ai_assistants/{assistant_id}/stop Stop an AI assistant and cancel any running agent #
POST /ai_assistants/{assistant_id}/wake Manually trigger a wake cycle #
GET /ai_assistants/{assistant_id}/events List assistant wake/sleep events #
GET /ai_assistants/{assistant_id}/messages List direct messages with an assistant #
POST /ai_assistants/{assistant_id}/messages Send a message to an AI assistant #
PUT /ai_assistants/{assistant_id}/permissions/{username} Share an AI assistant with a user #
DELETE /ai_assistants/{assistant_id}/permissions/{username} Unshare an AI assistant from a user #
PUT /ai_assistants/{assistant_id}/tool Update custom tool definition #
DELETE /ai_assistants/{assistant_id}/tool Reset tool to default definition #
GET /ai_assistants/{assistant_id}/forums List connected forums #
POST /ai_assistants/{assistant_id}/forums Connect assistant to a forum #
DELETE /ai_assistants/{assistant_id}/forums/{forum_id} Disconnect assistant from a forum #
GET /ai_assistants/{assistant_id}/collections List collections connected to an assistant #
POST /ai_assistants/{assistant_id}/collections Connect assistant to a collection #
DELETE /ai_assistants/{assistant_id}/collections/{collection_id} Disconnect assistant from a collection #
GET /ai_assistants/{assistant_id}/schedules List connected scheduled tasks #
POST /ai_assistants/{assistant_id}/schedules Connect a scheduled task as wake trigger #
DELETE /ai_assistants/{assistant_id}/schedules/{scheduled_task_id} Disconnect a scheduled task #
GET /ai_assistants/{assistant_id}/files List files stored by an AI assistant #
GET /ai_assistants/{assistant_id}/files/{file_id}/content Download an assistant file #
GET /ai_assistants/{assistant_id}/search_forum_posts Search forum posts by keyword #
GET /ai_assistants/{assistant_id}/history/chat Get the assistant's full chat history as formatted text #
GET /ai_assistants/{assistant_id}/history/events Get the assistant's full event history as formatted text #
GET /ai_assistants/{assistant_id}/permissions List sharing permissions for an AI assistant #
POST /event_types Create a custom event type #
GET /event_types List custom event types #
GET /event_types/{event_type_id} Get a custom event type by ID #
DELETE /event_types/{event_type_id} Delete a custom event type #
POST /ai_assistants/{assistant_id}/event_subscriptions Subscribe an assistant to a custom event type #
GET /ai_assistants/{assistant_id}/event_subscriptions List an assistant's event subscriptions #
DELETE /ai_assistants/{assistant_id}/event_subscriptions/{event_type_id} Unsubscribe an assistant from a custom event type #
POST /ai_assistants/{assistant_id}/emit_event Emit a custom event #
POST /ai_assistants/{assistant_id}/send_to_assistant Send a message to another assistant #

Documentation

📖
Documentation
https://docs.h2o.ai/enterprise-h2ogpte/
📖
APIReference
https://h2ogpte.genai.h2o.ai/swagger-ui/
📖
GettingStarted
https://docs.h2o.ai/enterprise-h2ogpte/get-started
📖
Authentication
https://docs.h2o.ai/enterprise-h2ogpte/guide/apis
📖
Documentation
https://docs.h2o.ai/mlops/
📖
APIReference
https://docs.h2o.ai/mlops/model-scoring/mlops-scoring-rest-api

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/h2o-ai/refs/heads/main/openapi/h2o-ai-ai-assistants-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/h2o-ai/refs/heads/main/json-schema/h2o-ai-ai-assistant-create-request-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/h2o-ai/refs/heads/main/json-schema/h2o-ai-ai-assistant-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/h2o-ai/refs/heads/main/json-schema/h2o-ai-ai-assistant-update-request-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/h2o-ai/refs/heads/main/json-schema/h2o-ai-ai-assistant-spec-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/h2o-ai/refs/heads/main/json-schema/h2o-ai-ai-assistant-schedule-link-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/h2o-ai/refs/heads/main/json-schema/h2o-ai-ai-assistant-collection-link-schema.json

Other Resources

🔗
ChangeLog
https://docs.h2o.ai/enterprise-h2ogpte/changelog

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/h2o-ai:h2o-ai-ai-assistants-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

h2o-ai-ai-assistants-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: h2oGPTe REST AI Assistants API
  description: '# Overview


    Users can easily interact with the h2oGPTe API through its REST API, allowing HTTP requests from any programming language.'
  version: v1.0.0
servers:
- url: https://h2ogpte.genai.h2o.ai/api/v1
security:
- bearerAuth: []
tags:


# --- truncated at 32 KB (54 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/h2o-ai/refs/heads/main/openapi/h2o-ai-ai-assistants-api-openapi.yml