Imhotep Logo
ImhotepSystems
API reference

REST API for Imhotep infrastructure.

Complete endpoint reference for integrating with Imhotep agents, context store, tool routing, and webhooks. JSON over HTTPS. Bearer token authentication.

Base URLv2.1
https://api.imhotep.systems/v1
POST/v1/chat
Send a message to an agent and receive a response
POST/v1/agents
Create or update an agent configuration
GET/v1/context/:id
Retrieve context state for a specific conversation
Endpoints
POST/v1/chat

Send a message to an agent and receive a response

Auth: Bearer token
POST/v1/agents

Create or update an agent configuration

Auth: Bearer token
GET/v1/context/:id

Retrieve context state for a specific conversation

Auth: Bearer token
POST/v1/tools/execute

Execute a tool call through the routing layer

Auth: Bearer token
POST/v1/webhooks

Register a webhook endpoint for event notifications

Auth: Bearer token
Authentication

Bearer token authentication.

All API requests require a Bearer token in the Authorization header. Tokens are scoped to your tenant and can be rotated without downtime.

API keys

Generated per integration. Scoped to specific resources and actions.

Webhook secrets

Unique signing secret per webhook endpoint. Verified on every event.

Rate limits

Per-tenant rate limits with burst capacity. Headers returned on every response.

Get access

Ready to integrate?

Register for API access and receive your Bearer token. Available for approved partners and integrations.