Kitemesh Documentation

English

Francais

English

Francais

Appearance

Developer API ​

This section documents the Kitemesh API for integrations built from a client, a service, or another external application.

Typical use cases ​

Use this API to:

  • send chat requests from an external application
  • consume responses in standard or streaming mode
  • resume an execution after a tool approval step
  • manage secrets, tools, API resources, files, custom models, and group models when the token has the right capabilities

Covered endpoints ​

  • POST /v1/chat/completions
  • POST /v1/chat/resume
  • management endpoints under /v1/secrets, /v1/tools, /v1/api-resources, /v1/files, /v1/custom-models, and /v1/group-models

Before integrating ​

The integration usually needs:

  • an active API Token created in Kitemesh
  • a target identifier in the format group:<uuid> or custom:<uuid>
  • a client that can handle JSON and, when needed, SSE streaming
  1. Read Authentication.
  2. Continue with Conventions.
  3. Integrate POST /v1/chat/completions.
  4. Add support for POST /v1/chat/resume if tools can require approval.
  5. Use the Management API only for integrations that need configuration changes.